与 Citrix 遥测服务集成

With the Citrix Telemetry Service (ctxtelemetry) integrated with the Linux VDA software, you can run Citrix Scout, which then uses the /opt/Citrix/VDA/bin/xdlcollect.sh script, to collect logs about the Linux VDA.

思杰探查器

思杰遥测服务的启用和禁用

  • To enable the service, run the sudo systemctl enable ctxtelemetry.socket command.
  • To disable the service, run sudo systemctl disable ctxtelemetry.socket.

端口

Citrix 遥测服务 (ctxtelemetry) 默认情况下使用 TCP/IP 端口 7503 侦听 Citrix Scout。它使用交付控制器上的 TCP/IP 端口 7502 与 Citrix Scout 通信。

安装 VDA 后更改端口,请执行以下操作:

  1. 要更改与 Scout 通信的端口,请运行以下命令。

    /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -t REG_DWORD -v "TelemetryServicePort" -d <port number> --force
    <!--NeedCopy-->
    
  2. 要更改用于侦听 Scout 的套接字端口,请运行以下命令以打开并编辑 ctxtelemetry.socket 文件。

    sudo vi /etc/systemd/system/ctxtelemetry.socket
    <!--NeedCopy-->
    

    套接字端口图像

  3. 运行以下命令以重新启动套接字端口。

    sudo systemctl daemon-reload
    sudo systemctl stop ctxtelemetry.socket
    sudo systemctl start ctxtelemetry.socket
    <!--NeedCopy-->
    
  4. 在防火墙配置中启用新端口。

    例如,如果您使用的是 Ubuntu,请运行 sudo ufw allow 7503 命令以启用端口 7503。

注意:

您也可以运行 ctxsetup.sh 来自动执行上述步骤 3 和 4。

调试模式

如果 Citrix Telemetry Service 未按预期工作,您可以启用调试模式以确定原因。

  1. 要启用调试模式,请运行以下命令打开 ctxtelemetry 文件,然后将 DebugMode 值更改为 1。

    sudo vi /opt/Citrix/VDA/sbin/ctxtelemetry
    <!--NeedCopy-->
    

    启用调试模式

  2. 手动停止 Citrix Telemetry Service,或者等待 15 分钟让服务自动停止。

    停止遥测

    在此示例中,您可以运行以下命令来停止 Citrix Telemetry Service。

    sudo netstat -ntlp
    Kill -9 1958
    <!--NeedCopy-->
    
  3. 若要重新启动 Citrix 遥测服务,您需要执行以下操作:在 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 文档中的验证测试 部分。

与 Citrix 遥测服务集成