Protokolle des Server-Agenten | Docs

Der Kabeen Server-Agent schreibt seine Aktivität in lokale Protokolldateien — die erste Informationsquelle bei einer Fehlersuche. Seit Version 3.2.2 werden diese Dateien täglich rotiert, mit konfigurierbarer Aufbewahrungsdauer: Ein unbegrenzt wachsendes Protokoll kann den Datenträger des Servers nicht mehr füllen.

Speicherort der Protokolle

Der Agent schreibt eine Datei pro Tag, benannt nach dem Datum im Format JJJJ-MM-TT.log:

Plattform	Speicherort
Windows	`C:\ProgramData\Kabeen\Server Agent\logs\<JJJJ-MM-TT>.log`
Linux	`/var/log/kabeen-server-agent/<JJJJ-MM-TT>.log`

Das Verzeichnis wird beim ersten Start des Agenten angelegt, falls es nicht vorhanden ist.

Unter Linux werden dieselben Zeilen zusätzlich an journald übergeben, das seine eigene, von der des Agenten unabhängige Aufbewahrungsrichtlinie anwendet:

sudo journalctl -u kabeen-server-agent.service -f

So lesen Sie die Datei des aktuellen Tages:

sudo tail -f /var/log/kabeen-server-agent/$(date +%F).log

Get-Content "C:\ProgramData\Kabeen\Server Agent\logs\$(Get-Date -Format 'yyyy-MM-dd').log" -Tail 30

Vor Version 3.2.2 schrieb der Agent in eine einzige Datei kabeen-server-agent.log, die im Anhängemodus geöffnet und nie bereinigt wurde. Nach der Aktualisierung wird diese Datei nicht mehr beschrieben: Sie können sie bei Bedarf manuell löschen, sobald ihr Inhalt archiviert ist.

Tägliche Rotation

Der Agent wechselt beim ersten protokollierten Ereignis nach Mitternacht auf eine neue Datei.
Bei demselben Wechsel löscht er die .log-Dateien des Verzeichnisses, die älter als die Aufbewahrungsdauer sind.
Es ist weder eine geplante Aufgabe noch eine logrotate-Konfiguration einzurichten: Der Agent übernimmt die Rotation selbst.

Aufbewahrungsdauer

Standardmäßig bewahrt der Agent 14 Tage an Protokollen auf. Diese Dauer lässt sich serverweise mit dem Schlüssel log_retention_days in der Konfigurationsdatei anpassen (/etc/kabeen-server-agent/config.toml unter Linux, C:\ProgramData\Kabeen\Server Agent\config.toml unter Windows):

api_key = "IHR_KABEEN_API_SCHLÜSSEL"
# Anzahl der aufzubewahrenden täglichen Protokolldateien. Standard: 14.
log_retention_days = 30

Wert	Wirkung
Positive ganze Zahl	Die Protokolle werden diese Anzahl an Tagen aufbewahrt
Schlüssel fehlt, Wert `0` oder nicht lesbarer Wert	Rückfall auf den Standardwert von 14 Tagen

Ausnahme vom Neuladen im laufenden Betrieb. Anders als alle übrigen Schlüssel von config.toml, die automatisch alle 10 Sekunden neu gelesen werden, wird log_retention_days nur einmal beim Start gelesen, vor der Initialisierung des Loggers. Eine Änderung wird erst nach einem Neustart des Dienstes wirksam.

sudo systemctl restart kabeen-server-agent.service

Restart-Service KabeenServerAgent

Kodierung. Wie beim API-Schlüssel muss config.toml als UTF-8 ohne BOM gespeichert werden — eine UTF-16-Datei oder eine Datei mit BOM verhindert den Start des Agenten. Siehe Diagnose › Kodierung der Konfigurationsdatei.

Zugriffsrechte des Protokollverzeichnisses

Protokollzeilen können Hostnamen, Dienstnamen und auf dem Server beobachtete Netzwerkflüsse enthalten. Unter Linux ist das Protokollverzeichnis daher auf seinen Eigentümer und dessen Gruppe beschränkt (root:root, Modus 0750), sodass unprivilegierte Benutzer es nicht durchsuchen können. Der Agent wendet diesen Modus bei jedem Start erneut an.

Lockern Sie diese Rechte nicht (chmod 755 oder permissiver): Der Modus des Verzeichnisses ist es, der die durch die Rotation erzeugten Dateien schützt.

Weitere Diagnosethemen (Protokollierungsstufen, Startfehler, Kodierung der Konfigurationsdatei) finden Sie unter Diagnose.