シトリックス バーチャルアプリおよびデスクトップ™ データソース

最終公開日 : Nov 04, 2026
この記事では、StoreFront を使用してオンプレミスの Citrix Virtual Apps and Desktops サイトを Citrix Analytics に接続する手順について説明します。この記事で説明するオンボーディング手順は、Citrix Analytics for Performance (Performance Analytics) と Citrix Analytics for Security (Security Analytics) の両方のサービスに適用されます。
各サービスに固有のオンボーディング手順については、以下の記事を参照してください。
Related information
データソース

StoreFront を使用して Citrix Virtual Apps and Desktops オンプレミスサイトをオンボーディングする

組織がオンプレミスの StoreFront™ 展開を使用している場合、Citrix Workspace™ アプリがイベントを Citrix Analytics に送信できるように、StoreFront サーバーを構成する必要があります。Citrix Analytics はイベントを処理し、Citrix IT インフラストラクチャのパフォーマンスとユーザーの行動に関する実用的なインサイトを提供します。
Citrix Analytics 用の StoreFront 展開の構成方法の詳細については、StoreFront ドキュメントの Citrix Analytics サービス の記事を参照してください。
以前は、Citrix Apps and Desktops オンプレミスサイトを使用しているお客様は、Citrix Analytics for Security™ および Performance のオンプレミスサイトをオンボーディングするためにサイト集約の使用を強制されていました。
サイト集約に依存せずに、Citrix Apps and Desktops オンプレミスサイトをオンボーディングできるようになりました。
サイト集約にサイトが追加されていなくても、ワークスペースアプリケーションに Connect Storefront Deployment オプションが表示されます。
StoreFront 展開を接続

前提条件

開始する前に、以下を確認してください。
  • StoreFront のバージョンは 1906 以降である必要があります。
  • StoreFront展開は、次のアドレスに接続できる必要があります。
    • <https://*.cloud.com>
    • <https://api.analytics.cloud.com>
  • StoreFront展開では、アウトバウンドインターネット接続用にポート443を開放する必要があります。ネットワーク上のプロキシサーバーは、Citrix Analyticsとのこの通信を許可する必要があります。
  • StoreFront展開が、Webプロキシを使用してインターネットに接続するWebサーバーでホストされている場合、各ストアのプロキシは、アウトバウンドトラフィックを許可するように手動で構成する必要があります。StoreFrontは、ホストWebサーバーのプロキシ設定を自動的に使用しません。詳細については、HTTPプロキシを使用するWebサーバーでホストされているStoreFront展開を構成するを参照してください。
  • StoreFront展開は、次のいずれかのクライアントを使用してアクセスする必要があります。
    • HTML5互換ブラウザのWebサイト用Citrix Receiver™。
      注
      HTML5ユーザーの場合、StoreFrontで特定の構成が有効になっていると、Citrix Virtual Apps and Desktopsはイベントを起動できます。構成手順については、Citrix Workspace app for HTML5ドキュメントのインストールの記事を参照してください。印刷関連のイベントについては、StoreFrontで追加のポリシーを構成する必要があります。詳細については、Citrix Workspace app for HTML5ドキュメントのPDF印刷の記事を参照してください。
    • Windows用Citrix Workspaceアプリ1907以降。
    • Linux用Citrix Workspaceアプリ2006以降。
    • Mac用Citrix Workspaceアプリ2006以降
  • Citrix Virtual Apps and Desktops 7 1912 LTSRを使用している場合、サポートされるStoreFrontバージョンは1912です。

StoreFront展開に接続する

StoreFront展開には、次の方法で接続できます。
  • Apps and Desktops – Workspace appサイトカードとApps and Desktops – Monitoringサイトカードを使用する
  • Recommendationsパネルを使用する

Apps and Desktops – Workspace appサイトカードとApps and Desktops – Monitoringサイトカードを使用して接続する

  1. Settings > Data Sources > Securityに移動します。Apps and Desktops- Workspace appサイトカードで、縦の省略記号 (⋮) をクリックし、Connect StoreFront deploymentを選択します。
    ストアセキュリティを接続(/en-us/citrix-analytics/media/store-front-site-card-1.png)
  2. Settings > Data Sources > Performanceに移動します。Apps and Desktops- Monitoringサイトカードで、縦の省略記号 (⋮) をクリックし、Connect StoreFront deploymentを選択します。
    ストアパフォーマンスを接続(/en-us/citrix-analytics/media/cvad-performance-sf-connect.png)
    StoreFrontオンボーディングウィザードまたはConnect StoreFront Deploymentポップアップが表示されます。
  3. Download packageをクリックします。
    StoreFrontオンボーディングウィザード(/en-us/citrix-analytics/media/sf-onboarding-wizard.png)
    注
    このファイルには機密情報が含まれています。ファイルを安全な場所に保管してください。
  4. StoreFront展開を構成するには、,
    1. インストールパッケージをStoreFrontサーバーにコピーします。
    2. コピーしたファイルを解凍し、PowerShell内でそのフォルダーに移動します。
    3. StoreFrontをオンボードするには、管理者として次のコマンドを実行する必要があります。
      .\Manage-CitrixAnalytics.ps1 –param OnboardStorefront
      StoreFront管理者モード(/en-us/citrix-analytics/media/sf-admin-mode.png)
      その他のオプションまたはパラメーターについては、「PowerShellスクリプト」セクションを参照してください。
    4. StoreFrontサーバーを開き、PowerShellスクリプトを実行します。
    5. OnboardStorefrontを実行してもCitrix Analytics Service GUIにStoreFrontサイトが表示されない場合は、iisresetコマンドを実行します。
    6. Citrix Analytics Service GUIにログインし、Cluster IDがスクリプトによってコンソールに記録されたものと一致するかどうかを検証します。
    7. 設定が完了したら、Citrix Analyticsにログインして、接続されているStoreFront展開を表示します。
  5. 設定が正常に完了したら、完了をクリックします。
  6. Citrix Analyticsがデータを処理できるように、データ処理を有効にするをクリックします。

PowerShellスクリプト

Citrix Analytics ServiceへのStoreFrontのオンボーディングプロセスを簡素化するために、新しいPowerShellスクリプトが導入されました。このPowerShellスクリプトは、前提条件の確認、StoreFrontのインストール、および構成のプロセスを自動化します。PowerShellスクリプトは管理者モードで実行する必要があります。
StoreFront管理者モード(/en-us/citrix-analytics/media/sf-admin-mode.png)
お客様は、このPowerShellスクリプトをStoreFrontで実行して、オンボード、デボード、セルフチェックの実行、トラブルシューティングを行い、Citrix Analytics Service GUIへのオンボーディングが成功したかどうかを確認できます。お客様がスクリプトを初めて実行すると、発行元を確認するためのセキュリティ警告メッセージが表示されます。発行元が信頼できる場合は、オプションを選択します。
PowerShellスクリプトは常に実行されます(/en-us/citrix-analytics/media/powershell-script-always-run.png)
PowerShellスクリプトは、StoreFrontConfiguration.jsonファイル、いくつかのCCAuth、およびdllファイルとともに、zipファイル内のConnect StoreFront Deploymentページで入手できます。PowerShellスクリプトのログは、Downloadsフォルダーのcas-logsファイルに保存されます。
PowerShellスクリプトは、次のパラメーターをサポートしています。
  • SelfCheck: SelfCheckパラメーターは、StoreFrontのオンボーディングの前提条件が満たされていることを検証するために使用されます。StoreFrontのインストール、必要なバージョン、アウトバウンド接続、cURL Analyticsサーバーのネットワーク接続、インターネット接続、サーバーグループ構成、および既存のCitrix Analytics Service構成をチェックします。selfcheckを実行するには、次のコマンドを使用します。
    .\Manage-CitrixAnalytics.ps1 –param SelfCheck
  • OnboardStorefront: OnboardStoreFrontパラメーターは、Citrix Analytics Service構成のセットアップ準備状況を検証するために、セルフチェックを迅速に実行します。セットアップの準備ができていれば、Citrix Analytics Service構成をインポートし、変更をサーバーグループ内の他のサーバーに公開します。サーバーグループの場合、PublishConfigurationコマンドはスクリプトから自動的に実行され、StoreFront構成をそのStoreFront内のすべてのサーバーに公開します。PublishConfigurationアクションを確認するためのポップアップが表示されます。Yes to Allボタンを選択します。
    構成の公開が正常に完了すると、スクリプトはCitrix Analytics Service APIを呼び出し、StoreFrontがCitrix Analytics Service GUIにオンボーディングされているかどうかを確認します。このAPIを呼び出すには、認証のために秘密キーが必要です。この秘密キーを生成するには、CCAuthおよびdllファイルと、ダウンロードしたJSONファイルで利用可能な資格情報が必要です。
    注
    StoreFrontのオンボーディングプロセスが完了すると、StoreFrontがCitrix Analytics Service GUIに表示されるまでに2〜5分かかる場合があります。StoreFrontサイトがCitrix Analytics Service GUIに表示されない場合は、インターネットインフォメーションサービスをリセットするためにIISRESETを実行する必要があります。
    OnboardStoreFrontを実行するには、次のコマンドを使用します。
    .\Manage-CitrixAnalytics.ps1 –param OnboardStorefront
  • IsOnboarded: IsOnboardedパラメーターは、StoreFrontがCitrix Analytics Service GUIにオンボーディングされているかどうかを確認するために使用されます。スクリプトは終了する前に1分間待機しますが、StoreFrontが正常にオンボーディングされた後、GUIに表示されるまでに最大5分かかる場合があります。これを検証するには、このコマンドを実行する必要があります。このコマンドには、CCAuthおよびdllファイルの依存関係もあります。IsOnboardedを実行するには、次のコマンドを使用します。
    .\Manage-CitrixAnalytics.ps1 –param IsOnboarded
  • Troubleshoot: 5分間待ってもStoreFrontサイトがCitrix Analytics Service GUIに表示されない場合は、インターネットインフォメーションサービスをリセットするためにIISRESETを実行する必要があります。それでもStoreFrontサイトがGUIに表示されない場合は、Troubleshootパラメーターを使用します。これは、接続の問題をトラブルシューティングし、ログを収集するのに役立ちます。Troubleshootを実行するには、次のコマンドを使用します。
    .\Manage-CitrixAnalytics.ps1 –param TroubleShoot
    トラブルシューティングパラメータは、以下の2つのユースケースに役立ちます。
    • ユースケース1: セルフチェックの一環としてcurlAnalyticsが失敗した場合、ファイアウォールルールが作成されます。このファイアウォールルールは443ポートを開放し、Analyticsへの接続性を検証します。接続できない場合、Analyticsサーバーに到達できないことを意味し、スクリプトはここで終了します。Citrix Analytics Serviceへの接続が復元されたら、スクリプトを再実行してください。
    • ユースケース2: cURLが正常に実行されたにもかかわらず、StoreFrontサイトがGUIに反映されない場合、管理者はDownload DebugViewからDebugViewツールzipファイルをダウンロードし、解凍してDownloadsフォルダーに配置する必要があります。PowerShellスクリプトは、Citrix Analytics Serviceがすでに構成されている場合、まずそれをアンインストールします。詳細ログを有効にします。その後、DebugViewツールを起動し、Citrix Analytics Serviceを再インストールします。最後に、DebugViewを停止し、詳細ログを無効にします。
    デバッグビューログは取得し、Citrixサポートと共有できます。Citrix管理者はさらにデバッグを行い、問題を発見して解決を試みます。ログはDebugViewフォルダー内にログファイルとして生成され、保存されます。
    Citrix管理者と以下の3つのログファイルを共有する必要があります。
    • DebugViewログファイル (Downloads\DebugView\log)
    • StoreFrontログファイル (C:\Program Files\Citrix\Receiver StoreFront\Admin\trace)
    • CASログファイル。これらのログはスクリプトの実行の一部として生成され、Downloads > cas-logsフォルダーに保存されます。
    サーバーグループの場合、スクリプトがStoreFrontのデボードまたはオンボードを試行する際に、PublishConfigurationコマンドが自動的に実行されます。PublishConfigurationコマンドは、StoreFront構成をそのStoreFront内のすべてのサーバーに公開するのに役立ちます。このアクションを確認するためのポップアップが表示されます。すべてはいボタンを選択します。
    PowerShellスクリプトのすべてはい
  • DeboardStoreFront: DeboardStoreFrontパラメータは、Citrix Analytics ServiceからStoreFrontサーバーをデボードするために使用されます。DeboardStoreFrontを実行するには、次のコマンドを使用します。
    .\Manage-CitrixAnalytics.ps1 –param DeboardStoreFront
    PowerShellスクリプトは、まずStoreFrontからすべてのCitrix Analytics Service構成を削除し、削除が成功したことを確認します。次に、ServerGroupが存在するかどうかを確認し、存在する場合は構成を公開して、削除された構成がすべてのStoreFrontに公開されるようにします。最後に、DeleteSiteOnboardedを呼び出します。サイトがCitrix Analytics Service GUIから削除されない場合は、StoreFront DeploymentでStoreFrontサイトを、およびStoreFront Deploymentの下にあるWorkspace Applicationサイトカードから手動で削除する必要があります。
    サーバーグループの場合、PublishConfigurationコマンドはスクリプトから自動的に実行され、StoreFront構成をそのStoreFront内のすべてのサーバーに公開します。このアクションを確認するためのポップアップが表示されます。すべてはいボタンを選択します。
    PowerShellスクリプトのすべてはい

「推奨事項」パネルを使用して接続

データソースページの推奨事項パネルは、データソースのオンボーディングの重要性についてユーザーに情報を提供します。これにより、ユーザーはデータソースを簡単にオンボーディングでき、また、利用可能なすべてのデータソースをオンボーディングしたことを確認および保証するためのオプションも提供されます。
  1. Security Analytics製品を使用している場合は、設定 > データソース > セキュリティを選択します。
  2. Performance Analytics製品を使用している場合は、設定 > データソース > パフォーマンスに移動します。
  3. データソースページで、StoreFront展開をオンボーディングするための推奨事項パネルの情報と推奨事項を確認します。
    推奨事項パネルを確認する(/en-us/citrix-analytics/media/review-recommedations-panel.png)
    注
    StoreFrontデータソースをオンボーディングすると、Workspaceアプリはエンドポイントの可視性に関するテレメトリデータをAnalyticsに送信できるようになります。
  4. オンボーディングを開始をクリックします。展開されたStoreFrontインスタンスの指定ページが表示されます。
    StoreFrontインスタンスを指定する(/en-us/citrix-analytics/media/specify-sf-instances.png)
  5. Analyticsがデータソースを正常にオンボーディングできるように、展開されたStoreFrontインスタンスの総数を指定します。
    注:
    展開されたStoreFrontインスタンスの総数は、StoreFrontグループの総数であり、個々のStoreFrontサーバーの数ではありません。
  6. 続行をクリックします。StoreFrontオンボーディングウィザードまたはStoreFront展開の接続ポップアップが表示されます。
  7. StoreFront展開の接続ページで、をクリックしてインストールパッケージをダウンロードします。
    StoreFrontオンボーディングウィザード
    注
    このファイルには機密情報が含まれています。ファイルを安全な場所に保管してください。
    1つのパッケージをダウンロードし、それを使用して1つのStoreFrontグループのみをオンボードできます。複数のStoreFrontグループがある場合は、各StoreFrontグループ用に個別にパッケージをダウンロードする必要があります。1つのパッケージを使用して1つのStoreFrontグループのオンボーディングが完了したら、パッケージを再度ダウンロードし、次のStoreFrontグループのオンボーディングを続行してください。
    何らかの問題により、1つのパッケージを使用してStoreFrontのオンボーディングが2日以内に正常に完了しなかった場合、2日後に新しいパッケージを再ダウンロードする必要があります。パッケージ内のキーは、2日以内に正常にオンボードされないと期限切れになるためです。
  8. StoreFront展開を構成するには、,
    1. インストールパッケージをStoreFrontサーバーにコピーします。
    2. コピーしたファイルを解凍し、PowerShell内でそのフォルダーに移動します。
    3. StoreFrontをオンボードするには、次のコマンドを実行します。
      .\Manage-CitrixAnalytics.ps1 –param OnboardStorefront
    4. StoreFrontサーバーを開き、PowerShellスクリプトを実行します。
    5. StoreFrontサイトがCitrix Analytics Service GUIに表示されない場合は、次のコマンドを実行します。
      Execute iisreset
    6. PowerShellスクリプトで利用可能なクラスターIDをログに記録し、確認します。
    7. 構成が完了したら、Citrix Analyticsにログインして、接続されたStoreFront展開を表示します。
  9. 設定が成功したら、完了をクリックします。
推奨事項パネルからオンボーディングする場合、システムはCitrix AnalyticsサービスにオンボーディングしたStoreFront展開の数を取得します。推奨事項パネルが表示され、オンボーディングされたStoreFront展開を確認できます。推奨事項パネルのメッセージを確認し、完了としてマークをクリックできます。
注
推奨事項パネルとメッセージは、宣言されたすべてのStoreFront展開がオンボーディングされた場合にのみ消えます。
  1. Citrix Analyticsがデータを処理できるように、データ処理をオンにするをクリックします。

推奨事項パネルを確認する

推奨事項パネルで、宣言されたStoreFront展開の数とオンボーディングされたStoreFront展開の数を比較できます。
宣言されたStoreFront展開の数がオンボーディングされたStoreFront展開の数と同じ場合、すべてのStoreFront展開がオンボーディングされたことを示すすべてオンボーディング済みメッセージが表示されます。推奨事項パネルのメッセージを確認し、完了としてマークをクリックできます。
注
さらにStoreFront展開をオンボーディングしたい場合は、オンボーディング手順を表示をクリックすると、StoreFrontオンボーディングウィザードまたはStoreFront展開を接続ポップアップが再度表示されます。
オンボーディングされたStoreFrontインスタンスを確認する(/en-us/citrix-analytics/media/review-onboarded-sf-instances.png)
宣言されたStoreFront展開の数がオンボーディングされたStoreFront展開の数より少ない場合は、カウントを編集をクリックすると、展開されたStoreFrontインスタンスを指定ページが表示されます。その後、展開されたStoreFrontインスタンスの合計数を入力し、続行をクリックします。StoreFrontオンボーディングウィザードまたはStoreFront展開を接続ポップアップが再度表示されます。さらにStoreFront展開をオンボーディングするには、手順に従ってください。
注:
展開されたStoreFrontインスタンスの合計数は、StoreFrontグループの合計数であり、個々のStoreFrontサーバーの数ではありません。
StoreFrontオンボーディングを完了する(/en-us/citrix-analytics/media/complete-storefront-onboarding.png)

接続されているStoreFront展開を表示

StoreFront展開は、構成が成功した場合にのみサイトカードに表示されます。サイトカードには、Citrix Analyticsと接続を確立したStoreFront展開の数が表示されます。
  • Performance Analyticsサービスを使用している場合、Apps and Desktops- Monitoringサイトカードに次の情報が表示されます。
    Performance Analytics ストアの表示
  • Security Analyticsサービスを使用している場合、Workspace appサイトカードに次の情報が表示されます。
    ストアの表示
サイトカード上のStoreFront展開の数をクリックして、サーバーグループを表示します。
各StoreFront展開は、ベースURLとServerGroupIDによって表されます。
StoreFrontグループ
Security Analyticsサービスを使用している場合、サイトカードには受信したイベントに関する次の情報も表示されます。
  • StoreFront展開から過去1時間に受信したイベント（デフォルトの時間選択）。1週間（1 W）を選択してデータを表示することもできます。受信したイベントの数をクリックすると、セルフサービス検索ページでイベントを表示できます。
    Security Analytics 受信イベント
  • データ処理を有効にした後、サイトカードにデータが受信されていませんというステータスが表示される場合があります。このステータスが表示される理由は2つあります。
    1. 初めてデータ処理を有効にした場合、イベントがCitrix Analyticsのイベントハブに到達するまでに時間がかかります。Citrix Analyticsがイベントを受信すると、ステータスはデータ処理中に変わります。しばらくしてもステータスが変わらない場合は、データソースページを更新してください。
    2. Citrix Analyticsは、過去1時間、データソースからイベントを受信していません。
      仮想データアプリなし

StoreFront展開の追加または削除

StoreFront展開を追加するには、StoreFront展開セクションでStoreFront展開に接続をクリックします。構成ファイルをダウンロードし、手順に従ってStoreFront展開を構成します。
ストアの追加
構成済みのStoreFront展開からのイベント送信を停止し、Citrix Analyticsから削除するには：
  1. Citrix Analyticsから削除したいStoreFront展開に移動します。StoreFrontサーバーから構成設定を削除するには、次のコマンドを実行します。
    Remove-STFCasConfiguration
  2. マルチサーバー展開を使用している場合は、変更を伝播し、StoreFrontサーバーグループ内のすべてのサーバーから構成設定を削除するために、次のコマンドを実行します。
    Publish-STFServerGroupConfiguration
  3. 構成設定が正常に削除されたことを確認するには、次のコマンドを実行します。設定が正常に削除された場合、コマンドは何も返しません。
    Get-STFCasConfiguration
  4. Citrix Analyticsに再度ログインし、StoreFront展開セクションでStoreFront展開を選択します。縦の省略記号 (⋮) をクリックし、AnalyticsからStoreFront展開を削除を選択します。
    ストアの削除
    注
    Citrix Analyticsから削除する前に、StoreFront展開で指定されたコマンドを実行してください。コマンドの実行に失敗すると、Citrix Analyticsは引き続きイベントを受信し、次のイベントポーリングサイクルでStoreFront展開が再度追加されます。

HTTPプロキシを使用するWebサーバーでホストされているStoreFront展開を構成する

StoreFrontがインターネットに接続するためにWebプロキシを使用するWebサーバーでホストされている場合、ストアをCitrix Analyticsに登録するには手動で構成する必要があります。この構成では、ストアのweb.configファイルに<system.net>セクションを追加する必要があります。Citrix Analyticsにイベントを送信するStoreFront展開上のすべてのストアを構成する必要があります。
ストアのweb.configファイルに<system.net>セクションを追加する方法は2つあります。
  • 1つまたは複数のストアに対して、PowerShell を介してストアプロキシ構成を設定します (推奨される方法)。
  • ストアの web.config ファイルに <system.net> セクションを手動で追加します。
これらの方法の詳細については、StoreFront ドキュメントの「Web プロキシを使用して Citrix Cloud に接続し、Citrix Analytics に登録するように StoreFront を構成する」記事を参照してください。