シトリックス スカウト

はじめに

Citrix Scoutは診断情報を収集し、ヘルスチェックを実行します。その結果を使用して、Citrix Virtual Apps and Desktops™展開を維持できます。Citrixは、Citrix Insight Servicesを通じて、診断情報収集の包括的で自動化された分析を提供します。また、Scoutを使用して、単独で、またはCitrixサポートのガイダンスを受けて問題をトラブルシューティングすることもできます。

収集ファイルをCitrixにアップロードして、Citrixサポートからの分析とガイダンスを受けることができます。または、収集したデータをローカルに保存して自分で確認し、後でその収集ファイルをCitrixにアップロードして分析することもできます。

Scoutは次の手順を提供します。

• 収集: サイトで選択したマシンに対して、1回限りの診断情報収集を実行します。その後、ファイルをCitrixにアップロードするか、ローカルに保存できます。
• トレースと再現: 選択したマシンで手動トレースを開始します。その後、それらのマシンで問題を再現します。問題を再現した後、トレースは停止されます。その後、Scoutは他の診断情報を収集し、ファイルをCitrixにアップロードするか、ローカルに保存します。
• スケジュール: 選択したマシンで、指定した時間に毎日または毎週診断情報収集が実行されるようにスケジュールします。ファイルは自動的にCitrixにアップロードされます。
• ヘルスチェック: サイトとそのコンポーネントの正常性と可用性を測定するチェックを実行します。Delivery Controller、Virtual Delivery Agent（VDA）、StoreFront™サーバー、およびCitrix License Serverのヘルスチェックを実行できます。チェック中に問題が見つかった場合、Scoutは詳細なレポートを提供します。Scoutが起動するたびに、更新されたヘルスチェックスクリプトを確認します。新しいバージョンが利用可能な場合、Scoutはそれらを自動的にダウンロードし、次回のヘルスチェック実行時に使用します。

注：

トレースと再現、スケジュール、およびヘルスチェックの手順は現在、Linux VDAでは利用できません。

この記事で説明されているグラフィカルインターフェイスは、Scoutを使用する主要な方法です。または、PowerShellを使用して、1回限りの診断情報収集またはスケジュールされた診断情報収集とアップロードを構成することもできます。「Call Home」を参照してください。

Scoutの実行場所：

• オンプレミス展開では、Delivery Controller™ から Scout を実行して、1つ以上の仮想デリバリーエージェント (VDA)、デリバリーコントローラー、StoreFrontサーバー、フェデレーテッド認証サービス (FAS) サーバー、およびライセンスサーバーで診断情報を取得したり、チェックを実行したりできます。また、VDA から Scout を実行して、ローカル診断情報を収集することもできます。

  注：

  現在、FAS構成の問題を診断するためのヘルスチェックは、FASサーバー上のScoutではサポートされていません。

• シトリックスDaaS（旧シトリックスバーチャルアップス™アンドデスクトップスサービス）を使用するシトリックスクラウド環境で、ローカル診断を収集するためにVDAからスカウトを実行します。

ScoutアプリケーションのログはC:\ProgramData\Citrix\TelemetryService\ScoutUI.logに保存されます。このファイルはトラブルシューティングに使用できます。

収集されるもの

Scoutによって収集される診断には、Citrix Diagnostic Facility (CDF) トレースログファイルが含まれます。Always-on Tracing (AOT) と呼ばれるCDFトレースのサブセットも含まれています。AOT情報は、VDA登録やアプリケーション/デスクトップの起動などの一般的な問題のトラブルシューティングに役立ちます。その他のEvent Tracing for Windows (ETW) 情報は収集されません。

収集されるものには以下が含まれます。

• HKEY_LOCAL_MACHINE\SOFTWARE\Citrixの下にCitrix Virtual Apps and Desktopsによって作成されたレジストリエントリ。
• シトリックス名前空間の下にあるWindows 管理インストゥルメンテーション (WMI) 情報。
• 実行中のプロセス。
• %PROGRAMDATA%\Citrix\CDFに保存されているCitrixプロセスのクラッシュダンプ。
• CSV形式のCitrixポリシー情報。
• インストールおよびアップグレード情報。収集には、製品の完全なメタインストーラーログ、失敗したMSIログ、MSIログアナライザーからの出力、StoreFrontログ、ライセンス互換性チェックログ、および予備的なサイトアップグレードテストの結果が含まれる場合があります。

トレース情報について：

• トレース情報は収集時に圧縮され、マシン上のフットプリントを小さく保ちます。
• 各マシンで、Citrix Telemetry Serviceは圧縮された最新のトレース情報を最大8日間保持します。
• Citrix Virtual Apps and Desktops 7 1808以降、AOTトレースはデフォルトでローカルディスクに保存されます。（以前のバージョンでは、トレースはメモリに保持されていました。）デフォルトパス = C:\Users\CitrixTelemetryService\AppData\Local\CitrixAOT。
• Citrix Virtual Apps and Desktops 7 1811以降、ネットワーク共有に保存されたAOTトレースは、他の診断情報とともに収集されます。
• Enable-CitrixTraceコマンドレットまたはHKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Telemetry DefaultListenレジストリ文字列を使用して、最大サイズ（デフォルト = 10 MB）とスライス期間を変更できます。
• トレースは、ファイルがMaxSizeの10%に達するまでファイルに追加されます。

Scoutが収集するデータポイントのリストについては、Call Homeの主要データポイントを参照してください。

スカウトの構成

ScoutはLinux VDAで動作するように構成できます。Linux VDAとテレメトリの詳細については、Citrix Telemetry Serviceとの統合を参照してください。

Linux VDAは、ctxtelemetryソケットポートまたはテレメトリサービスのポートを自動的に変更する場合があります。その場合は、ポートを手動で構成する必要があります。

1. C:\Program Files\Citrix\テレメトリーサービス に移動します
2. ScoutUI.exe.config という名前のファイルを開きます。
3. Change the value for LinuxVDATelemetryServicePort or LinuxVDATelemetryWakeupPort to what was configured on the Linux VDA:

• <add key="LinuxVDATelemetryServicePort" value="7502"/>
• <add key="LinuxVDATelemetryWakeupPort" value="7503"/>

1. 変更を保存してファイルを閉じます。
2. Scoutを再度開いて、最新の構成が読み込まれていることを確認します。

ヘルスチェックについて

ヘルスチェックデータは、C:\ProgramData\Citrix\TelemetryService\の下のフォルダーに保存されます。

サイトヘルスチェック

サイトヘルスチェックは、FlexCast Management Architecture (FMA) サービスの包括的な評価を提供する環境テストサービスに含まれています。これらのチェックでは、サービスの可用性を確認するだけでなく、データベース接続などの他のヘルスインジケーターも確認します。

サイトヘルスチェックはDelivery Controllerで実行されます。サイトの規模によっては、これらのチェックの完了に最大1時間かかる場合があります。

デリバリーコントローラーの構成チェック

サイトヘルスチェックの一部として、Delivery Controller構成チェックは、Virtual Apps and Desktopsサイトに関するCitrixの推奨事項に基づいて、以下の問題が存在するかどうかを確認します。

• 1つ以上のDelivery Controllerが失敗状態にある。
• サイトにデリバリーコントローラーが1つしかない。
• Delivery Controllerの版がそれぞれ異なっていること。

ヘルスチェックの権限と要件を満たすことに加えて、Delivery Controller構成チェックには以下が必要です。

• 少なくとも1つのControllerが電源オンになっていること。
• コントローラーで実行されているブローカーサービス。
• Controllerからサイトデータベースへの動作可能な接続。

VDAヘルスチェック

VDAヘルスチェックは、一般的なVDA登録、セッション起動、およびタイムゾーンリダイレクトの問題の考えられる原因を特定します。

VDAでの登録について、Scoutは以下をチェックします。

• VDAソフトウェアのインストール
• VDAマシンのドメインメンバーシップ
• VDA通信ポートの可用性
• VDAサービスのステータス
• Windowsファイアウォールの構成
• コントローラーとの通信
• コントローラーとの時刻同期
• VDA登録ステータス

VDAでのセッション起動について、Scoutは以下をチェックします。

• セッション起動通信ポートの可用性
• セッション起動サービスのステータス
• セッション起動Windowsファイアウォールの構成
• VDAリモートデスクトップサービス クライアントアクセスライセンス
• VDA アプリケーション起動パス
• セッション起動レジストリ設定

VDA のタイムゾーンリダイレクトについて、Scout は以下をチェックします。

• Windows ホットフィックスのインストール
• Citrix ホットフィックスのインストール
• Microsoft グループポリシー設定
• Citrix グループポリシー設定

VDA のプロファイル管理について、Scout は以下をチェックします。

• ハイパーバイザーの検出
• プロビジョニングの検出
• シトリックス バーチャル アプリ アンド デスクトップ
• パーソナル vDisk の構成
• ユーザー ストア
• プロファイル管理サービスのステータス検出
• Winlogon.exe フッキングテスト

Profile Management のチェックを実行するには、VDA に Profile Management をインストールして有効にする必要があります。Profile Management の構成チェックの詳細については、Knowledge Center の記事 CTX132805 を参照してください。

StoreFront のヘルスチェック

StoreFront のチェックでは、以下を確認します。

• シトリックス デフォルト ドメイン サービスが実行されていること
• シトリックス クレデンシャル ウォレット サービスが実行されていること
• ストアフロント サーバーからアクティブ ディレクトリ ポート 88 への接続
• ストアフロント サーバーからアクティブ ディレクトリ ポート 389 への接続
• ベース URL が有効な FQDN を持っていること
• ベース URL から正しい IP アドレスを取得できること
• IIS アプリケーションプールが .NET 4.0 を使用していること
• 証明書がホスト URL の SSL ポートにバインドされているかどうか
• 証明書チェーンが完全であるかどうか
• 証明書の有効期限が切れているかどうか
• 証明書の有効期限が間もなく切れるかどうか（30日以内）

ライセンスサーバーのチェック

ライセンスサーバーのチェックでは、以下を確認します。

• Delivery Controller からのライセンスサーバー接続
• ライセンスサーバーのファイアウォールリモートアクセスステータス
• シトリックス ライセンシング サービスのステータス
• ライセンスサーバーのライセンスキャッシュモードの状態
• ライセンスサーバーポートの接続
• Citrix ベンダーデーモン (CITRIX) が実行されているかどうか
• システムクロックが同期されているかどうか
• Citrix Licensing サービスがローカルサービスアカウントで実行されているかどうか
• CITRIX.opt ファイルの存在
• カスタマーサクセスサービス の有効期限
• シトリックス ライセンス サーバー の更新
• ライセンスサーバー証明書が Delivery Controller の信頼されたルートストアにあるかどうか

ヘルスチェックの 権限と要件 を満たすことに加えて、ライセンスサーバーはドメインに参加している必要があります。そうでない場合、ライセンスサーバーは検出されません。

ヘルスチェックの実行

ヘルスチェックの手順は、マシンの選択、チェックの開始、および結果レポートの確認で構成されます。

1. Scoutを起動します。マシンのスタートメニューから、Citrix > Citrix Scoutを選択します。開いたページで、Health Checkをクリックします。

2. マシンを選択します。Find machineをクリックしてマシンを検出します。Select machinesページには、サイトで検出されたすべてのVDA、Delivery Controller、およびライセンスサーバーが一覧表示されます。マシン名で表示をフィルターできます。診断情報を収集する各マシンの横にあるチェックボックスをオンにして、Continueをクリックします。

   その他のコンポーネントの種類（StoreFrontサーバーやVDAマシンなど）を追加するには、「Add machines manually」および「Import VDA machines」を参照してください。Citrix Provisioning™サーバーまたはライセンスサーバーを手動で追加することはできません。

   Scoutは、選択された各マシンで検証テストを自動的に起動し、「Verification tests」に記載されている基準を満たしていることを確認します。検証に失敗した場合、Status列にメッセージが表示され、そのマシンのチェックボックスがオフになります。次のいずれかを実行できます。

   • 問題を解決してから、マシンのチェックボックスを再度オンにします。これにより、検証テストが再試行されます。
   • そのマシンをスキップします（チェックボックスをオフのままにします）。そのマシンではヘルスチェックは実行されません。

   検証テストが完了したら、Continueをクリックします。

3. 選択したマシンでヘルスチェックを実行します。概要には、テストが実行されるマシン（検証テストに合格した選択済みのマシン）が一覧表示されます。Start Checkingをクリックします。

   チェック中およびチェック後：

   • Status列は、マシンの現在のチェック状態を示します。
   • 進行中のすべてのチェックを停止するには、ページ右下隅にあるStop Checkingをクリックします。（単一のマシンのヘルスチェックをキャンセルすることはできず、選択されたすべてのマシンのみが対象です。チェックが完了したマシンからの情報は保持されます。
   • 選択されたすべてのマシンのチェックが完了すると、右下隅のStop CheckingボタンがDoneに変わります。
   • チェックに失敗した場合は、Action列のRetryをクリックできます。
   • チェックが完了し、問題が見つからなかった場合、Action列は空になります。
   • チェックで問題が見つかった場合は、詳細を表示をクリックして結果を表示します。
   • 選択したすべてのマシンでチェックが完了したら、戻るをクリックしないでください。(クリックすると、チェック結果が失われます。)
4. チェックが完了したら、完了をクリックしてScoutの開始ページに戻ります。

ヘルスチェックの結果

レポートを生成するCitrixチェックの場合、レポートには以下が含まれます。

• 結果レポートが生成された日時
• チェックされたマシン
• チェックが対象マシンで探した条件

権限および要件

権限:

• 診断情報を収集するには:

  • 診断情報を収集する各マシンで、ローカル管理者およびドメインユーザーである必要があります。
  • 各マシンでLocalAppDataディレクトリへの書き込み権限が必要です。

• ヘルスチェックを実行するには:

  • ドメインユーザーグループのメンバーである必要があります。
  • サイトに対して、フル管理者であるか、または読み取り専用および「環境テストの実行」権限を持つカスタムロールを持っている必要があります。
  • スクリプトの実行を許可するには、スクリプト実行ポリシーを少なくとも RemoteSigned に設定します。例: Set-ExecutionPolicy RemoteSigned。注: 他のスクリプト実行権限でも機能する場合があります。

• Scout を起動するときは、「管理者として実行」を使用します。

診断情報を収集したり、ヘルスチェックを実行したりする各マシンについて:

• Scout はそのマシンと通信できる必要があります。
• ファイルとプリンターの共有が有効になっている必要があります。
• PSRemoting と WinRM が有効になっている必要があります。マシンでは PowerShell 3.0 以降が実行されている必要もあります。
• そのマシンで Citrix Telemetry Service が実行されている必要があります。
• そのマシンで Windows Management Infrastructure (WMI) アクセスが有効になっている必要があります。
• 診断情報収集のスケジュールを設定するには、マシンで互換性のあるScoutバージョンが実行されている必要があります。

パス名で指定されたユーザー名にドル記号 ($) を使用しないでください。これにより、診断情報の収集が妨げられます。

Scout は、これらの要件が満たされていることを確認するために、選択したマシンに対して検証テストを実行します。

Windows 用のテレメトリサービスは、ネットワークサービスで実行されます。

AOT トレースフォルダーは C:\ProgramData\Citrix\TelemetryService\CitrixAOT に保存されます。

Administrator group、System、および Telemetry Service SID のユーザーのみが、HKEYLOCALMACHINE:SOFTWARE\Citrix\Telemetry レジストリにアクセスする権限を持っています。

Scout データ使用量 2(/ja-jp/citrix-virtual-apps-desktops/2511/media/scout-data2.png)

テレメトリーサービス SID は、テレメトリーサービスをアンインストールした後も Performance Log Users グループに残りますが、手動で削除できます。

Scout データ使用量 3(/ja-jp/citrix-virtual-apps-desktops/2511/media/scout-data3.png)

検証テスト

診断コレクションまたはヘルスチェックが開始される前に、選択された各マシンに対して検証テストが自動的に実行されます。これらのテストは、要件が満たされていることを確認します。マシンのテストが失敗した場合、Scout は推奨される是正措置を含むメッセージを表示します。

• Scout がこのマシンに到達できません - 以下を確認してください:

  • マシンが電源オンになっていること。
  • ネットワーク接続が正常に機能していること。(これには、ファイアウォールが適切に構成されていることの確認が含まれる場合があります。)
  • ファイルとプリンターの共有がオンになっていること。手順については、Microsoft のドキュメントを参照してください。
• PSRemoting と WinRM を有効にする - PowerShell リモート処理と WinRM を同時に有効にできます。管理者として実行を使用して、Enable-PSRemoting コマンドレットを実行します。詳細については、コマンドレットに関する Microsoft のヘルプを参照してください。
• Scout には PowerShell 3.0 (最小) が必要です - マシンに PowerShell 3.0 (またはそれ以降) をインストールし、PowerShell リモート処理を有効にしてください。
• このマシン上の LocalAppData ディレクトリにアクセスできません - アカウントに、このマシン上の LocalAppData ディレクトリへの書き込み権限があることを確認してください。
• Citrix Telemetry Service を見つけることができません - Citrix Telemetry Service がマシンにインストールされ、開始されていることを確認してください。
• スケジュールを取得できません - マシンを (最小) XenApp および XenDesktop 7.14 にアップグレードしてください。
• WMIがマシンで実行されていません - Windows Management Instrumentation (WMI) アクセスが有効になっていることを確認してください。
• WMI接続がブロックされています - Windows FirewallサービスでWMIを有効にしてください。
• Citrix Telemetry Serviceの新しいバージョンが必要です - (バージョンは、収集とトレースおよび再現の場合にのみチェックされます。) マシン上のTelemetry Serviceのバージョンをアップグレードしてください ((#install-and-upgrade)の[インストールとアップグレード]を参照)。サービスをアップグレードしない場合、そのマシンは収集またはトレースと再現のアクションに含まれません。

• Scoutがこのマシン上のsystemdソケットに接続できません - 以下を確認してください。

  • ポート7503が開いています。systemd ctxtelemetry.socketがマシン上のポート7503でリッスンしていることを確認してください。ctxtelemetry.socketポートが変更されている場合、ポートが異なる可能性があります。ポートを調整するには、(#scout-configuration)の[Scout構成]を参照してください。
  • ネットワーク接続が正常に機能していることを確認してください。(これには、ファイアウォールが適切に構成されていることの確認が含まれる場合があります。)

• このマシンでLinux VDA Telemetry Serviceが開始されていません - 以下を確認してください。

  • ポート7502が開いています。Linux VDA Telemetry Serviceがマシンにインストールされ、開始されていることを確認してください。テレメトリサービスポートが変更されている場合、ポートが異なる可能性があります。ポートを調整するには、(#scout-configuration)の[Scout構成]を参照してください。
  • ネットワーク接続が正常に機能していることを確認してください。(これには、ファイアウォールが適切に構成されていることの確認が含まれる場合があります。)

バージョン互換性

このバージョンのScout (3.x) は、Citrix Virtual Apps and Desktops (または最低限XenApp and XenDesktop 7.14) のコントローラーおよびVDAで実行することを目的としています。

インストールとアップグレード

デフォルトでは、VDAまたはコントローラーをインストールまたはアップグレードする際に、ScoutはCitrix Telemetry Serviceの一部として自動的にインストールまたはアップグレードされます。

VDAのインストール時にCitrix Telemetry Serviceを省略した場合、または後でサービスを削除した場合は、Citrix Virtual Apps and Desktopsインストールメディアのx64\Virtual Desktop Componentsまたはx86\Virtual Desktop ComponentsフォルダーからTelemetryServiceInstaller_xx.msiを実行してください。

「Collect」または「Trace & Reproduce」アクションを選択すると、マシンが古いバージョンのCitrix Telemetry Serviceを実行している場合に通知されます。Citrixは、最新のサポートされているバージョンを使用することをお勧めします。そのマシンでTelemetry Serviceをアップグレードしない場合、そのマシンは「Collect」または「Trace & Reproduce」アクションに含まれません。Telemetry Serviceをアップグレードするには、インストールと同じ手順を使用します。

アップロードの承認

診断コレクションをCitrixにアップロードする予定がある場合は、CitrixアカウントまたはCitrix Cloudアカウントが必要です。（これらは、Citrixダウンロードにアクセスしたり、Citrix Cloud Control Centerにアクセスしたりするために使用する資格情報です。）アカウントの資格情報が検証されると、トークンが発行されます。

CitrixアカウントまたはCitrix Cloudアカウントで認証する場合、リンクをクリックして、デフォルトのブラウザでHTTPSを使用してCitrix Cloudにアクセスします。Citrix Cloudの資格情報を入力すると、トークンが表示されます。トークンをコピーしてScoutに貼り付けます。その後、Scoutウィザードを続行できます。

トークンは、Scoutを実行しているマシンにローカルに保存されます。次回「Collect」または「Trace & Reproduce」を実行するときにそのトークンを使用できるようにするには、「Store token and skip this step in the future」チェックボックスをオンにします。

Scoutの開始ページで「Schedule」を選択するたびに、再承認する必要があります。スケジュールを作成または変更する際には、保存されたトークンを使用できません。

アップロードにプロキシを使用する

プロキシサーバーを使用してコレクションをCitrixにアップロードしたい場合は、Scoutにブラウザのインターネットプロパティ用に構成されたプロキシ設定を使用するように指示できます。または、プロキシサーバーのIPアドレスとポート番号を指定することもできます。

マシンの検索

「Collect」、「Trace & Reproduce」、および「Schedule」の手順では、Scoutは自動的に検出したコントローラーとVDAを一覧表示します。

Delivery ControllerからScout Health Checkを実行するときは、「Find machine」をクリックして、デリバリーコントローラー、VDA、ライセンスサーバー、StoreFrontサーバーなどのマシンを検出します。

Delivery Controllerではないドメイン参加済みマシンからScout Health Checkを実行する場合、Scoutはマシンを自動的に検出できません。マシンを手動で追加するか、VDAマシンをインポートする必要があります。

マシンを手動で追加する

Scoutが検出したコントローラーとVDAを一覧表示した後、StoreFrontサーバー、ライセンスサーバー、Citrix Provisioningサーバーなど、展開内の他のマシンを手動で追加できます。

ヘルスチェックを実行する場合：

• ドメイン内のCitrixライセンスサーバーは自動的に検出されます。ライセンスサーバーを手動で追加することはできません。
• ヘルスチェックは現在、Citrix Provisioningサーバーをサポートしていません。

検出されたマシンを一覧表示するScoutのページで、+ Add machineをクリックします。追加するマシンのFQDNを入力し、Continueをクリックします。必要に応じて、他のマシンを追加するために繰り返します。(FQDNの代わりにDNSエイリアスを入力しても有効に見えることがありますが、ヘルスチェックが失敗する可能性があります。)

手動で追加されたマシンは、常にマシンリストの一番上、検出されたマシンよりも上に表示されます。

手動で追加されたマシンを識別する簡単な方法は、行の右端にある赤い削除ボタンです。そのボタンがあるのは、手動で追加されたマシンだけです。検出されたマシンにはありません。

手動で追加されたマシンを削除するには、行の右端にある赤いボタンをクリックします。削除を確認します。他の手動で追加されたマシンを削除するために繰り返します。

Scoutは、手動で追加されたマシンを削除するまで記憶しています。Scoutを閉じてから再度開くと、手動で追加されたマシンは、引き続きリストの一番上に表示されます。

StoreFrontサーバーでTrace & Reproduceを使用している場合、CDFトレースは収集されません。ただし、その他のすべてのトレース情報は収集されます。

ヒント:

Scoutは、Citrix Virtual Apps and Desktops LTSR 2507バージョン以降のStoreFrontタイプのマシンで実行されている場合、Collectページに+ Add machineボタンを表示することをサポートしています。このオプションにより、ユーザーは同じクラスター内の複数のStoreFrontサーバーマシンを手動で追加し、同時に収集をトリガーできます。TelemetryServiceの古いバージョンでは、この機能はサポートされていません。

VDAマシンをインポートする

ヘルスチェックを実行しているときに、展開内のVDAマシンをインポートできます。

1. Delivery ControllerまたはConnectorで、PowerShellコマンドを使用してマシンリストファイルを生成します。Connectorでは、Citrix資格情報を入力し、ポップアップダイアログで顧客を選択する必要があります。

   Get-BrokerMachine| foreach { $_.DnsName } | out-file C:\machineList.txt

2. machineList.txtファイルを、Scout Health Checkを起動するドメイン参加済みマシンにコピーします。
3. Scout Health Check ページで、マシンの追加 をクリックします。
4. マシンタイプとしてWindows VDAを選択します。
5. VDAマシンのインポート をクリックします。
6. machineList.txtファイルを選択します。
7. Openをクリックします。

インポートされたVDAマシンがScout Health Checkページに表示されます。

診断情報の収集

Collect手順では、マシンを選択し、診断情報の収集を開始し、収集した情報を含むファイルをCitrixにアップロードするか、ローカルに保存します。

1. Scoutを起動します。マシンのスタートメニューから、Citrix > Citrix Scoutを選択します。開いたページで、Collectをクリックします。

2. マシンを選択します。

   • Controllerでは、Select machinesページにサイト内のすべてのVDAとControllerが一覧表示されます。マシン名で表示をフィルターできます。他のマシン（StoreFrontやCitrix Provisioningサーバーなど）を手動で追加するには、「Add machines manually」を参照してください。
   • StoreFrontでは、Select machinesページにローカルマシンのみが一覧表示されます。同じクラスター内の他のStoreFrontマシンを追加するには、「Add machines manually」を参照してください。
   • その他のコンポーネント（VDAサーバーなど）では、Select machinesページにローカルマシンのみが一覧表示されます。マシンの手動追加はサポートされていません。

   診断情報を収集する各マシンの横にあるチェックボックスをオンにし、Continueをクリックします。

   Scoutは、選択された各マシンで検証テストを自動的に起動し、Verification testsに記載されている基準を満たしていることを確認します。検証に失敗すると、「ステータス」列にメッセージが表示され、そのマシンのチェックボックスが選択解除されます。次のいずれかを実行できます。

   • 問題を解決してから、マシンのチェックボックスを再度選択します。これにより、検証テストが再試行されます。
   • そのマシンをスキップします（チェックボックスは選択解除のままにします）。そのマシンからは診断情報は収集されません。

   検証テストが完了したら、「続行」をクリックします。

3. 診断情報を収集します。概要には、診断情報が収集されるすべてのマシン（検証テストに合格した選択済みのマシン）が一覧表示されます。「収集開始」をクリックします。

   収集中に：

   • 「ステータス」列は、マシンの現在の収集状態を示します。
   • 単一マシンでの進行中の収集を停止するには、そのマシンの「アクション」列にある「キャンセル」をクリックします。
   • 進行中のすべての収集を停止するには、ページの右下隅にある「収集停止」をクリックします。収集が完了したマシンからの診断情報は保持されます。収集を再開するには、各マシンの「アクション」列にある「再試行」をクリックします。
   • 選択されたすべてのマシンの収集が完了すると、右下隅の「収集停止」ボタンが「続行」に変わります。
   • 診断情報を再度収集するには、そのマシンの「アクション」列にある「再収集」をクリックします。新しい収集は以前の収集を上書きします。
   • 収集に失敗した場合は、「アクション」列にある「再試行」をクリックできます。成功した収集のみがアップロードまたは保存されます。
   • 選択されたすべてのマシンの収集が完了したら、「戻る」をクリックしないでください。（クリックすると、収集は失われます）。

   収集が完了したら、「続行」をクリックします。

4. 収集を保存またはアップロードします。ファイルをCitrixにアップロードするか、ローカルマシンに保存するかを選択します。

   ファイルを今すぐアップロードする場合は、手順5に進みます。

   ファイルをローカルに保存する場合は、次の手順を実行します。

   • Windowsの保存ダイアログボックスが表示されます。目的の場所に移動します。
   • ローカル保存が完了すると、ファイルのパス名が表示され、リンクされます。ファイルを表示できます。後でCitrixにファイルをアップロードできます。詳しくは、CTX136396を参照してください。

   完了をクリックしてScoutの開始ページに戻ります。この手順でこれ以上ステップを完了する必要はありません。

5. アップロードの認証を行い、必要に応じてプロキシを指定します。詳しくは、「アップロード認証」を参照してください。

   • Scoutを通じて認証を行っていない場合は、この手順に進みます。
   • Scoutを通じて認証済みの場合、保存されている認証トークンがデフォルトで使用されます。この操作を行う場合は、このオプションを選択して続行をクリックします。この収集では資格情報の入力を求められません。手順6に進みます。
   • 以前に認証済みで、再認証して新しいトークンを取得したい場合は、変更/再認証をクリックしてこの手順に進みます。

   アップロードを認証するためにCitrix資格情報を使用するか、Citrix Cloud資格情報を使用するかを選択します。続行をクリックします。資格情報ページは、保存されたトークンを使用していない場合にのみ表示されます。

   資格情報ページで、次の手順を実行します。

   • ファイルアップロードにプロキシサーバーを使用する場合は、プロキシの構成をクリックします。Scoutに、ブラウザーのインターネットプロパティ用に構成されたプロキシ設定を使用するように指示できます。または、プロキシサーバーのIPアドレスとポート番号を入力することもできます。プロキシダイアログボックスを閉じます。
   • Citrix Cloudアカウントの場合は、トークンの生成をクリックします。デフォルトのブラウザーがCitrix Cloudページに起動し、トークンが表示されます。トークンをコピーし、Scoutページに貼り付けます。
   • Citrixアカウントの場合は、資格情報を入力します。

   完了したら、続行をクリックします。

6. アップロードに関する情報を入力します。

   • 名前フィールドには、収集された診断ファイルのデフォルト名が含まれています。ほとんどのコレクションではこれで十分ですが、名前を変更することもできます。（デフォルト名を削除して名前フィールドを空のままにすると、デフォルト名が使用されます。）
   • オプションで、8桁のCitrixサポートケース番号を指定します。
   • オプションの説明フィールドに、問題の内容と、該当する場合は問題が発生した時期を記述します。

   完了したら、アップロードの開始をクリックします。

   アップロード中、ページの左下部分にアップロードの完了率が概算で表示されます。進行中のアップロードをキャンセルするには、アップロードの停止をクリックします。

   アップロードが完了すると、その場所のURLが表示され、リンクされます。リンクをたどってCitrixの場所に移動し、アップロードの分析を表示することも、リンクをコピーすることもできます。

   完了をクリックしてScoutの開始ページに戻ります。

トレースと再現

トレースと再現の手順は、マシンの選択、トレースの開始、問題の再現、診断コレクションの完了、そしてファイルをCitrixにアップロードするかローカルに保存することから構成されます。

この手順は標準の収集手順に似ています。ただし、マシンでトレースを開始し、それらのマシンで問題を再現することができます。すべての診断コレクションにはAOTトレース情報が含まれています。この手順では、トラブルシューティングに役立つCDFトレースが追加されます。

1. Scoutを起動します。マシンのスタートメニューから、Citrix > Citrix Scoutを選択します。開始ページで、トレースと再現をクリックします。

2. マシンを選択します。マシンの選択ページには、サイト内のすべてのVDAとControllerが一覧表示されます。マシン名で表示をフィルタリングできます。トレースと診断を収集する各マシンの横にあるチェックボックスを選択します。次に、続行をクリックします。

   他のマシンを手動で追加するには（StoreFrontやCitrix Provisioningサーバーなど）、マシンを手動で追加するを参照してください。

   Scoutは、選択された各マシンで検証テストを自動的に起動し、検証テストに記載されている基準を満たしていることを確認します。マシンの検証が失敗した場合、ステータス列にメッセージが表示され、そのマシンのチェックボックスは選択解除されます。次のいずれかを実行できます。

   • 問題を解決してから、マシンのチェックボックスをもう一度選択します。これにより、検証テストが再試行されます。
   • そのマシンをスキップします（チェックボックスをオフのままにします）。そのマシンからは診断情報とトレースは収集されません。

   検証テストが完了したら、続行をクリックします。

3. トレースを開始します。概要には、トレースが収集されるすべてのマシンが一覧表示されます。トレースの開始をクリックします。

   選択した1台以上のマシンで、発生した問題を再現します。その間もトレースの収集は続行されます。問題の再現が完了したら、Scoutで続行をクリックします。これによりトレースが停止します。

   トレースを停止した後、トレース中に問題を再現したかどうかを示します。

4. マシンから診断情報を収集します。収集の開始をクリックします。収集中：

   • ステータス列は、マシンの現在の収集状態を示します。
   • 単一マシンで進行中の収集を停止するには、そのマシンのアクション列にあるキャンセルをクリックします。
   • 進行中のすべての収集を停止するには、ページの右下隅にある収集の停止をクリックします。収集が完了したマシンからの診断情報は保持されます。収集を再開するには、各マシンのアクション列にある再試行をクリックします。
   • 選択したすべてのマシンの収集が完了すると、右下隅の収集の停止ボタンが続行に変わります。
   • マシンから診断情報を再度収集するには、そのマシンのアクション列にある再度収集をクリックします。新しい収集は以前の収集を上書きします。
   • 収集が失敗した場合は、アクション列にある再試行をクリックできます。成功した収集のみがアップロードまたは保存されます。
   • 選択したすべてのマシンの収集が完了した後、戻るをクリックしないでください。（クリックすると、収集が失われます。）

   収集が完了したら、続行をクリックします。

5. コレクションを保存またはアップロードします。ファイルをCitrixにアップロードするか、ローカルに保存するかを選択します。

   今すぐファイルをアップロードすることを選択した場合は、手順6に進みます。

   ファイルをローカルに保存することを選択した場合は、次のようになります。

   • Windowsの保存ダイアログボックスが表示されます。目的の場所を選択します。
   • ローカル保存が完了すると、ファイルのパス名が表示され、リンクされます。ファイルを表示できます。注意: ファイルは後でCitrixからアップロードできます。Citrix Insight Servicesについては、CTX136396を参照してください。

   完了をクリックしてScoutの開始ページに戻ります。この手順でこれ以上ステップを完了する必要はありません。

6. アップロードの認証を行い、必要に応じてプロキシを指定します。このプロセスの詳細については、アップロード認証を参照してください。

   • Scoutを介して認証していない場合は、この手順に進みます。
   • Scoutを介して認証した場合、保存されている認証トークンがデフォルトで使用されます。これを行う場合は、このオプションを選択して続行をクリックします。このコレクションの資格情報は要求されません。手順7に進みます。
   • 以前に認証済みで、再認証して新しいトークンを取得したい場合は、変更/再認証をクリックしてこの手順に進みます。

   アップロードを認証するためにCitrix資格情報を使用するか、Citrix Cloud資格情報を使用するかを選択します。続行をクリックします。資格情報ページは、保存されたトークンを使用していない場合にのみ表示されます。

   資格情報ページで:

   • ファイルアップロードにプロキシサーバーを使用したい場合は、プロキシの構成をクリックします。Scoutにブラウザのインターネットプロパティで構成されたプロキシ設定を使用するように指示できます。または、プロキシサーバーのIPアドレスとポート番号を入力することもできます。プロキシダイアログボックスを閉じます。
   • Citrix Cloudアカウントの場合、トークンを生成をクリックします。デフォルトのブラウザがCitrix Cloudページに起動し、トークンが表示されます。トークンをコピーし、Scoutページに貼り付けます。
   • Citrixアカウントの場合、資格情報を入力します。

   完了したら、続行をクリックします。

7. アップロードに関する情報を提供します。

   アップロードの詳細を入力します。

   • 名前フィールドには、収集された診断ファイルのデフォルト名が含まれています。ほとんどのコレクションではこれで十分ですが、名前を変更することもできます。(デフォルト名を削除して名前フィールドを空のままにした場合、デフォルト名が使用されます。)
   • オプションで、8桁のCitrixサポートケース番号を指定します。
   • オプションの「説明」フィールドに、問題の内容と、該当する場合は問題が発生した時期を記述します。

   完了したら、アップロードの開始をクリックします。

   アップロード中、ページの左下部分にアップロードの完了率の目安が表示されます。進行中のアップロードをキャンセルするには、アップロードの停止をクリックします。

   アップロードが完了すると、その場所のURLが表示され、リンクされます。リンクをたどってCitrixの場所に移動し、アップロードの分析を表示したり、リンクをコピーしたりできます。

   完了をクリックして、Scoutの開始ページに戻ります。

スカウトはトレースロギングプロバイダーをサポート

以前は、ScoutはWindowsパフォーマンスプロバイダーのみをサポートしており、これには追加のデコードファイルが必要で、同じプロバイダーの単一セッションからのセッションとイベントのみをトレースしていました。

Citrix Virtual Apps and Desktopsバージョン2411以降、ScoutはTraceLoggingプロバイダーをサポートしています。このプロバイダーは追加のデコードファイルを必要とせず、同じプロバイダーに対して最大8つのトレースセッションからイベントを有効にして受信できます。この機能はデフォルトで有効になっています。

追加のログ収集を有効にする

追加のログ収集を有効にする機能を使用すると、perfmon、Netsh、DebugView、Wiresharkなどのより多くのツールでトレースおよび再現機能を使用できます。

2407リリース以降、追加のログ収集を有効にすると、ScoutはマシンにインストールされているCDC関連ツールを自動的に検出し、CDCツール関連のトレースログをzipパッケージに自動収集します。これらのzipファイルをカスタマイズしてScoutに添付できます。この自動化により、Citrix Scoutをより効果的に使用でき、問題を迅速に診断するのに役立ちます。

注:

これはローカルマシンにのみ適用されます。

追加のログ収集を有効にするには、以下の必要なツールがインストールされ、指定された場所に手動でディレクトリが作成されていることを確認してください。

ツールのインストール場所:

• Procdump logs: Download Procdump and place it at %ProgramData%\Citrix\TelemetryService\CDC\Lib\Resources\Tools\Procdump\procdump.exe

• StoreFront logs: Download DbgView and place it at %ProgramData%\Citrix\TelemetryService\CDC\Lib\Resources\Tools\DebugView\Dbgview.exe

• Procmon logs: Download Process Monitor and place it at %ProgramData%\Citrix\TelemetryService\CDC\Lib\Resources\Tools\ProcessMonitor\Procmon.exe

• Wireshark ログ: Wireshark をシステムに手動でインストールします。

追加のログを収集するには:

1. Scoutのホームぺージで、Trace & Reproduce をクリックします。
2. データ収集元のSelect or add machinesページで、ローカルマシンのチェックボックスをオンにします。ステータスはVerifiedと表示されている必要があります。
3. 追加のログ収集を有効にするには、Citrix Data Collection Tool を使用した追加ログ収集を有効にする チェックボックスを選択します。

4. Upload control file ボタンをクリックして、1つのCTLファイルをロードします。このボタンを使用すると、ScoutでのAOT収集のために、AOT収集リストに追加のGUIDを追加できます。

5. Continue をクリックし、トレースと再現 の手順に従います。

6. 完了後、zipファイル内のログを確認します。ログはCDCLogsフォルダーに圧縮されています。

   追加ログ収集を有効にする(/ja-jp/citrix-virtual-apps-desktops/2511/media/enable-additional-log.png)

注：

Procmon Toolがトレース用に選択されている場合、Process Monitorログはすぐに大きくなる可能性があります。必要なツールのみを選択するようにしてください。ログのサイズは、%temp%\Scout-CDC-Logで監視することもできます。

コレクションのスケジュール設定

注：

現在、コレクションのスケジュール設定は可能ですが、ヘルスチェックのスケジュール設定はできません。

スケジュール設定の手順は、マシンを選択し、スケジュールを設定またはキャンセルすることから構成されます。スケジュールされたコレクションは自動的にCitrixにアップロードされます。（PowerShellインターフェイスを使用して、スケジュールされたコレクションをローカルに保存できます。Citrix Call Homeを参照してください。）

1. Scoutを起動します。マシンのスタートメニューから、Citrix > Citrix Scoutを選択します。開いたページで、Scheduleをクリックします。

2. マシンを選択します。サイト内のすべてのVDAsとControllersが一覧表示されます。マシン名で表示をフィルターできます。

   グラフィカルインターフェイスを使用してVDAsとControllersをインストールしたときに、Call Homeスケジュールを設定した場合（Citrix Call Homeを参照）、Scoutはデフォルトでそれらの設定を表示します。このバージョンのScoutを使用して、スケジュールされたコレクションを初めて開始したり、以前に構成したスケジュールを変更したりできます。

   コンポーネントのインストール中にマシンごとにCall Homeを有効/無効にした場合でも、Scoutで構成されたスケジュールは、選択したすべてのマシンに影響します。

   診断を収集する各マシンの横にあるチェックボックスをオンにしてから、Continueをクリックします。

   その他のマシン（StoreFrontやCitrix Provisioningサーバーなど）を手動で追加するには、マシンの手動追加を参照してください。

   Scoutは、選択した各マシンで検証テストを自動的に起動し、Verification testsの基準を満たしていることを確認します。マシンの検証が失敗した場合、Status列にメッセージが投稿され、そのマシンのチェックボックスはオフになります。次のいずれかを実行できます。

   • 問題を解決してから、マシンのチェックボックスを再度選択します。これにより、検証テストが再試行されます。
   • そのマシンをスキップします（チェックボックスをオフのままにします）。そのマシンからは診断（またはトレース）は収集されません。

   検証テストが完了したら、「続行」をクリックします。

   概要ページには、スケジュールが適用されるマシンが一覧表示されます。「続行」をクリックします。

3. スケジュールを設定します。診断を収集するタイミングを指定します。注意：スケジュールは、選択したすべてのマシンに影響します。

   • 選択したマシンに週次スケジュールを構成するには、「毎週」をクリックします。曜日を選択します。収集を開始する時刻（24時間形式）を入力します。
   • 選択したマシンに日次スケジュールを構成するには、「毎日」をクリックします。収集を開始する時刻（24時間形式）を入力します。
   • 選択したマシンの既存のスケジュールをキャンセルする（そして別のスケジュールに置き換えない）には、「オフ」をクリックします。これにより、それらのマシンに対して以前に構成されたスケジュールがすべてキャンセルされます。

   「続行」をクリックします。

4. アップロードの認証を行い、必要に応じてプロキシを指定します。このプロセスの詳細については、アップロード認証を参照してください。注意：Scoutスケジュールを使用する場合、保存されたトークンを使用して認証することはできません。

   アップロードを認証するために、Citrix資格情報を使用するか、Citrix Cloud資格情報を使用するかを選択します。「続行」をクリックします。

   資格情報ページで、次の操作を行います。

   • ファイルアップロードにプロキシサーバーを使用する場合は、「プロキシの構成」をクリックします。Scoutに、ブラウザーのインターネットプロパティ用に構成されたプロキシ設定を使用するように指示できます。または、プロキシサーバーのIPアドレスとポート番号を入力することもできます。プロキシダイアログボックスを閉じます。
   • Citrix Cloudアカウントの場合は、「トークンの生成」をクリックします。デフォルトのブラウザーがCitrix Cloudページに起動し、トークンが表示されます。トークンをコピーし、Scoutページに貼り付けます。
   • Citrixアカウントの場合は、資格情報を入力します。

   完了したら、「続行」をクリックします。

   設定されたスケジュールを確認します。「完了」をクリックして、Scoutの開始ページに戻ります。

   収集中、選択された各マシンのWindowsアプリケーションログには、収集とアップロードに関するエントリが含まれます。

データマスキング

Citrix Scoutを使用して収集された診断情報には、セキュリティ上機密性の高い情報が含まれる場合があります。Citrix Scoutのデータマスキング機能を使用すると、診断ファイルをCitrixにアップロードする前に、機密データをマスキングできます。

Scoutのデータマスキングは、IPアドレス、マシン名、ドメイン名、ユーザー名、ハイパーバイザー名、デリバリーグループ名、カタログ名、アプリケーション名、およびSIDをマスキングするように構成されています。

注：

CDFトレースは暗号化されており、マスキングできません。

Linux VDAログは.tar.gz2形式に圧縮されており、マスキングできません。

新しい診断情報を収集し、データマスキングを実行する

Citrix Scoutのデータマスキング機能を使用するには、コマンドラインからScoutを起動します。

1. Windowsで、管理者としてコマンドプロンプトを開きます。
2. Scoutがインストールされているディレクトリに移動します: cd C:\Program Files\Citrix\Telemetry Service。
3. Scoutを起動します: ScoutUI.exe datamasking。
4. 診断情報を収集するには、「Collect」または「Trace & Reproduce」をクリックします。
5. 収集が完了したら、「データマスキングを有効にする」を選択します。このオプションはデフォルトで有効になっています。
6. データマスクを設定します。デフォルトのルールを使用することも、ルールをカスタマイズすることもできます。
7. 診断コレクションをアップロードするか保存するかを選択します。
   • 「診断コレクションをCitrixにアップロード」を選択した場合、マスクされた診断ファイルがCitrixにアップロードされます。
   • 「診断コレクションをローカルマシンに保存」を選択した場合、元の診断とマスクされた診断の両方が指定された場所に保存されます。

既存の診断でデータマスキングを実行する

1. Windowsで、コマンドプロンプトを管理者として開きます。
2. Scoutがインストールされているディレクトリに移動します。cd C:\Program Files\Citrix\Telemetry Service。
3. データマスキングモードでScoutを直接起動します。ScoutUI.exe datamasking filePath。
4. 続行するには「データマスキングを有効にする」を選択します。このオプションはデフォルトで有効になっています。
5. データマスクを設定します。デフォルトのルールでデータマスキングを実行することも、ルールをカスタマイズすることもできます。
6. 診断コレクションをアップロードするか保存するかを選択します。
   • 「診断コレクションをCitrixにアップロード」を選択した場合、マスクされた診断ファイルがCitrixにアップロードされます。
   • 「診断コレクションをローカルマシンに保存」を選択した場合、元の診断とマスクされた診断の両方が指定された場所に保存されます。

マスクされたデータファイルとマッピングファイルの場所

診断コレクションをアップロードまたは保存した後、リンクをクリックして元の診断とマスクされた診断を開き、マッピング情報ファイルを開きます。

使用状況データの収集

Scoutを使用すると、CitrixはGoogle Analyticsを使用して匿名の使用状況データを収集し、将来の製品機能と改善に役立てます。データ収集はデフォルトで有効になっています。

使用状況データの収集とアップロードを変更するには、Scout UIの設定ギアをクリックします。その後、はいまたはいいえを選択し、保存をクリックして情報を送信するかどうかを選択できます。

Scoutの使用状況データ収集(/ja-jp/citrix-virtual-apps-desktops/2511/media/scout-usage.png)

Scout機能のコマンドラインインターフェイス

Scout機能のコマンドラインインターフェイスを使用できるようになり、Scout UIを開かずに必要なログとデータを収集できます。この機能は、高度なユーザーがターゲットマシンまたはサイトのログまたはトレースプロセスをローカルまたはリモートで自動化するのに便利です。この機能はデフォルトで有効になっています。

次の機能にコマンドが追加されました。

• ヘルプ
• 診断の収集
• トレースの開始
• トレースの停止
• 進行中のトレースセッションのリスト
• CDCの開始と停止

注:

リモートトレースセッションを実行する場合、新しいテレメトリバージョンをVDAとDDCの両方にインストールする必要があります。このインストールが必要なのは、ScoutコマンドラインがCitrix Virtual Apps and Desktopsバージョン2411からサポートされており、TelemetryServiceの古いバージョンはこの機能をサポートしていないためです。

次の表は、新しく追加されたコマンドについて説明しています。

ヘルプ

診断情報を収集するためのコマンド

トレースを開始

トレースの停止

進行中のトレースセッションを一覧表示する

CDC の開始と停止