Citrix Telemetry Serviceとの統合

最終公開日 : Nov 13, 2026
Linux VDAソフトウェアにCitrix Telemetry Service (ctxtelemetry)が統合されているため、Citrix Scoutを実行できます。Citrix Scoutは、/opt/Citrix/VDA/bin/xdlcollect.shスクリプトを使用して、Linux VDAに関するログを収集します。
Citrix Scoutの画像(/en-us/linux-virtual-delivery-agent/2206/media/citrix-scout.png)
注:
Linux VDA 1912以前のバージョンからアップグレードした後、Citrix Telemetry Service (ctxtelemetry)の変数を構成するには、/opt/Citrix/VDA/sbin/ctxsetup.shを再実行する必要があります。変数について詳しくは、「簡易インストール」を参照してください。
Related information
管理

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
    ソケットポートの画像(/en-us/linux-virtual-delivery-agent/2206/media/socket-port.png)
  3. ソケットポートを再起動するには、次のコマンドを実行します。
    sudo systemctl daemon-reload
    sudo systemctl stop ctxtelemetry.socket
    sudo systemctl start ctxtelemetry.socket
  4. ファイアウォール構成で新しいポートを有効にします。
    たとえば、Ubuntu を使用している場合は、ポート 7503 を有効にするために sudo ufw allow 7503 コマンドを実行します。

デバッグモード

Citrix Telemetry Service が期待どおりに動作しない場合は、デバッグモードを有効にして原因を特定できます。
  1. デバッグモードを有効にするには、次のコマンドを実行して ctxtelemetry ファイルを開き、DebugMode の値を 1 に変更します。
    sudo vi /opt/Citrix/VDA/sbin/ctxtelemetry
    デバッグモードを有効にするイメージ (/en-us/linux-virtual-delivery-agent/2206/media/enable-debug-mode.png)
  2. Citrix Telemetry Service を手動で停止するか、サービスが自動的に停止するまで 15 分間待ちます。
    テレメトリを停止するイメージ (/en-us/linux-virtual-delivery-agent/2206/media/stop-telemetry.png)
    この例では、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 ドキュメントの「検証テスト」セクションを参照してください。