Linux Virtual Delivery Agent

Protokollsammlung

Übersicht

Das Sammeln von Protokollen ist für den Linux VDA standardmäßig aktiviert.

Konfiguration

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

ctxlogd-Daemon

Alle anderen Dienste, deren Ablauf verfolgt wird, hängen vom ctxlogd-Daemon ab. Sie können den ctxlogd-Daemon anhalten, wenn Sie den Ablauf des Linux VDA nicht verfolgen möchten.

setlog-Hilfsprogramm

Das Sammeln von Protokollen wird mit dem setlog-Hilfsprogramm konfiguriert. Es ist an folgendem Pfad: /opt/Citrix/VDA/bin/. Nur Root-Benutzer können es ausführen. Verwenden Sie zum Anzeigen und Ändern von Konfigurationen die grafische Benutzeroberfläche oder Befehle. Führen Sie den folgenden Befehl aus, um Hilfe zum setlog-Dienstprogramm aufzurufen:

setlog help
<!--NeedCopy-->

Werte

Standardmäßig ist Log Output Path auf /var/log/xdl/hdx.log und Max Log Size auf 200 MB festgelegt. Sie können zwei alte Protokolldateien unter Log Output Path speichern.

Anzeigen der aktuellen setlog-Werte:

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-->

Anzeigen oder Festlegen eines einzelnen setlog-Werts:

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

Beispiel:

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

Ebenen

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

Führen Sie den folgenden Befehl aus, um Protokollebenen für verschiedene Komponenten anzuzeigen:

setlog levels
<!--NeedCopy-->

Sie können die Protokollebenen (einschließlich Disabled, Inherited, Verbose, Information, Warnings, Errors und Fatal Errors) mit dem folgenden Befehl festlegen:

setlog level <class> [<level>]
<!--NeedCopy-->
Protokollebene Befehlsparameter (Groß-/Kleinschreibung unerheblich)
Deaktiviert none
Geerbt inherit
Verbose verbose
Informationen Info
Warnungen Warnung
Fehler Fehler
Schwerwiegende Fehler fatal

Mit der Variable <class> wird eine Komponente des Linux VDA angegeben. Um alle Komponenten einzubeziehen, legen Sie “all” fest: Beispiel:

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

Flags

Flags werden 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-->

Anzeigen der aktuellen Flags:

setlog flags
<!--NeedCopy-->

Anzeigen oder Festlegen eines einzelnen Protokoll-Flags:

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

Standardeinstellungen wiederherstellen

Wiederherstellen der Standardeinstellungen für alle Ebenen, Flags und Werte:

setlog default
<!--NeedCopy-->

Wichtig:

Der ctxlogd-Dienst wird mit der Datei /var/xdl/.ctxlog konfiguriert, die nur von Root-Benutzern erstellt werden kann. Andere Benutzer haben keine Schreibrechte für diese Datei. Wir empfehlen Root-Benutzern, anderen Benutzern keine Schreibrechte zu geben. Die versehentliche oder mutwillige Fehlkonfiguration von ctxlogd kann sich negativ auf die Serverleistung und die Benutzererfahrung auswirken.

Protokollsammlung

Sie den Befehl bash /opt/Citrix/VDA/bin/xdlcollect.shbash ausführen, um Protokolle zu sammeln. Das xdlcollect-Bashskript zum Sammeln der Protokolle ist in die Linux VDA-Software integriert und unter /opt/Citrix/VDA/bin zu finden.

Nach Abschluss der Protokollsammlung wird eine komprimierte Protokolldatei in dem Ordner mit dem Skript generiert. Das xdlcollect-Bashskript kann fragen, ob Sie die komprimierte Protokolldatei in Citrix Insight Services (CIS) hochladen möchten. Wenn Sie zustimmen, gibt xdlcollect nach Abschluss des Uploads eine upload_ID zurück. Die komprimierte Protokolldatei wird beim Upload nicht von Ihrem lokalen Computer entfernt. Andere Benutzer können mit der upload_ID auf die Protokolldatei in CIS zugreifen.

Problembehandlung

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

/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-->

Sie lösen das Problem, indem Sie setlog als Root-Benutzer ausführen, um die Datei /var/xdl/.ctxlog neu zu erstellen. Starten Sie dann den ctxlogd-Dienst neu, da andere Dienste von ihm abhängen.

Protokollsammlung