Logs für einen Support-Fall sammeln
So sammelst du octoja-Geräteprotokolle, Agent-Log-Dateien und Browser-Logs und hängst sie über das In-App-Ticket-Portal an einen Support-Fall an.
Wenn du den octoja-Support kontaktierst, machen die richtigen Logs den Unterschied zwischen stundenlangem Hin und Her und einer schnellen Lösung. octoja führt zwei verschiedene Log-Oberflächen: ein In-App-Aktivitätsprotokoll für jedes Gerät und die eigenen Log-Dateien des Agents auf dem Gerät selbst. Dieser Artikel beschreibt beide — plus die universellen Browser-Logs, die du erfassen kannst, wenn du ein Problem mit octoja im Browser meldest.
Bei einem Online-Gerät kann octoja die Agent-Log-Dateien mit einem Klick für dich verpacken — für alles andere sammelst du die Daten, die zum gemeldeten Symptom passen, und hängst sie an deinen Fall an.
Welche Logs zu welchem Symptom
Verschiedene Symptome brauchen verschiedene Logs. Diese Tabelle ist der Ausgangspunkt.
Sende nur die Logs, die zum Symptom passen. Je kleiner die Auswahl, desto schneller kann der Support sie lesen.
Das Geräteprotokoll auf der Geräteseite erfassen
Jedes Gerät mit octoja-Agent hat einen Tab Protokoll auf seiner Detailseite. Der Tab zeigt unter der Überschrift Geräteprotokoll aktuelle Aktivitäten, die der Server dem Gerät zuordnet — abgeschlossene Agent-Aufgaben, von einem Benutzer ausgelöste Fernsteuerungs-Aktionen und Direktsitzungen wie Terminal-Verbindungen. Standardmäßig zeigt er die letzten 30 Tage, und du kannst ihn mit dem Zeitraum-Auswähler (Letzte 24 Stunden, Letzte 7 Tage, Letzte 30 Tage oder Letzte 90 Tage), den Filtern für Quelle und Schweregrad sowie einem Suchfeld für den Inhalt eingrenzen. Netzwerkgeräte, die ohne Agent überwacht werden — Switches, Firewalls, NAS und ESXi-Hosts —, führen unter Aktivitäten die Tabs Erfasste Zeiten und Inventarverlauf.
Öffne den Tab Protokoll auf der Detailseite eines Geräts:
- Öffne Geräte in der Seitenleiste.
- Klicke auf die Zeile des betroffenen Geräts.
- Öffne auf der Geräte-Detailseite den Tab Aktivitäten und dort den Unter-Tab Protokoll.
Die Tabelle hat fünf Spalten:
Um diese Einträge an den Support zu senden, mach einen Screenshot des Protokoll-Tabs für den betreffenden Zeitraum oder kopiere die relevanten Zeilen in deine Nachricht. Es gibt keinen eingebauten Export-Button.
Einträge der Quelle Patchverwaltung werden vom Server geschrieben, wenn ein Agent die Ergebnisse eines Patch-Zyklus meldet, und Deployment-Einträge werden vom Agent geschrieben, wenn er ein Software-Deployment abschließt. Beide Quelltypen erscheinen in der Tabelle, sobald die entsprechende Aktivität auf dem Gerät stattgefunden hat.
Wenn du Protokolleinträge lieber programmatisch abfragen möchtest — etwa für ein größeres Zeitfenster oder gefiltert nach Quelle — siehe die Referenz Asset-Logs-API.
Agent-Log-Dateien vom Gerät einsammeln
Der octoja-Agent schreibt detaillierte Log-Dateien auf dem Gerät selbst. Sie umfassen alles, was der Agent lokal tut: Start, Kommunikation mit dem octoja-Service, Ausführen von Monitoring-Checks, Remote-Aktionen und Updates. Sie sind die richtige Quelle, wenn Telemetrie veraltet ist, wenn ein Check auf eine Weise fehlschlägt, die das Geräteprotokoll nicht erklären kann, oder wenn ein Gerät offline gegangen ist.
Online-Gerät: Agentenlogs herunterladen oder an den Support senden
Wenn das Gerät online ist, öffne auf der Geräte-Detailseite das Menü … oben rechts und wähle Agentenlogs. Im Dialog hast du zwei Möglichkeiten:
- Jetzt herunterladen lädt die Logs mit Herunterladen als ZIP-Archiv auf deinen Computer. Hänge die Datei anschließend an deinen Support-Fall an.
- Logs an octoja Support senden lädt sie direkt zusammen mit deinem Namen, deiner E-Mail-Adresse und dem Gerätenamen hoch. Ergänze bei Bedarf eine Notiz (optional) und klicke auf An Support senden. Warte auf Logs an octoja Support gesendet., kopiere die angezeigte Support-Referenz über die Schaltfläche daneben und gib sie im Support-Chat an. Erst damit kann der Support die Logs deinem Anliegen zuordnen; das Hochladen ersetzt deine Problembeschreibung nicht.
Das Archiv enthält den kompletten logs-Ordner mit den Unterordnern für Agent, Launcher, Worker, Check-Diagnose und die Anwendung in der Benutzersitzung. Beim direkten Senden an den Support darf es höchstens 50 MB groß sein; für den Download gilt diese Grenze nicht. Beide Aktionen stehen nur für Online-Geräte mit Agent zur Verfügung und erfordern die Berechtigung Dateibrowser für das Gerät. Bei Offline-Geräten können die Dateien manuell gesammelt werden, wie im nächsten Abschnitt beschrieben.
Offline-Gerät: Dateien manuell einsammeln
Agents schreiben in einen einzigen Ordner namens logs im octoja-Installationsverzeichnis — so überstehen die Dateien Agent-Updates. Darin liegt ein Unterordner pro Komponente: launcher (verwaltet Updates und überwacht den Agent), agent (der Agent selbst), worker (die kurzlebigen Hilfsprozesse, die Aufgaben wie Inventarisierung, Software-Deployment und Patch-Installation ausführen), checks (Fehlerausgaben von Monitoring-Checks, eine Datei pro Check-Zuweisung) und ui (die octoja-Anwendung in der Sitzung des angemeldeten Benutzers, eine Datei pro Sitzung). Die Ordner launcher und agent sind die beiden, die du normalerweise brauchst:
In den Ordnern launcher und agent heißen die Dateien Log.YYYY-MM-DD_NNN.log (NNN zählt von 000 aufwärts, sobald eine Datei voll wird). Eine neue Datei rollt täglich, und jede Datei, die über 10 MB wächst, rollt zur nächsten Sequenznummer. octoja löscht alte Log-Dateien nicht — du siehst möglicherweise eine lange Liste. Wähle die Datei oder Dateien, die den fraglichen Zeitraum abdecken, plus eine davor und eine danach für Kontext.
Für ein Problem, das gerade aufgetreten ist, ist die heutige Log.<heute>_NNN.log aus dem agent-Ordner meist die nützlichste Einzeldatei. Wenn das Gerät offline ging oder der Launcher selbst sich falsch verhält, hänge auch das Launcher-Log an.
Das Lesen dieser Ordner erfordert Administratorrechte unter Windows oder sudo unter Linux und macOS.
Linux: stdout und stderr liegen im System-Journal
Unter Linux fängt der systemd-Service stdout und stderr des Agents im journald-Journal auf. Wenn die Datei-Logs nicht zeigen, was du brauchst, führe Folgendes auf dem Gerät aus und hänge die Ausgabe an:
sudo journalctl -u octoja-agent --since "2 hours ago" > octoja-agent.journal.log
sudo journalctl -u octoja-launcher --since "2 hours ago" > octoja-launcher.journal.log
Pass --since an den Zeitraum an, in dem das Problem auftrat.
macOS: launchd schreibt stdout und stderr in zusätzliche Dateien
Unter macOS schreibt launchd stdout und stderr des Agents in dedizierte Dateien. Sie sind meist leer, aber wenn ein Startproblem das normale Logging verhindert hat, hänge auch sie an:
/opt/octoja/logs/launcher.stdout.log/opt/octoja/logs/launcher.stderr.log/opt/octoja/logs/agent.stdout.log/opt/octoja/logs/agent.stderr.log
Browser-Logs für Browser-seitige Probleme erfassen
Wenn das Problem mit der octoja-Web-App liegt — eine Seite lädt nicht, eine Schaltfläche reagiert nicht, ein Fehlerbanner erscheint ohne offensichtlichen Grund — dann fängt die DevTools des Browsers das ein, was wir brauchen: das Konsolen-Log (die Meldungen, die dein Browser ausgegeben hat) und eine HAR-Datei (eine Aufzeichnung der Netzwerk-Anfragen). Reproduziere das Problem bei geöffneten DevTools und exportiere dann beides — siehe die Dokumentation deines Browsers zum Exportieren einer HAR-Datei und zum Speichern der Konsolen-Ausgabe. Hänge beide Dateien an deinen Support-Fall an; sie enthalten genau das, was dein Browser gesehen hat, einschließlich aller Fehlerantworten von octoja.
Die HAR-Datei kann Cookies und Request-Bodies enthalten. Prüfe sie vor dem Versenden, falls deine Umgebung verlangt, sensible Header zu schwärzen.
Alles an den Support senden
octoja bietet vier Eingangskanäle in der Kopfleiste am oberen Seitenrand — eine Schaltfläche Feature Request und daneben ein Menü … (Feedback & Hilfe), das die anderen drei enthält:
Für einen Support-Fall öffnest du das Menü … und wählst Tickets. Beschreibe, was du beobachtet hast und wann es passiert ist (deine lokale Browser-Zeit reicht), und hänge die oben gesammelten Log-Dateien an.
Wenn dein Konto die Featurebase-Buttons in der Kopfleiste nicht zeigt (einige restriktive Umgebungen blenden sie aus), erreichst du uns über community.octoja.de.
Troubleshooting
Der Tab Protokoll zeigt „Keine Protokolle“. Das Gerät hat in den letzten 30 Tagen keine vom Server zuordenbare Aktivität erzeugt. Das ist normal für ein frisch registriertes Gerät, das noch keine Remote-Aktion, Terminal-Sitzung oder abgeschlossene Aufgabe hatte. Die Agent-Log-Dateien auf dem Gerät selbst enthalten trotzdem Einträge — sammle stattdessen diese.
Der Tab Protokoll lädt nicht. Wenn die Telemetrie auf der Geräte-Detailseite funktioniert, der Tab Protokoll aber Fehler wirft, ist das wahrscheinlich ein serverseitiges Problem, das gemeldet werden sollte — erfasse die Browser-Konsole wie oben beschrieben und füge sie bei.
Ich kann den Agent-Log-Ordner nicht öffnen. Öffne unter Windows den Datei-Explorer als Administrator oder führe in einer erhöhten PowerShell cd "C:\Program Files\octoja GmbH\logs\agent" aus. Unter Linux und macOS stelle dem Lesebefehl sudo voran.
Die Log-Datei ist zu groß zum Anhängen. Komprimiere das Tages-Log vor dem Anhängen in eine .zip. Falls eine einzelne Datei mehrere Gigabyte hat, kopiere nur die Zeilen rund um den Zeitpunkt des Problems heraus — die meisten Editoren (Notepad++, VS Code, less, tail -n) bewältigen die Datei auch dann, wenn der Datei-Explorer es nicht tut.
Bevor du einen Fall öffnest, prüfe Produktstatus & bekannte Einschränkungen auf bereits bekannte Probleme, die zu deinem Symptom passen könnten. Der Known-Issues-Artikel wird aktualisiert, sobald ein Problem identifiziert wurde — möglicherweise ist dein Symptom dort schon erfasst.
Verwandte Artikel
Die folgenden Artikel decken Themen ab, die an einen Support-Fall angrenzen — aktueller Produktstatus, alternative Kanäle und das API-Pendant zur In-App-Asset-Logs-Oberfläche.