NetScaler® テレメトリプログラム
Citrixは、ライセンスコンプライアンスを含む正当な利益のために、基本的なライセンステレメトリデータとNetScalerの展開および機能使用状況のテレメトリデータを収集します。記載されているNetScalerテレメトリプログラムに準拠するために、必要なライセンスおよび機能使用状況データを自動または手動でアップロードできますこちら。NetScaler Consoleの構成および機能使用状況データも、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構成:
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の分析機能を使用していない場合は、AppFlow構成を削除するためにdisable ns feature 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インスタンスにプッシュします。設定がプッシュされないようにするには、自動モード（すべての前提条件が満たされている場合）であるか、最新ビルドにアップグレードする必要があります。 |
注記:
-
Gatewayテレメトリの場合、
/nsconfig/.telemetry.confファイルは次のコマンドで更新されます。NetScaler Consoleは、このコマンドが不足している場合、1時間ごとにこのコマンドをチェックして追加します。
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 Consoleの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 ConsoleオンプレミスがNetScalerテレメトリプログラムに準拠するためには、手動テレメトリのアップロードを90日ごとに実行する必要があります。
Citrixは、これらの要件を遵守しない場合、Citrixが法律または衡平法上持つその他の救済措置に加えて、責任を負うことなくCitrixサポートを一時停止または終了する場合があります。これらの要件は、法律または規制によって禁止されている範囲では適用されません。詳細については、Citrix License Telemetry FAQを参照してください。