Logs für einen Support-Fall sammeln
So sammelst du octoja Asset-Logs, Agent-Log-Dateien und Browser-Logs von jedem Gerät und hängst sie über das In-App Support-Tickets-Portal an einen Support-Fall an.
Geschrieben von Erdinc Akay
Zuletzt aktualisiert Vor 26 Tagen
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 in octoja 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.
Öffne den Tab Protokoll auf einem beliebigen Gerät:
- Öffne Geräte in der Seitenleiste.
- Klicke auf die Zeile des betroffenen Geräts.
- Klicke auf der Geräte-Detailseite auf den 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: Log-Dateien über die Geräteseite herunterladen
Wenn das Gerät online ist, musst du das Gerät selbst gar nicht anfassen. Öffne auf der Geräte-Detailseite das Menü … oben rechts und wähle Protokolle herunterladen. octoja holt die Log-Dateien direkt vom Agent und lädt sie als einzelne .zip in deinen Browser herunter — sie enthält sowohl den Agent- als auch den Launcher-Log-Ordner, die unten beschrieben sind. Hänge diese Zip-Datei an deinen Support-Fall an.
Die Aktion wird nur angezeigt, solange das Gerät online ist, und erfordert die Berechtigung Dateibrowser für das Gerät. Bei Offline-Geräten — also genau dann, wenn das Launcher-Log am wichtigsten ist — sammelst du die Dateien manuell, wie im nächsten Abschnitt beschrieben.
Offline-Gerät: Dateien manuell einsammeln
Agents schreiben in einen Ordner namens logs direkt neben der Binärdatei. Auf jedem Gerät laufen zwei Binärdateien — der Launcher (verwaltet Updates und überwacht den Agent) und der Agent selbst — also hat jedes Gerät zwei Log-Ordner.
Dateien heißen 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.logsudo journalctl -u octoja-launcher --since "2 hours ago" > octoja-launcher.journal.logPass --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/data/logs/launcher.stdout.log/opt/octoja/data/logs/launcher.stderr.log/opt/octoja/data/logs/agent.stdout.log/opt/octoja/data/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 fünf Eingangskanäle in der Kopfleiste am oberen Seitenrand:
Für einen Support-Fall nutzt du das Rettungsring-Symbol, um ein Support-Ticket zu öffnen. 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 — siehe den Artikel Community-Forum dazu, wie das Forum organisiert ist.
Troubleshooting
Der Tab Protokoll zeigt „Keine Protokolleinträge für dieses Gerät vorhanden.“ 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\agent\current\logs" 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.