Karaf Log

Die Darstellung des Karaf Log kann mithilfe eines BPC-Monitors geschehen.

Allgemeines

Die Logs des Karaf werden in einen OpenSearch Index mit dem Alias 'bpc-logs' geschrieben. Ein BPC-Monitor wird zur Darstellung der Daten verwendet.

Konfiguration

Empfohlen wird, die Einstellungen für das Karaf Logging über Umgebungsvariablen in der zentralen Konfigurationsdatei bpc.env vorzunehmen:

bpc.env

Unix-Systeme (bpc.env.sh)
Windows-Systeme (bpc.env.cmd)

# Karaf Logging de-/aktivieren (Standard: true)
export DE_VIRTIMO_BPC_DECANTER_APPENDER_OPENSEARCH_ENABLED="true"

# Bereinigungsintervall in Minuten (Standard: 60)
export DE_VIRTIMO_BPC_DECANTER_APPENDER_OPENSEARCH_CLEANUPPERIODINMINUTES="60"

# Aufbewahrungsdauer (Standard: 7 days ago)
export DE_VIRTIMO_BPC_DECANTER_APPENDER_OPENSEARCH_DELETEENTRIESOLDERTHAN="7 days ago"

:: Karaf Logging de-/aktivieren (Standard: true)
SET DE_VIRTIMO_BPC_DECANTER_APPENDER_OPENSEARCH_ENABLED=true

:: Bereinigungsintervall in Minuten (Standard: 60)
SET DE_VIRTIMO_BPC_DECANTER_APPENDER_OPENSEARCH_CLEANUPPERIODINMINUTES=60

:: Aufbewahrungsdauer (Standard: 7 days ago)
SET DE_VIRTIMO_BPC_DECANTER_APPENDER_OPENSEARCH_DELETEENTRIESOLDERTHAN=7 days ago

Es wird dringend empfohlen, Konfigurationsanpassungen nicht direkt in den Karaf-Konfigurationsdateien unter <BPC-INSTALL-DIR>/karaf/etc/ vorzunehmen, sondern die zentrale bpc.env-Datei zu nutzen. Bei Updates der BPC- bzw. Karaf-Installation werden Dateien im etc-Verzeichnis möglicherweise überschrieben oder durch neue Standardversionen ersetzt. Über die bpc.env definierte Umgebungsvariablen bleiben bei Versionswechseln erhalten und erleichtern die automatisierte Bereitstellung und Wartung. Weitere Details zur Syntax und Funktionsweise finden Sie unter Werte von etc-Dateien überschreiben.

Alternativ finden Sie die Einstellungen in der Karaf-Konfigurationsdatei <BPC-INSTALL-DIR>/karaf/etc/de.virtimo.bpc.decanter.appender.opensearch.cfg.

De-/Aktivieren

Im Standard werden die Karaf Logs in den OpenSearch Index mit dem Alias 'bpc-logs' geschrieben. Um diese Funktion zu deaktivieren, kann die Umgebungsvariable DE_VIRTIMO_BPC_DECANTER_APPENDER_OPENSEARCH_ENABLED="false" gesetzt oder in der Konfigurationsdatei der Parameter enabled = false definiert werden.

Aufräumen

Die Karaf Logs werden in den OpenSearch Index mit dem Alias bpc-logs geschrieben. Damit dieser nicht ins Unendliche wächst, werden periodisch alte Daten gelöscht. Die Häufigkeit und Aufbewahrungsdauer können über die bpc.env (siehe oben) oder in der Konfigurationsdatei <BPC-INSTALL-DIR>/karaf/etc/de.virtimo.bpc.decanter.appender.opensearch.cfg angepasst werden (danach ist ein Core Bundle Neustart erforderlich).

Dies sind die Voreinstellungen in der Datei:

de.virtimo.bpc.decanter.appender.opensearch.cfg

# the index gets cleaned up every n-minutes
cleanupPeriodInMinutes=60

# delete all entries from the index that are older than
deleteEntriesOlderThan=7 days ago

Darstellung der Karaf Log

Im Administrationsbereich können die Karaf Logs eingesehen werden, siehe Karaf Log.

Weiterhin ist es möglich, das Karaf Log als Monitor-Modul in der Navigationsleiste verfügbar zu machen.

Keywords: