NetScaler Console

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 インスタンスにプッシュされました。

  • アップフロー構成: 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インスタンスにプッシュし続けます。設定がプッシュされないようにするには、自動モード (すべての前提条件が満たされている場合) にするか、最新のビルドにアップグレードする必要があります。

注:

  • /nsconfig/.telemetry.confファイルは、Gatewayテレメトリの以下のコマンドで更新されます。NetScaler Consoleは、このコマンドが不足している場合、1時間ごとにこのコマンドをチェックして追加します。
ns_telemetry_server,<Console IP>,5140
<!--NeedCopy-->
  • 一部のテレメトリパラメータは、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(メッセージ・オブ・ザ・デイ)には「#」文字が含まれています。

    • NetScalerのPS1プロンプトに「#」文字が含まれている。

  • 2024年9月18日までに、最新のビルド (14.1–25.56以降 / 13.1–53.22以降) に移行することを確実にしてください。

  • 手動テレメトリモードを選択した場合、最初のアップロードは、上記のビルドへの移行から30日以内、かつ2024年10月18日までに完了する必要があります。その後、NetScaler ConsoleオンプレミスがNetScalerテレメトリプログラムに準拠するためには、手動テレメトリのアップロードを90日ごとに実行する必要があります。

Citrixは、これらの要件を遵守しない場合、Citrixが法律または衡平法上持つその他の救済措置に加えて、責任を負うことなくCitrixサポートを一時停止または終了する場合があります。これらの要件は、法律または規制によって禁止されている範囲では適用されません。詳細については、Citrix License Telemetry FAQを参照してください。

NetScaler® テレメトリプログラム

この記事の概要