Linux Virtual Delivery Agent

Protokollsammlung

Übersicht

Die Protokollsammlung ist für den Linux VDA standardmäßig aktiviert.

Konfiguration

Der Daemon ctxlogd und das Dienstprogramm setlog sind im Linux VDA-Releasepaket enthalten. Standardmäßig startet der Daemon ctxlogd nach der Installation und Konfiguration des Linux VDA.

Der Daemon ctxlogd

Alle anderen Dienste, die nachverfolgt werden, hängen vom Daemon ctxlogd ab. Sie können den Daemon ctxlogd beenden, wenn Sie den Linux VDA nicht nachverfolgen möchten.

Das Dienstprogramm setlog

Die Protokollsammlung wird mit dem Dienstprogramm setlog konfiguriert, das sich unter dem Pfad /opt/Citrix/VDA/bin/ befindet. Nur der Root-Benutzer hat die Berechtigung, es auszuführen. Sie können die GUI verwenden oder Befehle ausführen, um die Konfigurationen anzuzeigen und zu ändern. Führen Sie den folgenden Befehl aus, um Hilfe zum Dienstprogramm setlog zu erhalten:

setlog help
<!--NeedCopy-->

Werte

Standardmäßig ist der Protokollausgabepfad auf /var/log/xdl/hdx.log festgelegt, die maximale Protokollgröße auf 200 MB, und Sie können bis zu zwei alte Protokolldateien unter dem Protokollausgabepfad speichern.

Aktuelle setlog-Werte anzeigen:

setlog values

log_path (Log Output Path) = /var/log/xdl/hdx.log

log_size (Max Log Size (MiB)) = 200

log_count (Max Old Log Files) = 2
<!--NeedCopy-->

Einen einzelnen setlog-Wert anzeigen oder festlegen:

setlog value <name> [<value>]
<!--NeedCopy-->

Beispiel:

setlog value log_size 100
<!--NeedCopy-->

Ebenen

Standardmäßig sind die Protokollebenen auf warning (Groß-/Kleinschreibung wird nicht beachtet) festgelegt.

Um die für verschiedene Komponenten festgelegten Protokollebenen anzuzeigen, führen Sie den folgenden Befehl aus:

setlog levels
<!--NeedCopy-->

Um Protokollebenen festzulegen (einschließlich Disabled, Inherited, Verbose, Information, Warnings, Errors und Fatal Errors), führen Sie den folgenden Befehl aus:

setlog level <class> [<level>]
<!--NeedCopy-->
Protokollebene Befehlsparameter (Groß-/Kleinschreibung wird nicht beachtet)
Deaktiviert none
Geerbt inherit
Ausführlich verbose
Information info
Warnungen warning
Fehler error
Schwerwiegende Fehler fatal

Die Variable <class> gibt eine Komponente des Linux VDA an. Um alle Komponenten abzudecken, setzen Sie sie auf all. Beispiel:

setlog level all error
<!--NeedCopy-->

Flags

Standardmäßig sind die Flags wie folgt festgelegt:

setlog flags

DATE = true

TIME = true

NAME = true

PID = true

TID = false

SID = true

UID = false

GID = false

CLASS = false

LEVEL = false

FUNC = true

FILE = false
<!--NeedCopy-->

Aktuelle Flags anzeigen:

setlog flags
<!--NeedCopy-->

Ein einzelnes Protokoll-Flag anzeigen oder festlegen:

setlog flag <flag> [<state>]
<!--NeedCopy-->

Standardeinstellungen wiederherstellen

Alle Ebenen, Flags und Werte auf die Standardeinstellungen zurücksetzen:

setlog default
<!--NeedCopy-->

Wichtig:

Der Dienst ctxlogd wird über die Datei /var/xdl/.ctxlog konfiguriert, die nur Root-Benutzer erstellen können. Andere Benutzer haben keine Schreibberechtigung für diese Datei. Wir empfehlen, dass Root-Benutzer anderen Benutzern keine Schreibberechtigung erteilen. Die Nichteinhaltung kann zu einer willkürlichen oder bösartigen Konfiguration von ctxlogd führen, was die Serverleistung und damit die Benutzererfahrung beeinträchtigen kann.

Fehlerbehebung

Der Daemon ctxlogd schlägt fehl, und Sie können den Dienst ctxlogd nicht neu starten, wenn die Datei /var/xdl/.ctxlog fehlt (z. B. versehentlich gelöscht wurde).

/var/log/messages:

Apr 1 02:28:21 RH72 citrix-ctxlogd[17881]: Failed to open logging configuration file.

Apr 1 02:28:21 RH72 systemd: ctxlogd.service: main process exited, code=exited, status=1/FAILURE

Apr 1 02:28:21 RH72 systemd: Unit ctxlogd.service entered failed state.

Apr 1 02:28:21 RH72 systemd: ctxlogd.service failed.
<!--NeedCopy-->

Um dieses Problem zu beheben, führen Sie setlog als Root-Benutzer aus, um die Datei /var/xdl/.ctxlog neu zu erstellen. Starten Sie anschließend den Dienst ctxlogd neu, von dem andere Dienste abhängen.

Protokollsammlung