Linux Virtual Delivery Agent 2106

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-Releasepaket 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 beenden, 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 festgelegt, die maximale Protokollgröße ist auf 200 MB festgelegt, 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 ist die Protokollebene auf Warnungen festgelegt.

Die für verschiedene Komponenten festgelegten Protokollebenen anzeigen:

setlog levels
<!--NeedCopy-->

Sie können alle Protokollebenen (einschließlich Deaktivieren, Geerbt, Ausführlich, Informationen, Warnungen, Fehler und Schwerwiegende Fehler) mit dem folgenden Befehl festlegen:

setlog level <class> [<level>]
<!--NeedCopy-->

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

setlog level all error

Setting log class ALL to 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-->

Die aktuellen 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.

Problembehandlung

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