Diagnose | Docs

Dieser Artikel fasst die Diagnoseelemente beider Kabeen-Agenten zusammen: den Benutzeragenten, der auf den Arbeitsplätzen bereitgestellt wird, und den Server-Agenten, der auf der Infrastruktur läuft.

Benutzeragent

Der Benutzeragent protokolliert seine Aktivität in lokalen Logdateien. Diese Dateien sind die wichtigste Diagnosequelle bei unerwartetem Verhalten.

Protokollierungsstufe anpassen

Der Benutzeragent läuft standardmäßig mit der Protokollierungsstufe INFO. Diese Einstellung kann über die Windows-Registrierung angepasst werden.

Pfad: HKEY_CURRENT_USER\Software\Policies\Kabeen\Configuration
Schlüsselname: LogLevel
Akzeptierte Werte: Error, Info, Debug

Starten Sie nach der Änderung der Registrierung den Kabeen-Agenten neu, damit die neue Stufe wirksam wird.

Speicherorte der Logdateien

Die Logdateien werden je nach Betriebssystem an unterschiedlichen Speicherorten abgelegt. Die Logs werden für jeden Benutzer einzeln gespeichert.

Plattform	Speicherort
Windows	`%AppData%\Kabeen\logs`
macOS	`~/Library/Logs/Kabeen/logs`

Server-Agent

Der Server-Agent ist der Infrastruktur-Serveragent von Kabeen für Windows, Linux und IBM i. Er erfasst Metriken und Inventarinformationen eigenständig über einen HTTPS-Kanal, der mit einem an den Tenant gebundenen API-Schlüssel authentifiziert wird. Der Server-Agent läuft als Dienst und empfängt keine Befehle von der Plattform.

Architektur und Komponenten

Der Agent besteht aus mehreren Modulen:

Eine zentrale Komponente für Erfassung und Koordination
Ein spezielles Modul für die Sammlung von Systemmetriken
Konfigurations- und Authentifizierungsdienste
Ein zentrales Protokollierungssystem

Konfiguration und Initialisierung

Die Konfiguration des Server-Agenten umfasst folgende Punkte:

Den API-Schlüssel zur Authentifizierung gegenüber der Plattform
Die Parameter zur Zuordnung zu einer Struktur und einem Team
Die Parameter der ausgehenden Verbindung (Proxy usw.)

Unter Windows werden bestimmte Einstellungen wie die Protokollierungsstufe über Registrierungsschlüssel definiert.

Protokollierung

Die Logs des Server-Agenten werden lokal auf dem Server gespeichert. Sie sind die erste Informationsquelle für die Diagnose.

Der Speicherort der Logs hängt von der Agent-Version ab. Version 3.0 (Kabeen Server Agent) schreibt an neue Speicherorte, zusätzlich zu denen des bisherigen Agenten (Kapsul).

Plattform	Logdatei / Befehl
Windows (3.0)	`C:\ProgramData\Kabeen\Server Agent\`
Windows (bisherig)	`C:\Program Files (x86)\Kapsul\logs\kapsul.log`
Linux (3.0)	`journalctl -u kabeen-server-agent.service`
Linux (bisherig)	`/var/log/kapsul.log`

Startfehler (Windows)

Wenn der Server-Agent unter Windows nicht startet, führen Sie die folgenden Prüfungen durch:

API-Schlüssel: Überprüfen Sie, ob der API-Schlüssel in der Datei config.toml oder in der Registrierung korrekt eingetragen ist.
Dienststatus: Kontrollieren Sie, ob der Dienst vorhanden und gestartet ist.

sc query kapsul
Get-Service KabeenServerAgent

Verwenden Sie sc query kapsul für den bisherigen Agenten oder Get-Service KabeenServerAgent für Version 3.0.

Ausgehende Konnektivität: Stellen Sie sicher, dass der Server die Kabeen-Dienste über ausgehendes HTTPS erreichen kann:
- api.kabeen.io:443 (Steuerung / REST)
- intake.kabeen.io:443 (Ingestion / gRPC)