Protokollsammlung
Übersicht
Das Erfassen von Protokollen und Reproduzieren von Problemen verlangsamen die Diagnose und beeinträchtigen die Benutzerfreundlichkeit. Die Ablaufverfolgung erleichtert solche Aufgaben. Die Ablaufverfolgung ist für den Linux VDA standardmäßig aktiviert.
Konfiguration
Der ctxlogd-Daemon und das setlog-Hilfsprogramm sind jetzt 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
Die aktive Ablaufverfolgung wird mit dem setlog-Hilfsprogramm konfiguriert, das hier zu finden ist: /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 |
| Ausführlich | 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 vonctxlogdkann sich negativ auf die Serverleistung und die Benutzererfahrung auswirken.
Protokollsammlung
Sie können den bash /opt/Citrix/VDA/bin/xdlcollect.sh-Befehl 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 Bash-Skript 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.