Citrix Licensing テレメトリ
以下のデータ収集プログラムは、お客様の製品エクスペリエンスを向上させ、導入を促進し、基本的なライセンス情報を収集するために設計されています。
-
Citrix Licensing Call Home - このプログラムはオプションです。
-
Citrix Licensing Customer Experience Improvement Program (CEIP) - このプログラムはオプションです。
-
Citrix License Server Events – このプログラムはオプションです。
-
Citrix Licensing Telemetry - このプログラムは必須です。
-
NetScaler® Telemetry プログラム - このプログラムは必須です。
Citrix は、お客様との契約条件に従ってお客様のデータを処理し、Citrix Trust Center で入手可能な Services Security Exhibit に指定されているとおりにデータを保護します。
プロキシサーバーの構成については、Get started の記事にある「プロキシサーバーを手動で構成する」を参照してください。
コマンドラインインストールについては、「Use the Windows command line to install licensing」を参照してください。
Citrix Licensing コールホーム
Call Home プログラムは、お客様のエクスペリエンスを向上させ、製品の使用状況を長期的に把握するのに役立ち、導入を促進し、Citrix 製品を改善します。このプログラムは、システム構成、製品構成、およびユーザーまたはデバイスデータを含む使用状況データを Citrix と共有します。
この情報は、サービス開始時間に基づいて1日1回Citrixに送信されます。このプログラムはオプションです。
重要:
Citrix Service ProviderプログラムではCall Homeが必要です。ライセンスサーバーがCitrix Service Providerライセンスを検出すると、毎日アップロードが強制されます。
ライセンスサーバーをCitrix Cloudに登録する場合、または登録を解除する場合は、使用状況と統計の「Citrix Cloudへの登録と登録解除」を参照してください。
Citrix Licensing Managerを使用して、いつでもプログラムへの参加を変更できます。詳しくは、使用状況と統計の「使用状況統計の共有」を参照してください。
| 収集されるデータ | 説明 | 使用目的 |
|---|---|---|
| ライセンス使用状況データ | ライセンスサーバーにインストールされているCitrixライセンスに関する情報。製品ID、ライセンスの種類、数量、ユーザー、デバイスデータ、およびライセンス使用状況情報が含まれます。 | このデータは、導入を促進し、時間の経過とともにライセンスの使用状況を把握するのに役立ちます。 |
| ライセンスサーバーの展開および構成データ | ライセンスサーバーとその展開方法に関する情報。ライセンスサーバーのバージョン、オペレーティングシステムのバージョン、構成状態が含まれます。 | このデータは、Citrix製品のさらなる開発に役立て、顧客エクスペリエンスを向上させるために使用されます。 |
Call Homeデータ要素のリストについては、Citrix Licensing Call Homeデータ要素を参照してください。
Citrix Licensingカスタマーエクスペリエンス向上プログラム
CEIPは、システムおよび製品の構成と、識別不可能な使用状況データを定期的に収集します。このデータを提供することで、Citrixは顧客体験を向上させることができます。この情報は、サービス開始時間に基づいて、1日1回Citrixに送信されます。このプログラムはオプションです。
Citrix Licensing Managerを使用して、いつでもプログラムへの参加を変更できます。詳細については、使用状況と統計の「使用状況統計の共有」を参照してください。
| 収集されるデータ | 説明 | 使用目的 |
|---|---|---|
| ライセンス使用状況データ | ライセンス使用状況情報に加えて、製品ID、ライセンスの種類、数量など、ライセンスサーバーにインストールされているCitrixライセンスに関する情報。 | このデータを使用して、ライセンスがどのように消費されているか、および顧客数を追跡します。 |
| ライセンスサーバーの展開および構成データ | ライセンスサーバーのバージョン、オペレーティングシステムのバージョン、構成状態など、ライセンスサーバーとその展開方法に関する情報。 | このデータを使用して、Citrix製品のさらなる開発に役立て、顧客体験を向上させます。 |
CEIPデータ要素のリストについては、Citrix Licensing CEIPデータ要素を参照してください。
Citrixライセンスサーバーイベントデータ
次の表は、ライセンスサーバーから収集され、以下の目的で使用されるデータを示しています。
-
顧客向けダッシュボードに情報を表示する
-
ライセンスの有効期限切れ、ライセンスの更新、およびライセンスバーストモードに関するアラートと通知を提供します。
この機能は、ライセンスサーバーがCitrix Cloudに登録されている場合にのみ利用できます。
| 収集されるデータ | 説明 | 使用目的 |
|---|---|---|
| ライセンス使用状況データ | ライセンスサーバーにインストールされているCitrixライセンスに関する情報。これには、製品ID、ライセンスの種類、数量、およびライセンス使用状況情報が含まれます。 | このデータを使用して、ライセンスの有効期限切れ、ライセンスの更新などに関するアラートと通知を有効にします。 |
| ライセンスサーバーシステム情報 | ライセンスサーバーに関する情報（ハードウェアIDなど）。 | このデータを使用して、お客様の環境でライセンスサーバーを識別します。 |
この機能を有効または無効にする方法については、「使用状況統計の共有」セクションを参照してください。
ライセンスサーバーイベントデータ要素のリストについては、「Citrix License Server Event data elements」を参照してください。
Citrixライセンシングテレメトリ
Citrixライセンシングテレメトリは必須のデータ収集プログラムです。データの自動アップロードは、ライセンスサーバーのインストール時に有効になります。
Citrix License Server は、オンプレミス製品ライセンスのライセンスコンプライアンスをサポートするために、限定的なライセンステレメトリを Citrix に収集および報告します。これらのライセンスについては、Citrix は、新しいバージョンがリリースされてから 6 か月以内に、最新の License Server バージョンに移行することを要求します。License Server バージョン 11.17.2 ビルド 40000 以降では、License Server のライセンス収集とレポート（電子的または手動）がアクティブである必要があります。手動レポートを選択した場合を除き、電子ライセンスレポートを許可するために必要に応じてファイアウォールを調整することに同意するものとします。ご質問やご不明な点がある場合は、カスタマーケア にお問い合わせください。Citrix は、これらの要件を遵守しない場合、Citrix が法律または衡平法上持つその他の救済措置に加えて、責任を負うことなく Citrix サポートを一時停止または終了することがあります。これらの要件は、法律または規制によって禁止されている範囲では適用されません。詳細については、ライセンステレメトリ FAQ を参照してください。
重要:
コンプライアンスを維持するには、最後のアップロードが正常に完了してからの日数が 90 日を超えてはなりません。
テレメトリデータを正常にアップロードするための前提条件:
License Server から
<https://cis.citrix.com/> へのアウトバウンド。利用できない場合は、必要なファイアウォールルールを作成するか、プロキシを構成 してください。
| 収集されるデータ | 説明 | 使用目的 |
|---|---|---|
| ライセンス使用状況データ | License Server にインストールされている Citrix ライセンスに関する情報。これには、製品 ID、ライセンスの種類と数量、ユーザーおよびデバイスデータ、ライセンス使用状況情報が含まれます。 | 当社は、ライセンスコンプライアンスを含む正当な利益のためにこのデータを使用します。 |
| License Server システム情報 | License Server に関する情報（ハードウェア ID など） | 当社は、このデータを使用して、お客様の環境内の License Server を識別します。 |
ライセンシングテレメトリデータ要素のリストについては、Citrix ライセンシングテレメトリデータ要素 を参照してください。
レポートオプション
ライセンス管理サービスは、ライセンスサーバーに組み込まれている製品テレメトリを使用して、定期的にCitrixにデータを電子的に送信します。
最初のコンプライアンスアップロードは、ライセンスサーバーが最初に起動または再起動してから約24時間後に発生し、その後は1日1回アップロードが行われます。ライセンスサーバーを再インストールするか、インプレースアップグレードを実行すると、スケジュールはリセットされます。アップロードが失敗した場合、アップロードが成功するか、ライセンス管理サービスが無効になるまで、24時間後に再試行されます。
ライセンス管理サービスを無効にすることで、このデータを手動で報告することを選択できます。ライセンス管理サービスを無効にする方法の詳細については、「コマンドラインを使用してライセンス管理サービスを有効または無効にする」を参照してください。
Citrixに報告するために必要なファイルは、手動アップロードを可能にするためにライセンスサーバーにローカルに保持されます。このデータをアップロードするには、Citrix Insight Servicesを使用する必要があります。Citrix Insight Servicesを使用した手動アップロード手順の詳細については、「Knowledge Center article - CTX472950」を参照してください。
注
Citrix Insight Servicesでは、ユーザーがアップロードできる最大ファイルサイズが制限されています。ファイルアップロード要件の詳細については、「Knowledge Center article - CTX131233」を参照してください。
11.17.2ビルド45000以降、Citrixにデータを手動で報告することを選択したユーザーは、ライセンスサーバーとCitrix Virtual Apps and Desktopsの両方のデータ要素をアップロードする必要があります。ライセンスサーバーのデータ要素は
upload_compliance*.zipファイルにバンドルされています。Citrix Virtual Apps and Desktopsのデータ要素はupload_usage_*.zipファイルにバンドルされています。
upload_compliance*.zipファイルはc:\Program Files (x86)\Citrix\Licensing\LS\resource\usageにあります。すべてのupload_compliance*.zipファイルを単一のzipファイルに保存し、Citrix Insight Servicesを使用してこの.zipファイルをCitrixに送信できます。
upload_usage_*.zipファイルはc:\Program Files (x86)\Citrix\Licensing\LS\resource\cis bundles\ul_usageにあります。すべてのupload_usage_*.zipファイルを単一のzipファイルに保存し、Citrix Insight Servicesを使用してこの.zipファイルをCitrixに送信できます。
アップロードが成功したら、ライセンスサーバーからすべての
upload_*.zipファイルを削除できます。.zipファイルを削除しないと、ライセンスサーバーのディスク容量が不足する可能性があります。
最新の自動アップロードのステータスを確認するには、ライセンスサーバー上の次のXMLログファイルの内容を調べることができます。
-
使用状況テレメトリ (
upload_usage_*.zip): 次のCTX_UPLOAD_TYPE_USAGEノードを確認します。-
<LS_install>\resource\cache\ul_result.xml
-
-
コンプライアンステレメトリ (
upload_compliance_*.zip): 次のアップロードステータスを確認します。-
C:\Program Files (x86)\Citrix\Licensing\LS\resource\cache\upload_compliance_result.xml
-
サンプルデータ:
成功:
<CtxUploaderResult><Code>CTX_UPLOADER_SUCCESS</Code><Msg></Msg><t>1679283497</t><UploadType>CTX_UPLOAD_TYPE_COMPLIANCE</UploadType></CtxUploaderResult>
失敗:
<CtxUploaderResult><Code>CTX_UPLOADER_ERROR_NETWORK_OPEN</Code><Msg>SocketOpen(cis.citrix.com:443) exception: {GetAddrInfoW(cis.citrix.com) failed: WSAHOST_NOT_FOUND : code 0x00002af9: No such host is known.
}</Msg><Arg>cis.citrix.com:443</Arg><t>1679283245</t><UploadType>CTX_UPLOAD_TYPE_COMPLIANCE</UploadType></CtxUploaderResult>
アップロードされたzipファイル内のデータの読み方
upload_compliance*.zip
-
upload_compliance*.zipファイルを解凍します。 -
report.xmlをブラウザで開きます。 -
別のタブでCitrix Licensing CEIPデータ要素を開きます。
-
XMLファイルのタグを、Citrix Licensing CEIPデータ要素ウェブページのフィールドと比較し、説明を確認してそのフィールドが何であるかを理解し、詳細については例を参照してください。例:
report.xmlファイルからDateSampleStartUTCをコピーし、Citrix Licensing CEIPデータ要素で検索します。注:report.xml内の一部のデータは、匿名化のために意図的にハッシュ化されています。
upload_usage_*.zip
-
upload_usage*.zipファイルを解凍します。 -
ue_lt_*.zipで始まる複数のzipファイルが見つかります。 -
いずれかのzipファイルを解凍します。
-
ue_lt_*.datファイルが見つかります。これはデータベースファイルです。 -
このファイルを読み取るには、任意のSQLデータベースエディターツールを使用できます。たとえば、DB Browser (SQLite) を使用してファイルを開き、JSON形式で表示してコンテンツを読みやすくすることができます。次の画像はサンプルビューを示しています。
-
次に、Citrix Virtual Apps and Desktops テレメトリーデータ要素またはその他のCitrix Licensing テレメトリーデータ要素でJSONキーを検索します。たとえば、Citrix Virtual Apps and Desktops テレメトリーデータ要素のdatファイルからコピーしたEntitlementTypeを検索し、対応する説明と例で詳細を確認してください。