Linux 仮想配信エージェント 2503

Citrix Telemetry Serviceとの統合

April 13, 2026

寄稿者:

Citrix Telemetry Service (ctxtelemetry)がLinux VDAソフトウェアと統合されているため、Citrix Scoutを実行して、/opt/Citrix/VDA/bin/xdlcollect.shスクリプトを使用してLinux VDAに関するログを収集できます。

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と通信します。

VDAのインストール後にポートを変更するには、次の手順を実行します。

Scoutとの通信に使用するポートを変更するには、次のコマンドを実行します。

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -t REG_DWORD -v "TelemetryServicePort" -d <port number> --force
<!--NeedCopy-->

Scoutをリッスンするためのソケットポートを変更するには、次のコマンドを実行してctxtelemetry.socketファイルを開き、編集します。
```
sudo vi /etc/systemd/system/ctxtelemetry.socket

```

ソケットポートを再起動するには、次のコマンドを実行します。

sudo systemctl daemon-reload
sudo systemctl stop ctxtelemetry.socket
sudo systemctl start ctxtelemetry.socket
<!--NeedCopy-->

ファイアウォール構成で新しいポートを有効にします。

たとえば、Ubuntuを使用している場合は、sudo ufw allow 7503コマンドを実行してポート7503を有効にします。

注：

代わりにctxsetup.shを実行して、上記のステップ3および4を自動化することもできます。

デバッグモード

Citrix Telemetry Serviceが期待どおりに動作しない場合は、デバッグモードを有効にして原因を特定できます。

デバッグモードを有効にするには、次のコマンドを実行してctxtelemetryファイルを開き、DebugModeの値を1に変更します。
```
sudo vi /opt/Citrix/VDA/sbin/ctxtelemetry

```
Citrix Telemetry Serviceを手動で停止するか、サービスが自動的に停止するまで15分間待ちます。

この例では、次のコマンドを実行してCitrix Telemetry Serviceを停止できます。
```
sudo netstat -ntlp
Kill -9 1958

```
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ドキュメントの「検証テスト」セクションを参照してください。

この製品ドキュメントの正式なバージョンは英語版です。英語以外のすべてのバージョンは、お客様の利便性のためにのみ提供され、機械翻訳された内容が含まれている場合があります。詳しくは、Cloud Software Group home で機械翻訳に関する免責事項（Machine Translation Disclaimer）をご覧ください。

この情報は役に立ちましたか?

Citrix Telemetry Serviceとの統合

April 13, 2026

寄稿者:

April 13, 2026

寄稿者:

この情報は役に立ちましたか?