Citrixライセンスデータ収集プログラム
以下のデータ収集プログラムは、製品エクスペリエンスの向上、導入の促進、および基本的なライセンス情報の収集を目的としています。
-
Citrix Licensing Call Home - このプログラムはオプションです。
-
Citrix Licensing Customer Experience Improvement Program (CEIP) - このプログラムはオプションです。
-
Citrix License Server Events – このプログラムはオプションです。
-
Citrix Licensing Telemetry - このプログラムは必須です。
-
NetScaler®テレメトリプログラム - このプログラムは必須です。
Citrixは、お客様とCitrixとの契約条件に従ってお客様のデータを処理し、Citrix Trust Centerで入手可能なServices Security Exhibitに明記されているとおりにデータを保護します。
プロキシサーバーの構成については、Get startedの記事の「プロキシサーバーを手動で構成する」を参照してください。
コマンドラインインストールについては、Windowsコマンドラインを使用してライセンスをインストールするを参照してください。
Citrix Licensing コールホーム
Call Homeプログラムは、お客様のエクスペリエンスを向上させ、時間の経過とともに製品の使用状況を把握し、導入を促進し、Citrix製品を改善します。このプログラムは、システム構成、製品構成、およびユーザーまたはデバイスデータを含む使用状況データをCitrixと共有します。
最初のアップロードは、ライセンスサーバーが最初に起動または再起動してから約5分後に実行され、その後のアップロードは1日1回実行されます。このプログラムはオプションです。
重要
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 は顧客エクスペリエンスを向上させることができます。最初のアップロードは、ライセンスサーバーが最初に起動または再起動してから約5分後に発生し、その後のアップロードは1日1回行われます。このプログラムはオプションです。
Citrix Licensing Manager を使用して、いつでもプログラムへの参加を変更できます。詳細については、「使用状況と統計」の「使用状況統計の共有」を参照してください。
| 収集されるデータ | 説明 | 使用目的 |
|---|---|---|
| ライセンス使用状況データ | ライセンスサーバーにインストールされている Citrix ライセンスに関する情報。製品ID、ライセンスの種類、数量、およびライセンス使用状況情報が含まれます。 | このデータを使用して、ライセンスがどのように消費されているか、および顧客数を追跡します。 |
| ライセンスサーバーの展開および構成データ | ライセンスサーバーとその展開方法に関する情報。ライセンスサーバーのバージョン、オペレーティングシステムのバージョン、および構成状態が含まれます。 | このデータを使用して、Citrix 製品のさらなる開発に役立て、顧客エクスペリエンスを向上させます。 |
CEIP データ要素のリストについては、「Citrix Licensing CEIP データ要素」を参照してください。
Citrix ライセンスサーバーイベントデータ
次の表は、ライセンスサーバーから収集され、以下の目的で使用されるデータを示しています。
-
顧客向けダッシュボードに情報を表示する
-
ライセンスの有効期限、ライセンスの更新、およびライセンスバーストモードに関するアラートと通知を提供します。
この機能は、ライセンスサーバーがCitrix Cloudに登録されている場合にのみ利用できます。
| 収集されるデータ | 説明 | 使用目的 |
|---|---|---|
| ライセンス使用状況データ | ライセンス使用状況情報に加えて、製品ID、ライセンスの種類、数量など、ライセンスサーバーにインストールされているCitrixライセンスに関する情報。 | このデータを使用して、ライセンスの有効期限、ライセンスの更新などに関するアラートと通知を有効にします。 |
| ライセンスサーバーのシステム情報 | ライセンスサーバーに関する情報（ハードウェアIDなど）。 | このデータを使用して、お客様の環境でライセンスサーバーを識別します。 |
この機能を有効または無効にする方法については、「使用状況統計の共有」セクションを参照してください。
ライセンスサーバーイベントデータ要素のリストについては、「Citrix License Serverイベントデータ要素」を参照してください。
Citrixライセンシングテレメトリ
Citrixライセンシングテレメトリは必須のデータ収集プログラムです。データの自動アップロードは、ライセンスサーバーのインストール時に有効になります。
Citrix License Server は、オンプレミス製品ライセンスのライセンスコンプライアンスをサポートするため、限定的なライセンステレメトリを Citrix に収集および報告します。これらのライセンスについては、Citrix は、新しいバージョンがリリースされてから 6 か月以内に、最新の License Server バージョンに移行することを要求します。License Server のライセンス収集とレポート（電子的または手動）は、License Server バージョン 11.17.2 Build 40000 以降でアクティブである必要があります。手動レポートを選択した場合を除き、電子ライセンスレポートを許可するために必要に応じてファイアウォールを調整することに同意するものとします。ご質問やご不明な点がある場合は、カスタマーケアにお問い合わせください。Citrix は、これらの要件を遵守しない場合、Citrix が法律または衡平法上持つその他の救済措置に加えて、責任を負うことなく Citrix Support を一時停止または終了することがあります。これらの要件は、法律または規制によって禁止されている範囲では適用されません。詳細については、ライセンステレメトリ FAQを参照してください。
重要:
コンプライアンスを維持するには、最後のアップロードが正常に完了してからの日数が 90 日を超えてはなりません。
テレメトリデータを正常にアップロードするための前提条件:
License Server から
<https://cis.citrix.com/> へのアウトバウンド。利用できない場合は、必要なファイアウォールルールを作成するか、プロキシを構成します。
| 収集されるデータ | 説明 | 使用目的 |
|---|---|---|
| ライセンス使用状況データ | 製品 ID、ライセンスの種類と数量、ユーザーおよびデバイスデータ、ライセンス使用状況情報など、License Server にインストールされている Citrix ライセンスに関する情報。 | このデータは、ライセンスコンプライアンスを含む当社の正当な利益のために使用されます。 |
| License Server システム情報 | License Server に関する情報（ハードウェア ID など） | このデータは、お客様の環境で License Server を識別するために使用されます。 |
ライセンシングテレメトリデータ要素のリストについては、Citrix ライセンシングテレメトリデータ要素を参照してください。
レポートオプション
ライセンス管理サービスは、ライセンスサーバーに組み込まれた製品テレメトリを使用して、定期的にデータをCitrixに電子的に送信します。
最初のコンプライアンスアップロードは、ライセンスサーバーが最初に起動または再起動してから約24時間後に発生し、その後は1日1回アップロードが行われます。ライセンスサーバーを再インストールするか、インプレースアップグレードを実行すると、スケジュールはリセットされます。アップロードが失敗した場合、アップロードが成功するか、ライセンス管理サービスが無効になるまで、24時間後に再試行されます。
ライセンス管理サービスを無効にすることで、このデータを手動で報告することを選択できます。ライセンス管理サービスを無効にする方法の詳細については、「コマンドラインを使用してライセンス管理サービスを有効または無効にする」を参照してください。
Citrixに報告するために必要なファイルは、手動アップロードを可能にするためにライセンスサーバーにローカルに保持されます。このデータをアップロードするには、Citrix Insight Servicesを使用する必要があります。Citrix Insight Servicesを使用した手動アップロード手順については、「Knowledge Centerの記事 - CTX472950」を参照してください。
注
Citrix Insight Servicesでは、ユーザーがアップロードできる最大ファイルサイズが制限されています。ファイルアップロードの要件の詳細については、「Knowledge Centerの記事 - 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 data elementsを別のタブで開きます。
-
XMLファイル内のタグをCitrix Licensing CEIP data elementsウェブページのフィールドと比較し、説明を確認してそのフィールドが何であるかを理解し、詳細については例を参照してください。例:
report.xmlファイルからDateSampleStartUTCをコピーし、Citrix Licensing CEIP data elementsで検索します。注: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キーを検索します。たとえば、datファイルからコピーしたEntitlementTypeをCitrix Virtual Apps and Desktops テレメトリデータ要素内で検索し、詳細については対応する説明と例を確認してください。