Citrix インサイトサービス

最終公開日 : Nov 13, 2026
Citrix Insight Services (CIS) は、計測、テレメトリー、ビジネスインサイト生成のための Citrix プラットフォームです。その計測およびテレメトリー機能により、技術ユーザー（顧客、パートナー、エンジニア）は、問題を自己診断して修正し、環境を最適化できます。CIS の詳細および最新情報については、<https://cis.citrix.com> を参照してください（Citrix アカウントの資格情報が必要です）。
Citrixにアップロードされるすべての情報は、トラブルシューティングと診断の目的、および製品の品質、信頼性、パフォーマンスの向上のために使用されます。ただし、以下に従います。
  • シトリックス インサイト サービス ポリシー (https://cis.citrix.com/legal)
  • Citrixプライバシーポリシー（<https://www.cloud.com/privacy-policy>）
このCitrix Virtual Apps and Desktops™リリースは、以下のテクノロジーをサポートしています。
Related information
管理
シトリックス スカウト

インストールおよびアップグレード分析

Citrix Virtual Apps and Desktops コンポーネントを展開またはアップグレードするためにフルプロダクトインストーラーを使用すると、インストールプロセスに関する匿名情報が収集され、コンポーネントをインストール/アップグレードしているマシンに保存されます。このデータは、Citrix が顧客のインストールエクスペリエンスを向上させるのに役立てられます。
この情報は、%ProgramData%\\Citrix\\CTQs の下にローカルに保存されます。
このデータの自動アップロードは、フルプロダクトインストーラーのグラフィカルインターフェイスとコマンドラインインターフェイスの両方で、デフォルトで有効になっています。
  • レジストリ設定のデフォルト値を変更できます。インストール/アップグレード前にレジストリ設定を変更した場合、フルプロダクトインストーラーを使用する際にその値が使用されます。
  • コマンドでオプションを指定することにより、コマンドラインインターフェイスでインストール/アップグレードする際にデフォルト設定を上書きできます。
自動アップロードの制御:
  • インストール/アップグレード分析の自動アップロードを制御するレジストリ設定 (デフォルト = 1):
    • 場所: HKLM:\Software\Citrix\MetaInstall
    • 名前: SendExperienceMetrics
    • 値: 0 = 無効、1 = 有効
  • PowerShell を使用すると、次のコマンドレットでインストール/アップグレード分析の自動アップロードが無効になります:
    New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\MetaInstall -Name SendExperienceMetrics -PropertyType DWORD -Value 0
  • XenDesktopServerSetup.exe または XenDesktopVDASetup.exe コマンドで自動アップロードを無効にするには、/disableexperiencemetrics オプションを含めます。
    XenDesktopServerSetup.exe または XenDesktopVDASetup.exe コマンドで自動アップロードを有効にするには、/sendexperiencemetrics オプションを含めます。

Citrix カスタマーエクスペリエンス向上プログラム

Citrixカスタマーエクスペリエンス向上プログラム (CEIP) に参加すると、匿名の統計情報と使用状況情報がCitrixに送信され、Citrix製品の品質とパフォーマンスの向上に役立てられます。詳細については、https://more.citrix.com/XD-CEIP を参照してください。

サイト作成時またはアップグレード時の登録

サイトを作成すると (最初のDelivery Controller™をインストールした後)、CEIPに自動的に登録されます。最初のデータアップロードは、サイト作成後約7日で行われます。
サイト作成後、いつでも参加を停止できます。Studioの左ペインで設定ノードを選択し、Citrixカスタマーエクスペリエンス向上プログラム設定をオフにしてください。
Citrix Virtual Apps and Desktops展開をアップグレードする場合:
  • CEIP をサポートしていないバージョンからアップグレードする場合、参加するかどうかを尋ねられます。
  • CEIPをサポートしていたバージョンからアップグレードし、参加が有効になっていた場合、アップグレードされたサイトでCEIPが有効になります。
  • CEIPをサポートしていたバージョンからアップグレードし、参加が無効になっていた場合、アップグレードされたサイトでCEIPが無効になります。
  • CEIPをサポートしていたバージョンからアップグレードし、参加状況が不明な場合、参加を希望するかどうか尋ねられます。
収集された情報は匿名であるため、Citrix Insight Servicesにアップロードされた後は閲覧できません。

VDAインストール時の登録

デフォルトでは、Windows VDAをインストールすると、CEIPに自動的に登録されます。このデフォルト設定はレジストリ設定で変更できます。VDAをインストールする前にレジストリ設定を変更した場合、その値が使用されます。
CEIPへの自動登録を制御するレジストリ設定（デフォルト = 1）：
場所: HKLM: \\Software\Citrix\Telemetry\CEIP 名前: Enabled 値: 0 = 無効, 1 = 有効
デフォルトでは、Enabled プロパティはレジストリに隠されています。指定されていない場合、自動アップロード機能は有効になります。
PowerShellを使用すると、次のコマンドレットでCEIPへの登録を無効にできます。
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\Telemetry\CEIP -Name Enabled -PropertyType DWORD -Value 0
収集されたランタイムデータポイントは、定期的にファイルとして出力フォルダー（デフォルト %programdata%/Citrix/VdaCeip）に書き込まれます。
データの初回アップロードは、VDAのインストール後約7日で行われます。

その他の製品およびコンポーネントのインストール時の登録

関連するCitrix製品、コンポーネント、テクノロジー（Citrix Provisioning™、AppDNA、Citrix License Server、Windows向けCitrix Workspace™アプリ、Universal Print Server、Session Recordingなど）をインストールする際にも、CEIPに参加できます。インストールと参加のデフォルト値の詳細については、それぞれのドキュメントを参照してください。

シトリックス Call Home

Citrix Virtual Apps and Desktopsで特定のコンポーネントや機能をインストールする際、Citrix Call Homeへの参加を求められます。Call Homeは診断データを収集し、そのデータを含むテレメトリパッケージを、分析とトラブルシューティングのためにCitrix Insight Servicesに直接（デフォルトポート443のHTTPS経由で）定期的にアップロードします。
Citrix Virtual Apps and Desktopsでは、Call HomeはCitrix Telemetry Serviceという名前のバックグラウンドサービスとして実行されます。
Call Homeのスケジュール機能はCitrix Scoutでも利用できます。詳細については、Citrix Scoutを参照してください。

収集される情報

Citrix Diagnostic Facility (CDF) トレースは、トラブルシューティングに役立つ情報をログに記録します。Call Homeは、VDA登録やアプリケーション/デスクトップの起動など、一般的な障害のトラブルシューティングに役立つCDFトレースのサブセットを収集します。このテクノロジーは、常時オンのトレース (AOT) として知られています。AOTログは、C:\ProgramData\Citrix\TelemetryService\CitrixAOTにディスクに保存されます。
注:
ProgramDataフォルダーは非表示になっています。表示するには、表示 > 表示/非表示 > 隠しファイルをクリックします。
Call Homeは、その他のEvent Tracing for Windows (ETW) 情報を収集せず、またそのように構成することもできません。
Call Homeは、次のようなその他の情報も収集します。
  • HKEY_LOCAL_MACHINE\SOFTWARE\Citrixの下にCitrix Virtual Apps and Desktopsによって作成されたレジストリ。
  • Citrix名前空間下のWindows Management Instrumentation (WMI) 情報。
  • 実行中のプロセスの一覧。
  • %PROGRAM DATA%\\Citrix\\CDFに保存されているCitrixプロセスのクラッシュダンプ。
  • インストールおよびアップグレード情報。これには、製品の完全なメタインストーラーログ、失敗したMSIログ、MSIログアナライザーからの出力、StoreFront™ログ、ライセンス互換性チェックログ、およびサイトアップグレードの事前テスト結果が含まれます。
トレース情報は収集時に圧縮されます。Citrix Telemetry Service は、最大 10 MB の圧縮された最新のトレース情報を、最長 8 日間保持します。
  • データを圧縮することで、Call Home は VDA 上で小さなフットプリントを維持できます。
  • プロビジョニングされたマシンでの IOP を回避するため、トレースはメモリに保持されます。
  • トレースバッファは、メモリ内のトレースを保持するために循環メカニズムを使用します。
Call Home は、Call Home の主要なデータポイントに記載されている主要なデータポイントを収集します。

構成と管理の概要

Call Home には、製品版インストールウィザードの使用時、または後で PowerShell コマンドレットを使用して登録できます。登録すると、既定では、診断情報が毎週日曜日の現地時間午前 3 時頃に収集され、Citrix にアップロードされます。アップロードは、指定された時刻から 2 時間の範囲でランダム化されます。つまり、既定のスケジュールを使用するアップロードは、午前 3 時から午前 5 時の間に行われます。
診断情報をスケジュールに基づいてアップロードしたくない場合（またはスケジュールを変更したい場合）は、PowerShell コマンドレットを使用して、診断情報を手動で収集してアップロードするか、ローカルに保存できます。
スケジュールされた Call Home アップロードに登録する場合、および診断情報を手動で Citrix にアップロードする場合、Citrix アカウントまたは Citrix Cloud™ の資格情報を入力します。Citrix は、資格情報をアップロードトークンと交換します。このトークンは、顧客を識別し、データをアップロードするために使用されます。資格情報は保存されません。
アップロードが発生すると、Citrix アカウントに関連付けられているアドレスに通知メールが送信されます。
コンポーネントのインストール時に Call Home を有効にした場合、後で無効にできます。

前提条件

  • マシンで PowerShell 3.0 以降が実行されている必要があります。
  • マシンで Citrix Telemetry Service が実行されている必要があります。
  • システム変数 PSModulePath は、Telemetry のインストールパス (例えば、C:\\Program Files\\Citrix\\Telemetry Service\\.) に設定する必要があります。

コンポーネントのインストール中に Call Home を有効にする

VDA のインストールまたはアップグレード中: 製品版インストーラーのグラフィカルインターフェイスを使用して Virtual Delivery Agent をインストールまたはアップグレードする際に、Call Home に参加するかどうかを尋ねられます。次の 2 つのオプションがあります。
  • Call Home に参加する。
  • Call Home に参加しない。
VDAをアップグレードしていて、以前にCall Homeに登録していた場合、そのウィザードページは表示されません。
Controllerのインストールまたはアップグレード中: グラフィカルインターフェイスを使用してDelivery Controllerをインストールまたはアップグレードすると、Call Homeに参加するかどうかを尋ねられます。3つのオプションがあります。
Controllerをインストールする際、そのサーバーに「サービスとしてログオン」ポリシー設定が適用されたActive Directory GPOがある場合、インストールウィザードのCall Homeページで情報を構成することはできません。詳細については、CTX218094を参照してください。
Controllerをアップグレードしていて、以前にCall Homeに登録していた場合、参加について尋ねられることはありません。

PowerShellコマンドレット

PowerShellヘルプには、これらの一般的なユースケースでは使用されないコマンドレットとパラメーターの説明を含む、包括的な構文が記載されています。
アップロードにプロキシサーバーを使用するには、「プロキシサーバーの構成」を参照してください。
  • スケジュールされたアップロードを有効にする: 診断コレクションはCitrixに自動的にアップロードされます。カスタムスケジュール用の追加のコマンドレットを入力しない場合、デフォルトのスケジュールが使用されます。
    $cred = Get-Credential
    Enable-CitrixCallHome -Credential $cred
    スケジュールされたアップロードが有効になっていることを確認するには、Get-CitrixCallHomeと入力します。有効になっている場合、戻り値はIsEnabled=TrueとIsMasterImage=Falseです。
  • マスターイメージから作成されたマシンに対するスケジュールされたアップロードを有効にする: マスターイメージでスケジュールされたアップロードを有効にすると、マシンカタログで作成される各マシンを構成する必要がなくなります。
    Enable-CitrixCallHome -Credential $cred -MasterImage
    スケジュールされたアップロードが有効になっていることを確認するには、Get-CitrixCallHome と入力します。有効になっている場合、戻り値は IsEnabled=True および IsMasterImage=True です。
  • カスタムスケジュールを作成する: 診断コレクションとアップロードの毎日または毎週のスケジュールを作成します。
    $timespan = New-TimeSpan –Hours hours -Minutes minutes
    Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek day -UploadFrequency {Daily|Weekly}
例:
次のコマンドレットは、毎晩22:20にデータをバンドルしてアップロードするスケジュールを作成します。Hoursパラメーターは24時間形式を使用します。UploadFrequencyパラメーターの値がDailyの場合、DayOfWeekパラメーターは指定されていても無視されます。
$timespan – New-TimeSpan –Hours 22 –Minutes 20
Set-CitrixCallHomeSchedule –TimeOfDay $timespan -UploadFrequency Daily
スケジュールを確認するには、Get-CitrixCallHomeScheduleと入力します。上記の例では、StartTime=22:20:00, DayOfWeek=Sunday (ignored), Upload Frequency=Dailyが返されます。
次のコマンドレットは、毎週水曜日の夜10時20分にデータをバンドルしてアップロードするスケジュールを作成します。
$timespan – New-TimeSpan –Hours 22 –Minutes 20
Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek Wed -UploadFrequency Weekly
スケジュールを確認するには、Get-CitrixCallHomeScheduleと入力します。上記の例では、StartTime=22:20:00, DayOfWeek=Wednesday, Upload Frequency=Weeklyが返されます。

Call Homeを無効にする

PowerShellコマンドレットを使用するか、Citrix Scoutを介してCall Homeを無効にできます。
Call Homeのスケジュールされたアップロードが無効になっている場合でも、AOTログは収集され、ディスクに保存されます。(スケジュールされたアップロードが無効になっている場合、AOTログはCitrixに自動的にアップロードされません。) AOTログの収集とローカルストレージを無効にすることができます。

PowerShellでCall Homeを無効にする

次のコマンドレットを実行すると、診断データはCitrixに自動的にアップロードされません。(Citrix ScoutまたはテレメトリPowerShellコマンドレットを使用して診断データをアップロードすることは引き続き可能です。)
Disable-CitrixCallHome
Call Homeが無効になっていることを確認するには、Get-CitrixCallHome と入力します。無効になっている場合、戻り値は IsEnabled=False および IsMasterImage=False です。

Citrix Scoutを使用して収集スケジュールを無効にする

Citrix Scout を使用して診断収集スケジュールを無効にするには、スケジュール収集 のガイダンスに従ってください。ステップ 3 で、オフ をクリックして、選択したマシンのスケジュールをキャンセルします。

AOTログの収集を無効にする

次のコマンドレットを実行すると(Enabledフィールドをfalseに設定すると)、AOTログは収集されなくなります。
Enable-CitrixTrace -Listen'{"trace":{"enabled":false,"persistDirectory":"C:\Users\Public","maxSizeBytes":1000000, "sliceDurationSeconds":300}}'
Listenパラメーターには、JSON形式の引数が含まれています。

Call Homeアップロード用のプロキシサーバーを構成する

Call Home が有効になっているマシンで、次のタスクを完了します。以下の手順の例の図には、サーバーアドレスとポート 10.158.139.37:3128 が含まれています。お使いの情報とは異なります。
  1. ブラウザにプロキシサーバー情報を追加します。Internet Explorer で、インターネットオプション \> 接続 \> LAN の設定 を選択します。「LAN にプロキシサーバーを使用する」を選択し、プロキシサーバーのアドレスとポート番号を入力します。
  2. PowerShell で netsh winhttp import proxy source=ie を実行します。
    プロキシサーバー構成時に netsh コマンドを実行する例
  3. テキストエディターを使用して、C:\\Program Files\\Citrix\\Telemetry Service にある TelemetryService.exe 構成ファイルを編集します。赤いボックスに示されている情報を追加します。
    TelemetryService.exe ファイルにプロキシ情報を追加(/en-us/citrix-virtual-apps-desktops/2511/media/call-home-proxy-config.png)
  4. テレメトリサービスを再起動します。
PowerShell で Call Home コマンドレットを実行します。

診断情報を手動で収集してアップロードする

CISウェブサイトを使用して、診断情報バンドルをCISにアップロードできます。PowerShellコマンドレットを使用して、診断情報を収集し、CISにアップロードすることもできます。
CISウェブサイトを使用してバンドルをアップロードするには:
  1. Citrixアカウントの資格情報を使用して、Citrix Insight Servicesにログオンします。
  2. を選択します。
  3. を選択し、データの場所に移動します。
CISは、データアップロードを管理するいくつかのPowerShellコマンドレットをサポートしています。このドキュメントでは、2つの一般的なケースのコマンドレットについて説明します。
  • Start-CitrixCallHomeUploadコマンドレットを使用して、診断情報バンドルを手動で収集し、CISにアップロードします。(バンドルはローカルに保存されません。)
  • Start-CitrixCallHomeUploadコマンドレットを使用して、データを手動で収集し、診断情報バンドルをローカルに保存します。これにより、データをプレビューできます。後で、Send-CitrixCallHomeBundleコマンドレットを使用して、そのバンドルのコピーを手動でCISにアップロードします。(最初に保存したデータはローカルに残ります。)
PowerShellヘルプには、これらの一般的なユースケースでは使用されないコマンドレットとパラメーターの説明を含め、包括的な構文が記載されています。
CISにデータをアップロードするコマンドレットを入力すると、アップロードの確認を求められます。アップロードが完了する前にコマンドレットがタイムアウトした場合は、システムイベントログでアップロードのステータスを確認してください。サービスがすでにアップロードを実行している場合、アップロード要求は拒否される可能性があります。
データを収集し、バンドルをCISにアップロードする:
Start-CitrixCallHomeUpload [-Credential] PSCredential [-InputPath string] [-Description string] [-IncidentTime string] [-SRNumber string] [-Name string] [-UploadHeader string] [-AppendHeaders string] [-Collect string] [<CommonParameters>]
データを収集し、ローカルに保存する:
Start-CitrixCallHomeUpload -OutputPath <String> [-InputPath string] [-Description string] [-IncidentTime string] [-SRNumber string] [-Name string] [-UploaderHeader string] [-AppendHeaders string] [-Collect strings] [<CommonParameters>]
次のパラメーターが有効です:
  • Credential: CISへのアップロードを指示します。
  • InputPath: バンドルに含めるzipファイルの場所。これは、Citrixサポートが要求する追加ファイルである可能性があります。.zip拡張子を含めるようにしてください。
  • OutputPath: 診断情報が保存される場所。このパラメーターは、Call Homeデータをローカルに保存する場合に必須です。
  • Description and Incident Time: アップロードに関する自由形式の情報。
  • SRNumber: Citrixテクニカルサポートのインシデント番号。
  • Name: バンドルを識別する名前。
  • UploadHeader: CISにアップロードされるアップロードヘッダーを指定するJSON形式の文字列。
  • AppendHeaders: CISにアップロードされる追加ヘッダーを指定するJSON形式の文字列。
  • Collect: 収集または除外するデータを指定するJSON形式の文字列。形式は{'collector':{'enabled':Boolean}}で、Booleanはtrueまたはfalseです。 有効なコレクター値は次のとおりです。
    • WMI
    • プロセス
    • レジストリ
    • クラッシュレポート
    • トレース
    • ファイル
    • MSI
    • ローカルデータ
    • 'サイトデータ'
    • 'SFB'
    デフォルトでは、「sfb」を除くすべてのコレクターが有効になっています。
    「sfb」コレクターは、Skype for Businessの問題を診断するためにオンデマンドで使用されるように設計されています。「enabled」パラメーターに加えて、「sfb」コレクターはターゲットユーザーを指定するための「account」および「accounts」パラメーターをサポートしています。次のいずれかの形式を使用します。
    • "-コレクト "{'sfb':{'account':'domain\\\user1'}}"
    • "-コレクト "{'sfb':{'accounts':}}"
  • 共通パラメーター: PowerShellのヘルプを参照してください。
以前にローカルに保存されたデータをアップロードする:
Send-CitrixCallHomeBundle -Credential <PSCredentia\> -Path string [<CommonParameters>]
Path パラメーターは、以前に保存されたバンドルの場所を指定します。
例:
次のコマンドレットは、Call Homeデータ（WMIコレクターからのデータを除く）をCISにアップロードするよう要求します。このデータは、Citrix Provisioning VDAの登録失敗に関連しており、Citrixサポートケース123456について午後2時30分に記録されました。Call Homeデータに加えて、ファイル「c:\\Diagnostics\\ExtraData.zip」がアップロードされたバンドルに組み込まれます。
C:\PS\>Start-CitrixCallHomeUpload -InputPath "c:\Diagnostics\ExtraData.zip" -Description "Registration failures with Citrix Provisioning VDAs" -IncidentTime "14:30" -SRNumber 123456 -Name "RegistrationFailure-021812016" -Collect "{'wmi':{'enabled':false}}" -UploadHeader "{'key1':'value1'}" -AppendHeaders "{'key2':'value2'}"
次のコマンドレットは、午前8時15分に記録されたCitrixサポートケース223344に関連するCall Homeデータを保存します。データはネットワーク共有上のファイルmydata.zipに保存されます。Call Homeデータに加えて、ファイル「c:\\Diagnostics\\ExtraData.zip」が保存されたバンドルに組み込まれます。
C:\PS\>Start-CitrixCallHomeUpload -OutputPath \\mynetwork\myshare\mydata.zip -InputPath "c:\Diagnostics\ExtraData.zip" -Description "Diagnostics for incident number 223344" -IncidentTime "8:15" -SRNumber 223344
以下のコマンドレットは、以前に保存したデータバンドルをアップロードします。
$cred=Get-Credential
C:\PS>Send-CitrixCallHomeBundle –Credential $cred -Path \\mynetwork\myshare\mydata.zip