Linux Virtual Delivery Agent 2107

Tracing On

Überblick

Das Sammeln von Protokollen und das Reproduzieren von Problemen verlangsamen die Diagnose und beeinträchtigen die Benutzererfahrung. Die Funktion „Tracing On“ erleichtert diese Bemühungen. Tracing ist für den Linux VDA standardmäßig aktiviert.

Konfiguration

Der ctxlogd-Daemon und das setlog-Dienstprogramm sind jetzt im Linux VDA-Release-Paket enthalten. Standardmäßig startet der ctxlogd-Daemon, nachdem Sie den Linux VDA installiert und konfiguriert haben.

ctxlogd-Daemon

Alle anderen Dienste, die verfolgt werden, hängen vom ctxlogd-Daemon ab. Sie können den ctxlogd-Daemon stoppen, wenn Sie den Linux VDA nicht verfolgen möchten.

setlog-Dienstprogramm

„Tracing On“ wird mit dem setlog-Dienstprogramm 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 setlog-Dienstprogramm zu erhalten:

setlog help
<!--NeedCopy-->

Werte

Standardmäßig ist der Protokollausgabepfad auf /var/log/xdl/hdx.log eingestellt, 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-->

Zum Beispiel:

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

Ebenen

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

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

setlog levels
<!--NeedCopy-->

Um Protokollebenen festzulegen (einschließlich Deaktiviert, Geerbt, Ausführlich, Information, Warnungen, Fehler und Schwerwiegende Fehler), führen Sie den folgenden Befehl aus:

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

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

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

Flags

Standardmäßig sind die Flags wie folgt eingestellt:

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 ctxlogd-Dienst 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 ctxlogd-Daemon schlägt fehl, und Sie können den ctxlogd-Dienst 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 ctxlogd-Dienst neu, von dem andere Dienste abhängen.

Tracing On