Citrix は、ライセンスコンプライアンスなどの正当な利益のために、基本的なライセンステレメトリデータと NetScaler の展開および機能の使用状況テレメトリデータを収集します。 ここで 説明する NetScaler テレメトリ プログラムに準拠し続けるために、必要なライセンスと機能の使用状況データを自動または手動でアップロードできます。 NetScaler コンソールの構成と機能の使用状況データも収集され、Citrix 製品とサービスを管理、測定、改善するために使用されます。 既存の NetScaler Console 顧客の場合は、NetScaler テレメトリ プログラムに準拠していることを確認する必要があります。 NetScaler の機能使用状況データを送信することで、NetScaler の全体的な操作を改善および簡素化し、製品とサービスの強化をサポートするために、NetScaler インスタンスを NetScaler Console に追加することを強くお勧めします。 詳細はこちら。
必要なテレメトリ データを次の方法でアップロードできます。
自動収集モード - このモードは、 14.1 25.56 以降 / 13.1-53.22 以降 ビルドにアップグレードすると、デフォルトで有効になります。 自動モードでは、自動有効化されたチャネル (エンドポイント URL) を使用するための送信接続が作成され、テレメトリ データが自動的にアップロードされます。 エンドポイント URL にアクセスできることを確認するだけで済みます。 アップロードは自動的に行われるため、前提条件が満たされない限り、ユーザー側でアクションを実行する必要はありません。 詳細については、 自動収集モードを参照してください。
手動収集モード - このモードは、自動モードが無効になっている場合にのみ有効になります。 オンプレミスの NetScaler Console の NetScaler テレメトリ ホームページから必要なテレメトリ データをダウンロードし、30 日以内に NetScaler Console サービスへの最初のアップロードを完了する必要があります。 コンプライアンスを維持するには、その後のアップロードは 90 日ごとに行う必要があります。 詳細については、 手動収集モードを参照してください。
自動テレメトリ モードを使用して必要なデータを自動的にアップロードすることをお勧めしますが、自動モードを無効にして手動でアップロードすることもできます。 自動モードと手動モードの両方で、NetScaler テレメトリ プログラムに準拠するにはデータのアップロードが必要です。 オプションのテレメトリ データがデータのアップロードに含まれないようにすることもできますが、必要なライセンス コンプライアンスと機能の使用状況のテレメトリ データは、自動モードと手動モードの両方で提供する必要があります。
コンプライアンスを維持するには、最後に正常にアップロードされてからの日数が 90 日を超えてはなりません。
NetScaler テレメトリ プログラムの一環として、管理対象の NetScaler インスタンスに次の構成がプッシュされました。
AppFlow 構成: ns 機能 AppFlow を有効にする
テレメトリ メトリック プロファイルの構成: 分析プロファイル telemetry_metrics_profile -type timeseries -outputMode prometheus -metrics ENABLED -serveMode Pull -schemaFile "./telemetry_collect_ns_metrics_schema.json" -metricsExportFrequency 300 を追加します
注記：
テレメトリ収集を最適化するには、最新の NetScaler コンソール ビルドにアップグレードすることをお勧めします。
14.1-43.x / 13.1-57.x ビルド以降、NetScaler コンソールは、NetScaler インスタンスにテレメトリ メトリック プロファイル構成が存在する場合、それを削除します。 テレメトリ メトリック プロファイル構成の削除は、NetScaler インスタンスの既存の機能には影響しません。
NetScaler または NetScaler Console 分析機能を使用していない場合は、次のコマンドを使用して AppFlow 構成を削除できます。
ns機能AppFlowを無効にする
次の表は、最新ビルドと以前のビルドにおける AppFlow およびテレメトリ メトリック プロファイル構成の詳細を示しています。
| 建てる | テレメトリプログラムの一部としてプッシュされた構成 | テレメトリモード | 必要なアクション |
|---|---|---|---|
| 14.1-43.x / 13.1-57.x | いいえ | 自動と手動 | 構成は NetScaler インスタンスにプッシュされず、テレメトリ メトリック プロファイル構成が存在する場合は NetScaler インスタンスから削除されます。 NetScaler または NetScaler コンソールの分析機能を使用していない場合は、 disable ns feature AppFlow を使用して AppFlow 構成を削除できます。 |
| 14.1-29.x / 13.1-55.x | いいえ | 自動と手動 | 構成は、NetScaler テレメトリ プログラムの一部としてプッシュされません。 これらの構成が NetScaler インスタンスに存在し、これらの構成を削除する場合は、NetScaler で rm analytics profile telemetry_metrics_profile コマンドを実行してテレメトリ メトリックス プロファイル構成を削除し、 disable ns feature AppFlow を使用して AppFlow 構成を削除します。 |
| 14.1-25.56 / 13.1-53.22
|
はい。 AppFlowとテレメトリメトリックプロファイル構成
|
自動化（すべての前提条件を満たしている場合） | 構成は NetScaler テレメトリ プログラムの一部としてプッシュされますが、24 時間ごとにチェックされるわけではありません。 これらの構成を削除するには、NetScaler で rm analytics profile telemetry_metrics_profile コマンドを実行してテレメトリ メトリックス プロファイル構成を削除し、 disable ns feature AppFlow を使用して AppFlow 構成を削除します。 |
| 自動（前提条件を満たしていない場合）または手動 | NetScaler コンソールは、これらの構成を 24 時間ごとにチェックし、これらの構成が見つからない場合は NetScaler インスタンスにプッシュし続けます。 構成をプッシュしたくない場合は、自動モード（すべての前提条件を満たしている）にするか、最新のビルドにアップグレードする必要があります。 |
注記:
- ゲートウェイテレメトリの
/nsconfig/.telemetry.confファイルは、次のコマンドで更新されます。 NetScaler コンソールはこのコマンドを 1 時間ごとにチェックし、このコマンドがない場合は追加します。ns_telemetry_server、<Console IP>、5140 <!--NeedCopy-->
一部のテレメトリ パラメータは、NetScaler コンソールから NetScaler インスタンスにプッシュされるスクリプトを通じて収集されます。 これらのスクリプトは読み取り専用であり、NetScaler では何も変更されません。
電子メール アドレス、ユーザー名、IP アドレスなど、テレメトリを通じて収集された情報は、一方向ハッシュ アルゴリズムを使用してソースで情報をハッシュすることにより、安全に仮名化されます。 その結果、Citrix はこれらの値にアクセスしたり読み取ったりすることができません。 このテレメトリ データは、論理資産のマッチングの目的でのみ使用されます。
次の表は、NetScaler テレメトリ プログラムの一部として収集されるパラメータの詳細を示しています。
| カテゴリー | 説明 | 何に使うのでしょうか? | 必須/オプション |
|---|---|---|---|
| ライセンス、NetScalerの導入と使用状況のテレメトリ | ライセンスの資格、割り当て、使用状況、高レベルの NetScaler 展開データ、および NetScaler 機能の使用状況に関する情報。 | ライセンスのコンプライアンス、サービスの管理、測定、改善。 | 必須 |
| NetScaler コンソールの展開と機能の使用状況テレメトリ | コンソールの展開と機能の使用に関する情報。 | サービスを管理、測定、改善するため。 | オプション |
オプションおよび必須のテレメトリ パラメーターのリストの詳細については、「 データ ガバナンス」を参照してください。
Citrix では、2024 年 6 月 18 日から 3 か月以内に、最新の NetScaler Console ビルド（14.1 25.56 以降/13.1–53.22 以降）に移行することを義務付けています。 NetScaler Console 14.1 25.56 以降 / 13.1–53.22 以降にアップグレードした後、テレメトリ モードの 1 つ (自動または手動) がアクティブに機能している必要があります。 手動レポートを選択しない限り、自動テレメトリレポートを可能にするために必要に応じてファイアウォールを調整することに同意するものとします。
注意点:
2024 年 9 月 18 日までに最新のビルド (14.1–25.56 以降 / 13.1–53.22 以降) に移行する必要があります。
手動テレメトリ モードを選択した場合、最初のアップロードは上記のビルドへの移行後 30 日以内、遅くとも 2024 年 10 月 18 日までに完了する必要があります。 その後、オンプレミスの NetScaler コンソールが NetScaler テレメトリ プログラムに準拠するには、90 日ごとに手動のテレメトリ アップロードを実行する必要があります。
Citrix は、法律または衡平法に基づいて Citrix が有するその他の救済手段に加えて、これらの要件が遵守されない場合、責任を負うことなく Citrix サポートを一時停止または終了する場合があります。 これらの要件は、法律または規制によって禁止されている範囲には適用されません。 詳細については、「 Citrix ライセンステレメトリの FAQ」を参照してください。