与 Citrix Telemetry Service 集成
通过与 Linux VDA 软件集成的 Citrix Telemetry Service (ctxtelemetry),您可以运行 Citrix Scout,然后使用 /opt/Citrix/VDA/bin/xdlcollect.sh 脚本来收集有关 Linux VDA 的日志。
注意:
从 Linux VDA 1912 及更早版本升级后,必须重新运行 /opt/Citrix/VDA/sbin/ctxsetup.sh 以配置 Citrix Telemetry Service (ctxtelemetry) 的变量。有关这些变量的详细信息,请参阅轻松安装。
启用和禁用 Citrix Telemetry Service
- 要启用该服务,请运行 sudo systemctl enable ctxtelemetry.socket 命令。
- 要禁用该服务,请运行 sudo systemctl disable ctxtelemetry.socket。
端口
默认情况下,Citrix Telemetry Service (ctxtelemetry) 使用 TCP/IP 端口 7503 侦听 Citrix Scout。它使用 Delivery Controller 上的 TCP/IP 端口 7502 与 Citrix Scout 进行通信。
在安装 Linux VDA 时,可以使用默认端口或者通过以下变量更改端口。
- CTX_XDL_TELEMETRY_SOCKET_PORT - 用于侦听 Citrix Scout 的套接字端口。默认端口为 7503。
- CTX_XDL_TELEMETRY_PORT - 用于与 Citrix Scout 通信的端口。默认端口为 7502。
要在安装 VDA 后更改端口,请执行以下操作:
-
要更改用于与 Scout 通信的端口,请运行以下命令。
/opt/Citrix/VDA/bin/ctxreg update -k "HKLM\Software\Citrix\VirtualDesktopAgent" -v "TelemetryServicePort" -d <port number> -t REG_DWORD <!--NeedCopy-->
-
要更改侦听 Scout 的套接字端口,请运行以下命令以打开并编辑 ctxtelemetry.socket 文件。
sudo vi /etc/systemd/system/ctxtelemetry.socket <!--NeedCopy-->
-
运行以下命令以重新启动套接字端口。
sudo systemctl daemon-reload sudo systemctl stop ctxtelemetry.socket sudo systemctl start ctxtelemetry.socket <!--NeedCopy-->
-
在防火墙配置中启用新端口。
例如,如果您使用的是 Ubuntu 发行版,请运行 sudo ufw allow 7503 命令以启用端口 7503。
调试模式
如果 Citrix Telemetry Service 无法按预期方式运行,则可以启用调试模式来确定原因。
-
要启用调试模式,请运行以下命令以打开 ctxtelemetry 文件,然后将 DebugMode 值更改为 1。
sudo vi /opt/Citrix/VDA/sbin/ctxtelemetry <!--NeedCopy-->
-
手动停止 Citrix Telemetry Service,或者等待 15 分钟以使服务自动停止。
在此示例中,可以运行以下命令来停止 Citrix Telemetry Service。
sudo netstat -ntlp Kill -9 1958 <!--NeedCopy-->
-
要重新启动 Citrix Telemetry Service,请在 Scout 上选择您的 Linux VDA 并在 /var/log/xdl/ 中查找 telemetry-debug.log。
服务等待时间
打开套接字端口的 systemd
守护程序默认启动并使用少量资源。Citrix Telemetry Service 默认处于停止状态,并仅在从 Delivery Controller 发出日志收集请求时启动。日志收集完成后,服务会等待新的收集请求,持续时间为 15 分钟,如果没有任何收集请求,则会再次停止。可以通过以下命令配置等待时间。最小值为 10 分钟。如果设置的值小于 10 分钟,则最小值 10 分钟将生效。设置等待时间后,停止并重新启动服务。
/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -v "TelemetryServiceIdleTimeoutInMinutes" -d <number> -t REG_DWORD
<!--NeedCopy-->
验证测试
在开始收集信息之前,验证测试将针对选定的每台计算机自动运行。这些测试将确保满足这些要求。如果某台计算机的测试失败,Scout 将显示一条消息,提供建议的更正措施。有关验证测试的详细信息,请参阅 Citrix Scout 文档中的验证测试部分。