This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
日志收集
日志记录机制概述
下表概述了 Linux VDA 的日志记录机制。
| 日志记录模块 | 日志文件名格式 | 日志文件名示例 | 日志记录作用域 | 最大单个文件大小 | 轮换阈值（默认值） | 配置 |
|---|---|---|---|---|---|---|
| HDX | hdx.log[.n] | hdx.log、hdx.log.1 | 图形、登录、音频、键盘、鼠标 | 200 MiB | 1 个当前文件，2 个旧文件 | 可通过 setlog 实用程序进行配置 |
| Jproxy | jproxy.log[.n.log] | jproxy.log、jproxy.log.1.log | VDA 注册、用户身份验证 | 20 MiB | 1 个当前文件，10 个旧文件 | 可通过 setlog 实用程序或 /etc/xdl/log4j2.xml 进行配置 |
| VDA | vda.YYYY-MM-DD.hh.mm.ss.log | vda.2024-05-06.20.18.40.log | VDA 注册 | 10 MiB | 1 个当前文件，100 个旧文件 | 可通过 setlog 实用程序或 /etc/xdl/brokeragent.conf 进行配置 |
注意：
- 第一个日志文件的名称中没有数字，后续文件以“.n”编号，其中“n”表示文件数量。例如，“hdx.log”是第一个 HDX 日志文件，“hdx.log.1”是第二个 HDX 日志文件。
- 单个日志文件的最大大小以兆字节 (MiB) 为单位进行测量。
- 正在生成但尚未达到单个文件的最大大小的日志文件称为“当前”日志文件。 当“当前”日志文件达到单个文件的最大大小时，它会滚动并变成“旧”日志文件。
- 轮换阈值可配置为限制可以保留的“旧”日志文件的数量。达到限制时，最旧的日志文件将被删除。
日志记录配置
本部分内容提供有关日志记录配置的其他信息，对上述表格中概述的详细信息进行了补充。
Linux VDA 的日志记录默认处于启用状态
ctxlogd 守护程序和 setlog 实用程序包括在 Linux VDA 版本软件包中。默认情况下，ctxlogd 守护程序在您安装并配置 Linux VDA 后启动。跟踪的所有其他服务都基于 ctxlogd 守护程序。如果不希望跟踪 Linux VDA，可以停止 ctxlogd 守护程序。
通过 /etc/xdl/brokeragent.conf 配置 VDA 日志记录
注意：
如果您只想为 VDA 日志记录配置日志级别，而不深入研究其他日志记录参数（例如单个日志文件的最大大小），则可以使用本文后面介绍的 setlog 实用程序。否则，请使用 /etc/xdl/brokeragent.conf。
VDA 上的 /etc/xdl/brokeragent.conf 文件可用于配置 VDA 日志记录。例如：
注意：
默认情况下，可以保留的“旧”VDA 日志文件的最大数量为 100。请根据需要对其进行调整。
通过 /etc/xdl/log4j2.xml 配置 Jproxy 日志记录
注意：
如果您只想为 Jproxy 日志记录配置日志级别，而不深入研究其他日志记录参数（例如单个日志文件的最大大小），则可以使用本文后面介绍的 setlog 实用程序。否则，请使用 /etc/xdl/log4j2.xml。
下面是通过 /etc/xdl/log4j2.xml 配置 Jproxy 日志记录的示例，其中 SizeBasedTriggeringPolicy 参数指定单个 Jproxy 日志文件的最大大小，而 DefaultRollerStrategy 参数设置可以保留的 Jproxy 日志文件总数。
通过 setlog 实用程序配置 HDX 日志记录
setlog 实用程序位于 /opt/Citrix/VDA/bin/ 路径下。只有 root 用户有权运行该程序。可以使用 GUI 或运行命令来查看和更改配置选项，包括值（日志文件路径、单个文件大小限制和轮换阈值）和日志级别。请运行以下命令以获取使用 setlog 实用程序的帮助信息：
setlog help
<!--NeedCopy-->
值
默认情况下，HDX 日志保存在 /var/log/xdl/hdx.log 下，单个 HDX 日志文件的大小限制为 200 MiB，在 /var/log/xdl/hdx.log 下最多可以保存两个“旧”HDX 日志文件。
要查看当前的所有 setlog 值，请运行以下命令：
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-->
要查看或设置单个 setlog 值，请运行以下命令：
setlog value <name> [<value>]
<!--NeedCopy-->
例如：
setlog value log_size 100
<!--NeedCopy-->
级别
默认情况下，日志级别将设置为 info（不区分大小写）。
当您遇到需要进行故障排除的问题时，我们建议您在大多数情况下将日志级别设置为 verbose。然后，请重现该问题并收集日志。
要设置日志级别（包括“已禁用”、“已继承”、“跟踪”、“详细”、“信息”、“警告”、“错误”和“致命错误”），请运行以下命令：
setlog level <class> [<level>]
<!--NeedCopy-->
| 日志级别 | 命令参数（不区分大小写） |
|---|---|
| 已禁用 | none |
| 已继承 | inherit |
| 跟踪 | trace |
| 详细 | verbose |
| 信息 | info |
| 警告 | warning |
| 错误 | error |
| 致命错误 | fatal |
<class> 变量指定 Linux VDA 的一个组件。要涵盖所有组件，请将其设置为“全部”。例如：
setlog level all error
<!--NeedCopy-->
要查看支持的所有类或组件，请运行以下命令：
setlog levels
<!--NeedCopy-->
还原默认值
请将所有级别和值还原到默认设置：
setlog default
<!--NeedCopy-->
重要：
ctxlogd 服务是使用 /var/xdl/.ctxlog 文件配置的，只有 root 用户能够创建该文件。其他用户对该文件没有写入权限。我们建议 root 用户不要向其他用户授予写入权限。否则会导致对 ctxlogd 进行任意配置或恶意配置，这样会影响服务器性能，进而影响用户体验。
日志收集
可以运行 bash /opt/Citrix/VDA/bin/xdlcollect.sh 命令来收集日志。用于收集日志的 xdlcollect Bash 脚本将集成到 Linux VDA 软件中并位于 /opt/Citrix/VDA/bin 下。
日志收集完成后，将在 VDA 上的 /tmp/xdlcollect 下生成一个 ZIP 文件。
故障排除
/var/xdl/.ctxlog 文件丢失（例如，意外删除）时，ctxlogd 守护程序失败，您将无法重新启动 ctxlogd 服务。
/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-->
要解决此问题，请以 root 用户身份运行 setlog 以重新创建 /var/xdl/.ctxlog 文件。然后重新启动其他服务所基于的 ctxlogd 服务。
共享
共享
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.