Linux Virtual Delivery Agent

与 Citrix Telemetry Service 集成

通过与 Linux VDA 软件集成的 Citrix Telemetry Service (ctxtelemetry),您可以运行 Citrix Scout,然后使用 /opt/Citrix/VDA/bin/xdlcollect.sh 脚本来收集有关 Linux VDA 的日志。

Citrix scout 示意图

注意:

从 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 后更改端口,请执行以下操作:

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

    /opt/Citrix/VDA/bin/ctxreg update -k "HKLM\Software\Citrix\VirtualDesktopAgent" -v "TelemetryServicePort" -d <port number> -t REG_DWORD
    <!--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。

调试模式

如果 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 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 文档中的验证测试部分。

与 Citrix Telemetry Service 集成