Protokollsammlung
Übersicht
Das Erfassen von Protokollen und Reproduzieren von Problemen verlangsamen die Diagnose und beeinträchtigen die Benutzerfreundlichkeit. 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 |
Inherited | inherit |
Verbose | verbose |
Information | info |
Warnings | warning |
Errors | error |
Fatal Errors | 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-->
Wiederherstellen der Standardeinstellungen
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 vonctxlogd
kann sich negativ auf die Serverleistung und die Benutzererfahrung auswirken.
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.