シトリックス スカウト
はじめに
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つ以上のVirtual Delivery Agent(VDA)、Delivery Controller、StoreFrontサーバー、およびLicense Serverで診断情報を取得したり、チェックを実行したりできます。また、VDAからScoutを実行して、ローカル診断情報を収集することもできます。
-
Citrix DaaS(旧称Citrix Virtual Apps and Desktopsサービス)を使用するCitrix Cloud環境では、VDAからScoutを実行して、ローカル診断情報を収集します。
Scout アプリケーションのログは
C:\ProgramData\Citrix\TelemetryService\ScoutUI.log に保存されます。このファイルはトラブルシューティングに使用できます。
収集される情報
Scoutによって収集される診断情報には、Citrix Diagnostic Facility(CDF)トレースログファイルが含まれます。Always-on Tracing(AOT)と呼ばれるCDFトレースのサブセットも含まれます。AOT情報は、VDA登録やアプリケーション/デスクトップの起動などの一般的な問題のトラブルシューティングに役立ちます。その他のEvent Tracing for Windows(ETW)情報は収集されません。
収集される情報には以下が含まれます。
-
Citrix Virtual Apps and Desktopsによって
HKEY_LOCAL_MACHINE\SOFTWARE\Citrixの下に作成されたレジストリエントリ。 -
Citrix名前空間の下のWindows Management Instrumentation(WMI)情報。
-
実行中のプロセス。
-
%PROGRAMDATA%\Citrix\CDFに保存されているCitrixプロセスのクラッシュダンプ。 -
Citrixポリシー情報(CSV形式)。
-
インストールおよびアップグレード情報。収集される情報には、製品の完全なメタインストーラーログ、失敗した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トレースは、他の診断情報とともに収集されます。
-
最大サイズ (デフォルト = 10 MB) とスライス期間は、
Enable-CitrixTraceコマンドレットまたはHKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Telemetry DefaultListenレジストリ文字列を使用して変更できます。 -
トレースは、ファイルが
MaxSizeの 10% に達するまでファイルに追加されます。
Scout が収集するデータポイントのリストについては、「Call Home の主要なデータポイント」を参照してください。
Scout の構成
Scout は Linux VDA で動作するように構成できます。Linux VDA とテレメトリの詳細については、「Citrix Telemetry Service との統合」を参照してください。
Linux VDA は、
ctxtelemetry ソケットポートまたはテレメトリサービス用のポートを自動的に変更する場合があります。その場合は、ポートを手動で構成する必要があります。
-
C:\Program Files\Citrix\Telemetry Service に移動します。
-
ScoutUI.exe.config ファイルを開きます。
-
LinuxVDATelemetryServicePort または LinuxVDATelemetryWakeupPort の値を、Linux VDA で構成された値に変更します。
-
<add key="LinuxVDATelemetryServicePort" value="7502"/> -
<add key="LinuxVDATelemetryWakeupPort" value="7503"/>
-
変更を保存してファイルを閉じます。
-
最新の構成が読み込まれていることを確認するために、Scout を再度開きます。
ヘルスチェックについて
ヘルスチェックデータは、
C:\ProgramData\Citrix\TelemetryService\の下のフォルダーに保存されます。
サイトのヘルスチェック
サイトヘルスチェックは、FlexCast Management Architecture (FMA) サービスの包括的な評価を提供する環境テストサービスに含まれています。これらのチェックは、サービスの可用性を確認するだけでなく、データベース接続などの他のヘルスインジケーターも探します。
サイトヘルスチェックは、Delivery Controllerで実行されます。サイトの規模によっては、これらのチェックの完了には最大1時間かかる場合があります。
Delivery Controller の構成チェック
サイトの健全性チェックの一環として、Delivery Controller の構成チェックでは、Virtual Apps and Desktops サイトに関する Citrix の推奨事項に基づいて、以下の問題が存在するかどうかを確認します。
-
1 つ以上の Delivery Controller が失敗状態にある。
-
サイトに Delivery Controller が 1 つしかない。
-
Delivery Controller のバージョンが異なる。
健全性チェックの 権限と要件 を満たすことに加えて、Delivery Controller の構成チェックには以下が必要です。
-
少なくとも 1 つの Controller の電源がオンになっていること。
-
Controller 上で Broker Service が実行されていること。
-
Controller からサイトデータベースへの接続が機能していること。
VDA の健全性チェック
VDA の健全性チェックは、一般的な VDA 登録、セッション起動、およびタイムゾーンリダイレクトの問題の考えられる原因を特定します。
VDA での登録について、Scout は以下をチェックします。
-
VDA ソフトウェアのインストール
-
VDA マシンのドメインメンバーシップ
-
VDA 通信ポートの可用性
-
VDA サービスステータス
-
Windows ファイアウォール構成
-
Controller との通信
-
Controller との時刻同期
-
VDA 登録ステータス
VDA でのセッション起動について、Scout は以下を確認します。
-
セッション起動通信ポートの可用性
-
セッション起動サービスのステータス
-
セッション起動 Windows ファイアウォール構成
-
VDA リモートデスクトップサービス クライアントアクセスライセンス
-
VDA アプリケーション起動パス
-
セッション起動レジストリ設定
VDAでのタイムゾーンリダイレクトについて、Scoutは以下をチェックします。
-
Windows ホットフィックスのインストール
-
Citrix ホットフィックスのインストール
-
Microsoft グループポリシー設定
-
Citrix グループポリシー設定
VDAでのプロファイル管理について、Scoutは以下をチェックします。
-
ハイパーバイザーの検出
-
プロビジョニングの検出
-
シトリックス バーチャル アプリおよびデスクトップ
-
Personal vDiskの構成
-
ユーザーストア
-
プロファイル管理サービスのステータス検出
-
Winlogon.exeフッキングテスト
Profile Management のチェックを実行するには、VDA に Profile Management をインストールして有効にする必要があります。Profile Management の構成チェックの詳細については、Knowledge Center の記事 CTX132805 を参照してください。
StoreFront のヘルスチェック
StoreFront のチェックでは、以下を確認します。
-
Citrix Default Domainサービスが実行されていること
-
Citrix Credential Walletサービスが実行されていること
-
StoreFrontサーバーからActive Directoryポート88への接続
-
StoreFrontサーバーからActive Directoryポート389への接続
-
ベースURLが有効なFQDNであること
-
ベースURLから正しいIPアドレスを取得できること
-
IISアプリケーションプールが.NET 4.0を使用していること
-
証明書がホストURLのSSLポートにバインドされているかどうか
-
証明書チェーンが完全であるかどうか
-
証明書の有効期限が切れているかどうか
-
証明書の有効期限が間もなく切れるかどうか(30日以内)
ライセンスサーバーのチェック
ライセンスサーバーのチェックでは、以下を確認します。
-
Delivery Controllerからのライセンスサーバー接続
-
License Server ファイアウォールのリモートアクセスステータス
-
Citrix Licensing サービスのステータス
-
License Server のライセンスキャッシュモードの状態
-
License Server ポートの接続
-
Citrix ベンダーデーモン (CITRIX) が実行中であるかどうか
-
システムクロックが同期されているかどうか
-
Citrix Licensing サービスがローカルサービスアカウントで実行されているかどうか
-
CITRIX.optファイルの存在 -
Customer Success Services の資格取得日
-
シトリックス ライセンス サーバー アップデート
-
License Server 証明書が Delivery Controller の信頼されたルートストアにあるかどうか
ヘルスチェックの権限と要件を満たすことに加えて、ライセンスサーバーはドメインに参加している必要があります。そうでない場合、ライセンスサーバーは検出されません。
ヘルスチェックの実行
ヘルスチェックの手順は、マシンの選択、チェックの開始、結果レポートの確認で構成されます。
-
マシンを選択します。「Find machine」をクリックしてマシンを検出します。「Select machines」ページには、サイトで検出されたすべてのVDA、Delivery Controller、およびライセンスサーバーが一覧表示されます。マシン名で表示をフィルターできます。診断を収集する各マシンの横にあるチェックボックスをオンにして、「Continue」をクリックします。その他のコンポーネントタイプ(StoreFrontサーバーやVDAマシンなど)を追加するには、「Add machines manually」および「Import VDA machines」を参照してください。Citrix Provisioning™サーバーまたはライセンスサーバーを手動で追加することはできません。Scoutは、選択された各マシンで検証テストを自動的に起動し、「Verification tests」に記載されている基準を満たしていることを確認します。検証に失敗すると、「Status」列にメッセージが表示され、そのマシンのチェックボックスがオフになります。次のいずれかを実行できます。
-
問題を解決してから、マシンのチェックボックスを再度オンにします。これにより、検証テストが再試行されます。
-
そのマシンをスキップします(チェックボックスをオフのままにします)。そのマシンではヘルスチェックは実行されません。
検証テストが完了したら、「Continue」をクリックします。 -
-
選択したマシンでヘルスチェックを実行します。概要には、テストが実行されるマシン(検証テストに合格した選択済みのマシン)が一覧表示されます。「Start Checking」をクリックします。チェック中およびチェック後:
-
「Status」列は、マシンの現在のチェック状態を示します。
-
進行中のすべてのチェックを停止するには、ページ右下隅にある「Stop Checking」をクリックします。(単一のマシンのヘルスチェックをキャンセルすることはできず、選択されているすべてのマシンのみをキャンセルできます。チェックが完了したマシンからの情報は保持されます。
-
選択されたすべてのマシンのチェックが完了すると、右下隅の「Stop Checking」ボタンが「Done」に変わります。
-
チェックに失敗した場合は、「Action」列の「Retry」をクリックできます。
-
チェックが問題なく完了した場合、「Action」列は空になります。
-
チェックで問題が見つかった場合は、「View Details」をクリックして結果を表示します。
-
選択されたすべてのマシンのチェックが完了した後、「Back」をクリックしないでください。(クリックすると、チェック結果が失われます)。
-
-
チェックが完了したら、完了をクリックしてScoutの開始ページに戻ります。
ヘルスチェックの結果
レポートを生成するCitrixチェックの場合、レポートには以下が含まれます。
-
結果レポートが生成された日時
-
チェックされたマシン
-
ターゲットマシンでチェックが探した条件
権限と要件
権限:
-
診断情報を収集するには:
-
診断情報を収集する各マシンで、ローカル管理者およびドメインユーザーである必要があります。
-
各マシンで LocalAppData ディレクトリへの書き込み権限が必要です。
-
-
ヘルスチェックを実行するには:
-
ドメインユーザーグループのメンバーである必要があります。
-
フル管理者であるか、サイトに対する読み取り専用および Run Environment Tests 権限を持つカスタムロールを持っている必要があります。
-
スクリプトの実行を許可するには、スクリプト実行ポリシーを少なくとも
RemoteSignedに設定します。例:Set-ExecutionPolicy RemoteSigned。注: 他のスクリプト実行権限でも機能する場合があります。
-
-
Scout の起動時には、管理者として実行を使用します。
診断情報を収集したり、ヘルスチェックを実行したりする各マシンについては、次のとおりです。
-
Scoutがそのマシンと通信できる必要があります。
-
ファイルとプリンターの共有が有効になっている必要があります。
-
PSRemotingとWinRMが有効になっている必要があります。また、そのマシンではPowerShell 3.0以降が実行されている必要があります。
-
Citrix Telemetry Serviceがそのマシンで実行されている必要があります。
-
Windows Management Infrastructure (WMI)へのアクセスがそのマシンで有効になっている必要があります。
-
診断情報収集のスケジュールを設定するには、そのマシンで互換性のあるScoutバージョンが実行されている必要があります。
パス名で指定するユーザー名にドル記号 ($) を使用しないでください。診断情報の収集が妨げられます。
Scoutは、選択したマシンで検証テストを実行し、これらの要件が満たされていることを確認します。
Windows用Telemetry Serviceは、Network Serviceで実行されます。
AOTトレースフォルダーは
C:\ProgramData\Citrix\TelemetryService\CitrixAOTに保存されます。
Administratorグループ、System、およびTelemetry Service SIDのユーザーのみが、
HKEYLOCALMACHINE:SOFTWARE\Citrix\Telemetryレジストリにアクセスする権限を持っています。
テレメトリサービスをアンインストールした後も、テレメトリサービスSIDはパフォーマンスログユーザーグループに残りますが、手動で削除できます。
検証テスト
診断コレクションまたはヘルスチェックが開始される前に、選択された各マシンに対して検証テストが自動的に実行されます。これらのテストは、要件が満たされていることを確認します。マシンでテストが失敗した場合、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 の新しいバージョンが必要です - (バージョンは、Collect および Trace & Reproduce のみで確認されます。) マシン上の Telemetry Service のバージョンをアップグレードしてください (インストールとアップグレードを参照)。サービスをアップグレードしない場合、そのマシンは Collect または Trace & Reproduce アクションに含まれません。
-
Scout がこのマシン上の systemd ソケットに接続できません - 以下を確認してください。
-
ポート 7503 が開いていることを確認します。
systemd ctxtelemetry.socketがマシン上のポート 7503 でリッスンしていることを確認します。ctxtelemetry.socketポートが変更されている場合、ポートが異なる可能性があります。ポートを調整するには、Scout の構成を参照してください。 -
ネットワーク接続が正常に機能していることを確認します。(これには、ファイアウォールが適切に構成されていることの確認が含まれる場合があります。)
-
-
このマシンで Linux VDA Telemetry Service が開始されていません - 以下を確認してください。
-
ポート 7502 が開いていることを確認します。Linux VDA Telemetry Service がマシンにインストールされ、開始されていることを確認します。テレメトリサービスポートが変更されている場合、ポートが異なる可能性があります。ポートを調整するには、Scout の構成を参照してください。
-
ネットワーク接続が正常に機能していることを確認します。(これには、ファイアウォールが適切に構成されていることの確認が含まれる場合があります。)
-
バージョン互換性
このバージョンの Scout (3.x) は、Citrix Virtual Apps and Desktops (または XenApp and XenDesktop 7.14 以降) のコントローラーおよび VDA で実行することを目的としています。
| 機能 | スカウト 2.23 | スカウト 3.0 | --- | --- | ---| -- | Citrix Virtual Apps and Desktops (および XenApp and XenDesktop 7.14 ~ 7.18) のサポート | はい | はい XenDesktop 5.x、7.1~7.13をサポート | はい | いいえ XenApp 6.x、7.5~7.13をサポート | はい | いいえ 製品に同梱 | 7.1~7.13 | 7.14以降 CTX記事からダウンロード可能 | はい | いいえ CDFトレースをキャプチャ | はい | はい Always-on-Traces (AOT) をキャプチャ | いいえ | はい 診断データの収集を許可 | 一度に最大10台のマシン(デフォルト) | 無制限(リソースの可用性による) 診断データをCitrixに送信することを許可 | はい | はい 診断データをローカルに保存することを許可 | はい | はい Citrix Cloud™ 資格情報をサポート | いいえ | はい Citrix資格情報のサポート | はい | はい アップロード用プロキシサーバーのサポート | はい | はい スケジュールの調整 | 該当なし | はい スクリプトのサポート | コマンドライン(ローカルControllerのみ) | Call Homeコマンドレットを使用したPowerShell(Telemetry Serviceがインストールされている任意のコンピューター) ヘルスチェック | いいえ | はい データマスキング | いいえ | 3.17以降
インストールとアップグレード
デフォルトでは、VDAまたはControllerをインストールまたはアップグレードすると、Citrix Telemetry Serviceの一部としてScoutが自動的にインストールまたはアップグレードされます。
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トレースは収集されません。ただし、他のすべてのトレース情報は収集されます。
VDA マシンをインポートする
ヘルスチェック の実行時に、展開内の VDA マシンをインポートできます。
-
Delivery Controller または Connector で、PowerShell コマンドを使用してマシンリストファイルを生成します。Connector では、Citrix 資格情報を入力し、ポップアップダイアログで顧客を選択する必要があります。
Get-BrokerMachine| foreach { $_.DnsName } | out-file C:\machineList.txt -
machineList.txtファイルを、Scout Health Checkを起動するドメイン参加済みマシンにコピーします。
-
machineList.txtファイルを選択します。
インポートされた VDA マシンが Scout Health Check ページに一覧表示されます。
診断情報の収集
-
マシンを選択します。
-
Controllerでは、 ページにサイト内のすべてのVDAとControllerが一覧表示されます。表示はマシン名でフィルターできます。他のマシン(StoreFrontやCitrix Provisioningサーバーなど)を手動で追加するには、「Add machines manually」を参照してください。
Scoutは、選択された各マシンで検証テストを自動的に起動し、「Verification tests」に記載されている基準を満たしていることを確認します。検証に失敗すると、 列にメッセージが表示され、そのマシンのチェックボックスはオフになります。次のいずれかを実行できます。-
問題を解決してから、マシンのチェックボックスを再度オンにします。これにより、検証テストが再実行されます。
-
そのマシンをスキップします(チェックボックスをオフのままにします)。そのマシンからは診断情報は収集されません。
-
-
収集中:
-
選択したすべてのマシンでコレクションが完了したら、戻るをクリックしないでください。(クリックすると、コレクションは失われます。)
コレクションが完了したら、続行をクリックします。 -
コレクションを保存またはアップロードします。ファイルをCitrixにアップロードするか、ローカルマシンに保存するかを選択します。今すぐファイルをアップロードする場合は、手順5に進みます。ファイルをローカルに保存することを選択した場合:
-
Windowsの保存ダイアログボックスが表示されます。目的の場所に移動します。
-
ローカル保存が完了すると、ファイルのパス名が表示され、リンクされます。ファイルを表示できます。後でファイルをCitrixにアップロードできます。CTX136396を参照してください。
完了をクリックしてScoutの開始ページに戻ります。この手順でこれ以上ステップを完了する必要はありません。 -
-
アップロードの認証を行い、必要に応じてプロキシを指定します。詳細については、アップロードの承認を参照してください。
-
Scoutを通じて認証していない場合は、この手順に進みます。
-
Scoutを通じて認証済みの場合、保存されている認証トークンがデフォルトで使用されます。これを行う場合は、このオプションを選択して続行をクリックします。このコレクションの資格情報は要求されません。手順6に進みます。
-
以前に認証済みで、再認証して新しいトークンを取得したい場合は、変更/再認証をクリックしてこの手順に進みます。
アップロードを認証するためにCitrix資格情報を使用するか、Citrix Cloud資格情報を使用するかを選択します。続行をクリックします。資格情報ページは、保存されたトークンを使用していない場合にのみ表示されます。資格情報ページで:-
ファイルアップロードにプロキシサーバーを使用したい場合は、プロキシの構成をクリックします。Scoutにブラウザのインターネットプロパティで構成されているプロキシ設定を使用するように指示できます。または、プロキシサーバーのIPアドレスとポート番号を入力することもできます。プロキシダイアログボックスを閉じます。
-
Citrix Cloudアカウントの場合は、トークンを生成をクリックします。デフォルトのブラウザがCitrix Cloudページを起動し、トークンが表示されます。トークンをコピーし、Scoutページに貼り付けます。
-
Citrixアカウントの場合は、資格情報を入力します。
完了したら、続行をクリックします。 -
-
アップロードに関する情報を入力します。
-
名前フィールドには、収集された診断ファイルのデフォルト名が含まれています。名前を変更することはできますが、ほとんどのコレクションではこれで十分です。(デフォルト名を削除して名前フィールドを空のままにした場合、デフォルト名が使用されます。)
-
オプションで、8桁のCitrixサポートケース番号を指定します。
-
オプションの説明フィールドに、問題について説明し、該当する場合は問題が発生した時期を示します。
完了したら、アップロードを開始をクリックします。アップロード中、ページの左下部分に、完了したアップロードのパーセンテージが概算で表示されます。進行中のアップロードをキャンセルするには、アップロードを停止をクリックします。アップロードが完了すると、その場所のURLが表示され、リンクされます。リンクをたどってCitrixの場所にアクセスし、アップロードの分析を表示したり、リンクをコピーしたりできます。完了をクリックしてScoutの開始ページに戻ります。 -
トレースと再現
トレースと再現の手順は、マシンの選択、トレースの開始、問題の再現、診断コレクションの完了、そしてファイルをCitrixにアップロードするか、ローカルに保存することから構成されます。
この手順は、標準の収集手順に似ています。ただし、マシンでトレースを開始し、それらのマシンで問題を再作成することができます。すべての診断コレクションにはAOTトレース情報が含まれています。この手順では、トラブルシューティングに役立つCDFトレースが追加されます。
-
Scoutを起動します。マシンのスタートメニューから、Citrix > Citrix Scoutを選択します。開始ページで、トレースと再現をクリックします。
-
マシンを選択します。Select machinesページには、サイト内のすべてのVDAとControllerが一覧表示されます。マシン名で表示をフィルタリングできます。トレースと診断を収集する各マシンの横にあるチェックボックスをオンにします。その後、Continueをクリックします。その他のマシンを手動で追加するには (StoreFrontまたはCitrix Provisioningサーバーなど)、マシンを手動で追加するを参照してください。Scoutは、選択した各マシンで検証テストを自動的に起動し、Verification testsに記載されている基準を満たしていることを確認します。マシンの検証が失敗した場合、Status列にメッセージが表示され、そのマシンのチェックボックスはオフになります。次のいずれかを実行できます。
-
問題を解決してから、そのマシンのチェックボックスを再度オンにします。これにより、検証テストが再試行されます。
-
そのマシンをスキップします(チェックボックスをオフのままにします)。そのマシンからは診断情報とトレースは収集されません。
検証テストが完了したら、Continueをクリックします。 -
-
トレースを開始します。概要には、トレースが収集されるすべてのマシンが一覧表示されます。Start Tracingをクリックします。選択した1台以上のマシンで、発生した問題を再現します。その間、トレースの収集は続行されます。問題の再現が完了したら、ScoutでContinueをクリックします。これによりトレースが停止します。トレースを停止した後、トレース中に問題を再現したかどうかを示します。
-
マシンから診断情報を収集します。Start Collectingをクリックします。収集中に:
-
Status列には、マシンの現在の収集状態が表示されます。
-
単一マシンで進行中の収集を停止するには、そのマシンのAction列にあるCancelをクリックします。
-
進行中のすべての収集を停止するには、ページの右下隅にあるStop Collectionをクリックします。収集が完了したマシンからの診断情報は保持されます。収集を再開するには、各マシンのAction列にあるRetryをクリックします。
-
選択したすべてのマシンで収集が完了すると、右下隅にあるStop CollectionボタンがContinueに変わります。
-
マシンから診断情報を再度収集するには、そのマシンのAction列にあるCollect Againをクリックします。新しい収集は以前の収集を上書きします。
-
コレクションが失敗した場合は、アクション列の再試行をクリックできます。正常に完了したコレクションのみがアップロードまたは保存されます。
-
選択したすべてのマシンでコレクションが完了したら、戻るをクリックしないでください。(クリックすると、コレクションは失われます。)
収集が完了したら、続行をクリックします。 -
-
コレクションを保存またはアップロードします。ファイルをCitrixにアップロードするか、ローカルに保存するかを選択します。今すぐファイルをアップロードする場合は、手順6に進みます。ファイルをローカルに保存する場合は、次の手順を実行します。
-
Windowsの保存ダイアログボックスが表示されます。目的の場所を選択します。
-
ローカル保存が完了すると、ファイルのパス名が表示され、リンクされます。ファイルを表示できます。注意: ファイルは後でCitrixからアップロードできます。Citrix Insight Servicesについては、CTX136396を参照してください。
完了をクリックしてScoutの開始ページに戻ります。この手順でこれ以上完了する必要のある手順はありません。 -
-
アップロードの認証を行い、必要に応じてプロキシを指定します。このプロセスの詳細については、アップロードの承認を確認してください。
-
Scoutを介して認証していない場合は、この手順に進みます。
-
Scoutを介して認証した場合、保存されている認証トークンがデフォルトで使用されます。これを行う場合は、このオプションを選択して続行をクリックします。このコレクションの資格情報は求められません。手順7に進みます。
-
以前に認証済みで、再認証して新しいトークンを取得したい場合は、変更/再認証をクリックしてこの手順に進みます。
アップロードを認証するためにCitrix資格情報を使用するか、Citrix Cloud資格情報を使用するかを選択します。続行をクリックします。資格情報ページは、保存されたトークンを使用していない場合にのみ表示されます。資格情報ページで:-
ファイルアップロードにプロキシサーバーを使用したい場合は、「Configure proxy」をクリックします。Scoutにブラウザのインターネットプロパティで設定されているプロキシ設定を使用するよう指示できます。または、プロキシサーバーのIPアドレスとポート番号を入力することもできます。プロキシダイアログボックスを閉じます。
-
Citrix Cloudアカウントの場合、「Generate token」をクリックします。デフォルトのブラウザがCitrix Cloudページを起動し、トークンが表示されます。トークンをコピーし、Scoutページに貼り付けます。
-
Citrixアカウントの場合、資格情報を入力します。
完了したら、「Continue」をクリックします。 -
-
アップロードに関する情報を提供します。アップロードの詳細を入力します。
-
名前フィールドには、収集された診断ファイルのデフォルト名が含まれています。ほとんどの収集ではこれで十分ですが、名前を変更することもできます。(デフォルト名を削除して名前フィールドを空にした場合でも、デフォルト名が使用されます。)
-
必要に応じて、8桁のCitrixサポートケース番号を指定します。
-
オプションの「説明」フィールドに、問題を説明し、該当する場合は問題が発生した時期を示します。
完了したら、「Start Upload」をクリックします。アップロード中、ページの左下部分に、アップロードの完了率がおおよそ表示されます。進行中のアップロードをキャンセルするには、「Stop Upload」をクリックします。アップロードが完了すると、その場所のURLが表示され、リンクされます。リンクをたどってCitrixの場所に移動し、アップロードの分析を表示したり、リンクをコピーしたりできます。「Done」をクリックしてScoutの開始ページに戻ります。 -
ScoutはTraceLoggingプロバイダーをサポートします
以前、ScoutはWindowsパフォーマンスプロバイダーのみをサポートしていました。これは追加のデコードファイルを必要とし、同じプロバイダーの単一セッションからのセッションとイベントのみをトレースしていました。
Citrix Virtual Apps and Desktops バージョン 2411 以降、Scout は TraceLogging プロバイダーをサポートします。このプロバイダーは、追加のデコードファイルを必要とせず、同じプロバイダーに対して最大 8 つのトレースセッションからイベントを有効にして受信できます。この機能はデフォルトで有効になっています。
追加のログ収集を有効にする
追加のログ収集を有効にする機能を使用すると、perfmon、Netsh、DebugView、Wireshark などのより多くのツールでトレースおよび再現機能を使用できます。
2407 リリース以降、追加のログ収集を有効にすると、Scout はマシンにインストールされている CDC 関連ツールを自動的に検出し、CDC ツール関連のトレースログを zip パッケージに自動収集します。これらの zip ファイルをカスタマイズして Scout に添付できます。この自動化により、Citrix Scout をより効果的に使用でき、問題の迅速な診断に役立ちます。
注:
これはローカルマシンにのみ適用されます。
追加のログ収集を設定するには:
-
Citrix Scout を起動します。
-
設定ギアをクリックします。
-
追加のログ収集をより多くのツールで有効にするをクリックします。
-
保存をクリックします。

追加のログ収集を有効にするには、次の必要なツールがインストールされており、指定された場所にディレクトリが手動で作成されていることを確認してください。
ツールのインストール場所:
-
Procdump ログ: Procdump をダウンロードし、%ProgramData%\Citrix\TelemetryService\CDC\Lib\Resources\Tools\Procdump\procdump.exe に配置します。
-
StoreFrontログ: DbgViewをダウンロードし、%ProgramData%\Citrix\TelemetryService\CDC\Lib\Resources\Tools\DebugView\Dbgview.exeに配置します。
-
Procmonログの収集: Process Monitorをダウンロードし、%ProgramData%\Citrix\TelemetryService\CDC\Lib\Resources\Tools\ProcessMonitor\Procmon.exeに配置します。
-
Wiresharkログ: システムにWiresharkを手動でインストールします。
追加のログを収集するには:
-
Scout のホームページで、トレースと再現をクリックします。
-
データを収集する マシンの選択または追加 ページで、ローカルマシンのチェックボックスをオンにします。ステータスは Verified と表示されている必要があります。
-
「続行」をクリックし、トレースと再現の手順に従います。
-
完了後、zip ファイル内のログを確認します。ログは CDCLogs フォルダーに圧縮されています。
注:
Procmonツールがトレース用に選択されている場合、Process Monitorログはすぐに大きくなる可能性があります。必要なツールのみを選択するようにしてください。ログのサイズは*%temp%\Scout-CDC-Log*で監視することもできます。
コレクションのスケジュール
注:
現在、コレクションはスケジュールできますが、ヘルスチェックはスケジュールできません。
スケジュール手順は、マシンを選択し、スケジュールを設定またはキャンセルすることで構成されます。スケジュールされたコレクションは自動的にCitrixにアップロードされます。(PowerShellインターフェイスを使用して、スケジュールされたコレクションをローカルに保存できます。Citrix Call Homeを参照してください。)
-
Scoutを起動します。マシンのスタートメニューから、Citrix > Citrix Scoutを選択します。開いたページで、Scheduleをクリックします。
-
マシンを選択します。サイト内のすべてのVDAとコントローラーが一覧表示されます。マシン名で表示をフィルターできます。グラフィカルインターフェイスを使用してVDAとコントローラーをインストールしたときに、Call Homeスケジュールを設定した場合 ((/ja-jp/citrix-virtual-apps-desktops/2411/manage-deployment/cis.html#citrix-call-home)を参照)、Scoutはデフォルトでそれらの設定を表示します。このバージョンのScoutを使用して、スケジュールされたコレクションを初めて開始したり、以前に構成したスケジュールを変更したりできます。コンポーネントのインストール中にマシンごとにCall Homeを有効/無効にした場合でも、Scoutで構成されたスケジュールは、選択したすべてのマシンに影響します。診断情報を収集する各マシンの横にあるチェックボックスをオンにして、「続行」をクリックします。その他のマシン(StoreFrontサーバーやCitrix Provisioningサーバーなど)を手動で追加するには、「Add machines manually」を参照してください。Scoutは、選択した各マシンで検証テストを自動的に起動し、Verification testsの基準を満たしていることを確認します。マシンの検証に失敗した場合、**「Status」**列にメッセージが表示され、そのマシンのチェックボックスはオフになります。次のいずれかを実行できます。
-
問題を解決してから、マシンのチェックボックスをもう一度選択します。これにより、検証テストが再試行されます。
-
そのマシンをスキップします(チェックボックスをオフのままにします)。そのマシンからは診断(またはトレース)は収集されません。
検証テストが完了したら、Continueをクリックします。概要ページには、スケジュールが適用されるマシンが一覧表示されます。Continueをクリックします。 -
-
スケジュールを設定します。診断情報を収集するタイミングを指定します。注意:スケジュールは、選択したすべてのマシンに影響します。
-
選択したマシンの週次スケジュールを構成するには、**「Weekly」**をクリックします。曜日を選択します。収集を開始する時刻(24時間形式)を入力します。
-
選択したマシンの日次スケジュールを構成するには、**「Daily」**をクリックします。収集を開始する時刻(24時間形式)を入力します。
-
選択したマシンの既存のスケジュールをキャンセルするには(別のスケジュールに置き換えない場合)、**「Off」**をクリックします。これにより、それらのマシンに対して以前に構成されたスケジュールがすべてキャンセルされます。
続行をクリックします。 -
-
アップロードの認証を行い、必要に応じてプロキシを指定します。このプロセスの詳細については、アップロードの承認 を参照してください。注意: Scout スケジュールを使用している場合、保存されたトークンを使用して認証することはできません。資格情報ページで:
-
Citrix アカウントの場合は、資格情報を入力します。
コレクション中、選択された各マシンの Windows アプリケーションログには、コレクションとアップロードに関するエントリが含まれます。
データマスキング
Citrix Scout を使用して収集された診断情報には、セキュリティ上機密性の高い情報が含まれる場合があります。Citrix Scout のデータマスキング機能を使用すると、診断ファイルを Citrix にアップロードする前に、機密データをマスクできます。
Scout のデータマスキングは、IP アドレス、マシン名、ドメイン名、ユーザー名、ハイパーバイザー名、デリバリーグループ名、カタログ名、アプリケーション名、および SID をマスクするように構成されています。
注:
CDF トレースは暗号化されており、マスクできません。
Linux VDA ログは
.tar.gz2 形式に圧縮されており、マスクできません。
新しい診断情報を収集し、データマスキングを実行する
Citrix Scoutのデータマスキング機能を使用するには、コマンドラインからScoutを起動します。
-
Windowsで、コマンドプロンプトを管理者として開きます。
-
Scoutがインストールされているディレクトリに移動します:
cd C:\Program Files\Citrix\Telemetry Service。 -
Scoutを起動します:
ScoutUI.exe datamasking。 -
診断情報を収集するには、Collect または Trace & Reproduce をクリックします。
-
収集が完了したら、Enable data masking を選択します。このオプションはデフォルトで有効になっています。
-
データマスクを構成します。デフォルトのルールを使用することも、ルールをカスタマイズすることもできます。
-
診断情報の収集をアップロードするか保存するかを選択します。
-
Upload the diagnostics collection to Citrixを選択した場合、マスクされた診断ファイルはCitrixにアップロードされます。
-
Save the diagnostics collection on your local machineを選択した場合、元の診断情報とマスクされた診断情報の両方が指定された場所に保存されます。
-
既存の診断情報に対してデータマスキングを実行する
-
Windowsで、コマンドプロンプトを管理者として開きます。
-
Scoutがインストールされているディレクトリに移動します:
cd C:\Program Files\Citrix\Telemetry Service。 -
データマスキングモードでScoutを直接起動します:
ScoutUI.exe datamasking filePath。 -
[データマスキングを有効にする]を選択して続行します。このオプションは既定で有効になっています。
-
データマスクを構成します。既定のルールでデータマスキングを実行することも、ルールをカスタマイズすることもできます。
-
診断データをアップロードするか保存するかを選択します。
-
診断データを Citrix にアップロード を選択すると、マスキング済みの診断ファイルが Citrix にアップロードされます。
-
診断データをローカルマシンに保存 を選択すると、元の診断データとマスキング済みの診断データの両方が指定した場所に保存されます。
-
マスキング済みデータファイルとマッピングファイルの場所
診断データをアップロードまたは保存した後、リンクをクリックして元の診断データ、マスキング済み診断データ、およびマッピング情報ファイルを開きます。
使用状況データの収集
Scout の使用時に、Citrix は Google Analytics を使用して匿名の使用状況データを収集し、将来の製品機能や改善に活用します。データ収集は既定で有効になっています。
使用状況データの収集とアップロードを変更するには、Scout UI の 設定 歯車アイコンをクリックします。はい または いいえ を選択し、保存 をクリックして、情報を送信するかどうかを指定できます。
Scout 機能のコマンドラインインターフェイス
Scout の機能をコマンドラインインターフェイスから使用できるため、Scout UI を開かずに必要なログやデータを収集できます。上級ユーザーは、対象のマシンやサイトに対するログ記録やトレースを、ローカルまたはリモートで自動化できます。この機能は既定で有効になっています。
次の機能のコマンドが追加されています。
注:
リモートトレースセッションを実行する際は、VDAとDDCの両方に新しいテレメトリバージョンをインストールする必要があります。このインストールが必要なのは、ScoutコマンドラインがCitrix Virtual Apps and Desktopsバージョン2411以降でサポートされており、
TelemetryServiceの以前のバージョンではこの機能がサポートされていないためです。
次の表に、新しく追加されたコマンドを示します。
ヘルプ
| コマンドラインインターフェイス | 説明 | 例 |
|---|---|---|
ScoutCLI.exe -h |
コンテキストに応じたヘルプを表示します。 | ScoutCLI.exe -h |
ScoutCLI.exe -help |
診断情報を収集するためのコマンド
| コマンドラインインターフェイス | 説明 | 例 |
|---|---|---|
ScoutCLI.exe Collect -exclude <collector> |
指定されたコレクター(Windows Management Instrumentation (WMI) プロセス、レジストリ、クラッシュレポート、ヘッダー、トレース、msi、vcu、ツールテレメトリ、およびローカルデータ)からの診断を除外します。 |
ScoutCLI.exe collect -exclude wmi, localdata -output "C:/Logs/mydata.zip" |
ScoutCLI.exe Collect -output <filename> |
出力ログファイルを、サフィックスとして.zipを付けて保存する場所を指定します。 |
|
ScoutCLI.exe Collect -fqdn <hostname> |
サイト内の指定されたマシンで診断を収集します。 | ScoutCLI.exe collect -fqdn hostname -exclude wmi, localdata -output "C:/Logs/mydata.zip" |
トレースの開始
| コマンドラインインターフェイス | 説明 | 例 |
|---|---|---|
ScoutCLI.exe StartTrace -guids <filename (xxx.ctl)> |
指定されたGUIDのターゲットモジュールのログを収集します。 | ローカルマシンのトレース開始の例 - ScoutCLI.exe StartTrace -guids C:\Logs\provider1.ctl -output C:\Logs\xxx.etl -name session1 -level 16 -max 50; リモートマシンのトレース開始の例 - ScoutCLI.exe StartTrace -fqdn hostname -guids C:\Logs\provider1.ctl -output C:\Logs\xxx.etl -name session1 -level 16 -max 50 |
ScoutCLI.exe StartTrace -output <filename> |
出力ログファイルを、.etl をサフィックスとして保存する場所を指定します。 | |
ScoutCLI.exe StartTrace -name <session name> |
トレースセッションの名前を定義します。 | |
ScoutCLI.exe StartTrace -level <value> |
ターゲット診断の詳細をログに記録するログレベルを選択します。デフォルト値は16です。 | |
ScoutCLI.exe StartTrace -max <value> |
最大ログファイルサイズをMB単位で指定します。デフォルト値は50です。 | |
ScoutCLI.exe StartTrace -fqdn <hostname> |
サイト内の指定されたマシンでトレースを開始します。 |
トレースの停止
| コマンドラインインターフェイス | 説明 | 例 |
|---|---|---|
ScoutCLI.exe StopTrace -name <session name> |
指定されたトレースセッションを停止します。 | ScoutCLI.exe StopTrace -name session1 |
ScoutCLI.exe StopTrace -fqdn <hostname> |
サイト内の指定されたマシンでのトレースを停止します。リモートの .etl がコピーされるローカルパスを割り当てるには、-o オプションが必要です。 |
ScoutCLI.exe StopTrace -fqdn hostname -name session1 -output C:\Logs\xxx.etl |
ScoutCLI.exe StopTrace -output <filename> |
.etl をサフィックスとして持つ出力ログファイルを保存する場所を指定します。 |
進行中のトレースセッションを一覧表示
| コマンドラインインターフェイス | 説明 | 例 |
|---|---|---|
ScoutCLI.exe ListSession -name <session name> |
指定されたトレースセッションの詳細を表示します。名前が指定されていない場合は、実行中のすべてのトレースセッションの詳細を表示します。 | ScoutCLI.exe ListSession -name session1 |
ScoutCLI.exe ListSession -fqdn <hostname> |
サイト内の指定されたマシンでトレースの詳細を表示します。 | ScoutCLI.exe ListSession -fqdn hostname -name session1 |
CDC の開始と停止
| コマンドラインインターフェイス | 説明 | 例 |
|---|---|---|
ScoutCLI.exe StartCDC -config <filename> |
Citrix Diagnostic Collectors (CDC) ツールのパラメーターの JSON 構成ファイルを指定します。 | ScoutCLI.exe StartCDC -config xxx.json -path C:\Logs |
ScoutCLI.exe StartCDC -path <folder> |
出力ログファイルの保存場所を指定します。 | |
ScoutCLI.exe StopCDC |
CDC ツールの収集を停止します。 | ScoutCLI.exe StopCDC |