hermes logs Befehl — Vollständige Referenz & Beispiele

Überblick

hermes logs zeigt, verfolgt und filtert die Protokolldateien von Hermes Agent — agent.log, errors.log, gateway.log, gui.log und desktop.log. Sie können wählen, welches Protokoll gelesen wird, die Zeilenzahl begrenzen, in Echtzeit verfolgen und nach Level, Sitzungs-ID, Zeit oder Komponente filtern.

Verwendung

hermes logs [-h] [-n LINES] [-f] [--level LEVEL] [--session ID] [--since TIME] [--component NAME] [log_name]

Protokollnamen

log_name ist optional und wählt aus, welches Protokoll angezeigt wird:

Name	Protokolldatei
`agent` (Standard)	`agent.log` — Agent-Aktivität
`errors`	`errors.log` — Fehlereinträge
`gateway`	`gateway.log` — Gateway-/Plattform-Aktivität
`gui`	`gui.log` — GUI-Aktivität
`desktop`	`desktop.log` — Electron-App-Start/Backend
`list`	Listet verfügbare Protokolldateien mit Größen auf

Optionen

Option	Beschreibung
`-n LINES, --lines LINES`	Anzahl der anzuzeigenden Zeilen (Standard: 50)
`-f, --follow`	Protokoll in Echtzeit verfolgen (wie `tail -f`)
`--level LEVEL`	Mindest-Loglevel (DEBUG, INFO, WARNING, ERROR)
`--session ID`	Zeilen mit dieser Sitzungs-ID-Teilzeichenkette filtern
`--since TIME`	Zeilen seit TIME anzeigen (z. B. 1h, 30m, 2d)
`--component NAME`	Nach Komponente filtern: gateway, agent, tools, cli, cron, gui

Beispiele

# Die letzten 50 Zeilen von agent.log anzeigen
hermes logs

# agent.log in Echtzeit verfolgen
hermes logs -f

# Die letzten 50 Zeilen von errors.log anzeigen
hermes logs errors

# Die letzten 100 Zeilen von gateway.log anzeigen
hermes logs gateway -n 100

# gui.log in Echtzeit verfolgen
hermes logs gui -f

# desktop.log verfolgen (Electron-App-Start/Backend)
hermes logs desktop -f

# Nur WARNING und höher anzeigen
hermes logs --level WARNING

# Nach Sitzungs-ID filtern
hermes logs --session abc123

# Nur tool-bezogene Zeilen anzeigen
hermes logs --component tools

# Zeilen aus der letzten Stunde
hermes logs --since 1h

# Verfolgen, beginnend vor 30 Min
hermes logs --since 30m -f

# Verfügbare Protokolldateien mit Größen auflisten
hermes logs list

Tipps

Kombinieren Sie Filter: z. B. hermes logs gateway --level ERROR --since 2h, um aktuelle Gateway-Fehler zu sehen.
Verwenden Sie hermes logs list, um zu sehen, welche Protokolldateien existieren und wie groß sie sind.
--follow ist ideal für Live-Debugging — führen Sie es in einem separaten Terminalfenster aus, während Sie das Problem reproduzieren.
--session eignet sich zum Nachverfolgen einer einzelnen Unterhaltung über Protokolle hinweg.
Die Protokolldateien liegen unter ~/.hermes/logs/, Sie können sie also auch direkt ansehen.