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
    
  2. 要更改侦听 Scout 的套接字端口,请运行以下命令以打开并编辑 ctxtelemetry.socket 文件。

    sudo vi /etc/systemd/system/ctxtelemetry.socket
    

    套接字端口示意图

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

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

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

调试模式

如果 Citrix Telemetry Service 无法按预期方式运行,则可以启用调试模式来确定原因。

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

    sudo vi /opt/Citrix/VDA/sbin/ctxtelemetry
    

    启用调试模式示意图

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

    停止遥测示意图

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

    sudo netstat -ntlp
    Kill -9 1958
    
  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

验证测试

在开始收集信息之前,验证测试将针对选定的每台计算机自动运行。这些测试将确保满足这些要求。如果某台计算机的测试失败,Scout 将显示一条消息,提供建议的更正措施。有关验证测试的详细信息,请参阅 Citrix Scout 文档中的验证测试部分。

与 Citrix Telemetry Service 集成