Citrixは、ライセンスコンプライアンスを含む正当な利益のために、基本的なライセンステレメトリデータおよびNetScalerの展開と機能使用状況のテレメトリデータを収集します。
こちらに記載されているNetScalerテレメトリプログラムに準拠するために、必要なライセンスおよび機能使用状況データを自動または手動でアップロードできます。NetScaler Consoleの設定および機能使用状況データも、Citrix製品およびサービスの管理、測定、改善のために収集されます。既存のNetScaler Consoleのお客様は、NetScalerテレメトリプログラムに準拠していることを確認する必要があります。NetScalerインスタンスをNetScaler Consoleに追加して、NetScalerの運用全体を改善および簡素化し、NetScalerの機能使用状況データを送信することで、当社の製品およびサービスの強化をサポートすることを強くお勧めします。
詳細はこちら。
必要なテレメトリデータは、次の方法でアップロードできます。
-
自動収集モード - このモードは、
14.1-25.56以降 /
13.1-53.22以降のビルドにアップグレードすると、デフォルトで有効になります。自動モードでは、自動有効化されたチャネル(エンドポイントURL)を使用するためにアウトバウンド接続を作成し、テレメトリデータを自動的にアップロードします。エンドポイントURLに到達可能であることを確認するだけで済みます。アップロードは自動的に行われるため、前提条件が失敗しない限り、お客様側での操作は不要です。詳細については、
自動収集モードを参照してください。
-
手動収集モード - このモードは、自動モードが無効になっている場合にのみ有効になります。NetScaler ConsoleオンプレミスのNetScalerテレメトリホームページから必要なテレメトリデータをダウンロードし、30日以内にNetScaler Consoleサービスへの初回アップロードを完了する必要があります。準拠を維持するためには、その後のアップロードは90日ごとに行う必要があります。詳細については、
手動収集モードを参照してください。
自動テレメトリモードを使用して必要なデータを自動的にアップロードすることをお勧めしますが、自動モードを無効にして手動でアップロードすることもできます。自動モードと手動モードの両方で、NetScalerテレメトリプログラムに準拠するためにデータアップロードが必要です。オプションのテレメトリデータをデータアップロードに含めないように選択できますが、必要なライセンスコンプライアンスおよび機能使用状況テレメトリデータは、自動モードと手動モードの両方で提供する必要があります。
準拠を維持するには、最後の正常なアップロードからの日数が90日を超えてはなりません。
NetScalerテレメトリプログラムの一環として、以下の構成が管理対象のNetScalerインスタンスにプッシュされました。
-
AppFlow構成: 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 Consoleビルドにアップグレードすることをお勧めします。
-
14.1-43.x / 13.1-57.xビルド以降、NetScaler Consoleは、NetScalerインスタンスにテレメトリメトリックプロファイル構成が存在する場合、それを削除します。テレメトリメトリックプロファイル構成の削除は、NetScalerインスタンスの既存の機能には影響しません。
-
NetScalerまたはNetScaler Consoleの分析機能を使用していない場合は、次のコマンドを使用してAppFlow構成を削除できます。
disable ns feature AppFlow
以下の表は、最新ビルドおよび以前のビルドにおけるAppFlow®とテレメトリメトリックプロファイル構成に関する詳細を示します。
| ビルド |
テレメトリプログラムの一部としてプッシュされた構成 |
テレメトリモード |
必要なアクション |
| 14.1-43.x / 13.1-57.x |
いいえ |
自動および手動 |
構成はNetScalerインスタンスにプッシュされず、テレメトリメトリックプロファイル構成が存在する場合はNetScalerインスタンスから削除されます。NetScalerまたはNetScaler Consoleの分析機能を使用していない場合は、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 Consoleは、これらの設定が不足している場合、24時間ごとにこれらの設定をチェックし続け、NetScalerインスタンスにプッシュします。設定がプッシュされないようにするには、自動モード(すべての前提条件が満たされている場合)であるか、最新ビルドにアップグレードする必要があります。 |
ns_telemetry_server,<Console IP>,5140
-
一部のテレメトリパラメータは、NetScaler ConsoleからNetScalerインスタンスにプッシュされるスクリプトを介して収集されます。これらのスクリプトは読み取り専用であり、NetScalerの何も変更しません。
-
電子メールアドレス、ユーザー名、IPアドレスなどのテレメトリを通じて収集された情報は、一方向ハッシュアルゴリズムを使用してソースで情報をハッシュ化することにより、安全に仮名化されます。その結果、Citrixはこれらの値にアクセスしたり読み取ったりすることはできません。このテレメトリデータは、論理的な資産照合の目的のみに使用されます。
次の表は、NetScalerテレメトリプログラムの一部として収集されるパラメータの詳細を示しています。
| カテゴリ |
説明 |
何のために使用しますか? |
必須/オプション |
| ライセンス、NetScalerの展開と使用状況のテレメトリ |
ライセンスの資格、割り当て、使用状況、高レベルのNetScaler展開データ、およびNetScaler機能の使用状況に関する情報。 |
ライセンスコンプライアンス、およびサービスの管理、測定、改善のため。 |
必須 |
| NetScaler Consoleの展開と機能使用状況のテレメトリ |
Consoleの展開と機能使用状況に関する情報。 |
サービスの管理、測定、改善のため。 |
オプション |
オプションおよび必須のテレメトリパラメータのリストの詳細については、
データガバナンスを参照してください。
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以降にアップグレードした後、テレメトリモードのいずれか(自動または手動)がアクティブに機能している必要があります。手動レポートを選択した場合を除き、自動テレメトリレポートを許可するために必要に応じてファイアウォールを調整することに同意するものとします。
注意点:
-
テレメトリモジュールは、NetScaler上で複数のSSHコマンドを実行し、NetScalerコンソールのSSHユーティリティを使用して応答の出力を読み取ります。以下のいずれかの条件が満たされると、SSHユーティリティが正常に動作せず、テレメトリが失敗します。
-
NetScaler OSのホスト名に「#」文字が含まれている。
-
NetScalerのmotd(message of the day)に「#」文字が含まれている。
-
NetScalerのPS1プロンプトに「#」文字が含まれている。
-
最新ビルド (14.1–25.56以降 / 13.1–53.22以降) に2024年9月18日までに移行することを確実にしてください。
-
手動テレメトリモードを選択した場合、上記ビルドへの移行から30日以内、かつ2024年10月18日までに最初のアップロードを完了する必要があります。その後、NetScalerテレメトリプログラムに準拠するために、NetScaler Consoleオンプレミスでは90日ごとに手動テレメトリのアップロードを行う必要があります。
Citrixは、これらの要件を遵守しない場合、Citrixが法律上または衡平法上持つ可能性のあるその他の救済措置に加えて、責任を負うことなくCitrixサポートを一時停止または終了することがあります。これらの要件は、法律または規制によって禁止されている範囲では適用されません。詳細については、
Citrix License Telemetry FAQを参照してください。