NetScaler® テレメトリプログラム
NetScaler テレメトリプログラムは、顧客がメンテナンスおよびサポートのライセンス義務を遵守するために必要なライセンスおよび機能の使用状況データのアップロードを可能にする、必須のデータ収集プログラムです。Citrix は、ライセンスコンプライアンスを含む正当な利益のために、基本的なライセンステレメトリデータと NetScaler の展開および機能の使用状況テレメトリデータを収集します。NetScaler Console の構成および機能の使用状況データも、Citrix 製品およびサービスの管理、測定、改善のために収集されます。NetScaler の運用全体を改善および簡素化し、NetScaler の機能使用状況データを送信することで当社の製品およびサービスの強化をサポートするために、NetScaler インスタンスを NetScaler Console に追加することを強くお勧めします。詳細はこちら。NetScaler テレメトリプログラムは、ビルド 14.1-28.x 以降で自動的に有効になります。
前提条件
以下を確認してください。
-
エージェントが最新バージョンで実行されていること。デフォルトでは、エージェントは自動的にアップグレードされます。一部のシナリオでは、エージェントが古いバージョンで実行されている場合があり、エージェントを手動でアップグレードする必要があります。エージェントを手動でアップグレードする方法の詳細については、エージェントの手動アップグレードを参照してください。
-
NetScaler エージェントがポート 22 で NetScaler と通信できること。
-
NetScaler Gateway テレメトリデータを受信するために、ネットワークでポート 5140 が許可されていること。(VPN 仮想サーバー構成を持つ NetScaler インスタンスにのみ適用されます)。
注:
-
テレメトリのアップロードは、24 時間ごとに自動的に行われます。
-
NetScaler インスタンスでテレメトリメトリックを収集および保存するために、2024 年 6 月 18 日にリリースされた NetScaler テレメトリプログラムの一部として、以下の構成が NetScaler Console を介して NetScaler インスタンスにプッシュされました。
enable ns feature AppFlow
add analytics profile telemetry_metrics_profile -type timeseries -outputMode prometheus -metrics ENABLED -serveMode Pull -schemaFile "./telemetry_collect_ns_metrics_schema.json" -metricsExportFrequency 300
-
NetScaler テレメトリプログラムの一部としてプッシュされたテレメトリメトリックプロファイルを、次のコマンドを使用して削除する必要があります。
rm analytics profile telemetry_metrics_profile
-
NetScaler または NetScaler Console の分析機能を使用していない場合は、次のコマンドを使用して AppFlow 構成を削除できます。
disable ns feature AppFlow
-
Gateway テレメトリのために、
/nsconfig/.telemetry.confファイルが次のコマンドで更新されます。NetScaler Console は、このコマンドを毎時間チェックし、このコマンドが見つからない場合は追加します。このコマンドは、VPN 仮想サーバー構成を持つ NetScaler インスタンスにのみプッシュされます。
ns_telemetry_server,<Console IP>,5140
-
一部のテレメトリパラメータは、NetScaler Console から NetScaler インスタンスにプッシュされるスクリプトを介して収集されます。これらのスクリプトは読み取り専用であり、NetScaler の何も変更しません。
-
電子メールアドレス、ユーザー名、IP アドレスなど、テレメトリを介して収集された情報は、一方向ハッシュアルゴリズムを使用してソースで情報をハッシュ化することにより、安全に仮名化されます。その結果、Citrix はこれらの値にアクセスしたり読み取ったりすることはできません。このテレメトリデータは、論理的な資産照合の目的のみに使用されます。
次の表は、NetScaler テレメトリプログラムの一部として収集されるパラメータの詳細を示しています。
| カテゴリ | 説明 | 使用目的 |
|---|---|---|
| ライセンス、NetScaler の展開と使用状況のテレメトリ | ライセンスの資格、割り当て、使用状況、高レベルのNetScaler展開データ、およびNetScaler機能の使用状況に関する情報。 | ライセンスコンプライアンスのため、およびサービスを管理、測定、改善するため。 |
| NetScaler Console の展開と機能使用状況のテレメトリ | Console の展開と機能の使用状況に関する情報。 | サービスを管理、測定、改善するため。 |
テレメトリパラメータのリストの詳細については、「データガバナンス」を参照してください。