シトリックス スカウト
はじめに
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 回限りまたはスケジュールされた診断情報収集とアップロードを構成することもできます。(/ja-jp/citrix-virtual-apps-desktops/2203-ltsr/manage-deployment/cis.html#citrix-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 に保存されます。このファイルはトラブルシューティングに使用できます。
Citrix Scout のデモンストレーションを見る。
収集される情報
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トレースは、他の診断情報とともに収集されます。
-
Enable-CitrixTracecmdletまたはHKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Telemetry DefaultListenレジストリ文字列を使用して、最大サイズ(デフォルト = 10 MB)とスライス期間を変更できます。 -
トレースは、ファイルが
MaxSizeの10%に達するまでファイルに追加されます。
Scoutが収集するデータポイントのリストについては、「Call Home key datapoints」を参照してください。
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 上の Profile Management について、Scout は以下をチェックします。
-
ハイパーバイザーの検出
-
プロビジョニングの検出
-
シトリックス バーチャル アプリ アンド デスクトップ
-
Personal vDisk の構成
-
ユーザー ストア
-
Profile Management Service の状態検出
-
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からのライセンスサーバー接続
-
ライセンスサーバーのファイアウォールリモートアクセスステータス
-
Citrix Licensingサービスのステータス
-
ライセンスサーバーの猶予期間の状態
-
ライセンスサーバーポートの接続
-
Citrix ベンダーデーモン (CITRIX) が実行されているかどうか
-
システムクロックが同期されているかどうか
-
Citrix Licensing サービスがローカルサービスアカウントで実行されているかどうか
-
CITRIX.optファイルの存在 -
カスタマーサクセスサービス資格日
-
Citrix ライセンスサーバーの更新
-
ライセンスサーバー証明書がDelivery Controllerの信頼されたルートストアにあるかどうか
ヘルスチェックの権限と要件を満たすことに加えて、ライセンスサーバーはドメインに参加している必要があります。そうでない場合、ライセンスサーバーは検出されません。
ヘルスチェックの実行
ヘルスチェック手順は、マシンの選択、チェックの開始、および結果レポートの確認で構成されます。
-
マシンを選択します。 をクリックしてマシンを検出します。 ページには、サイトで検出されたすべての VDA、Delivery Controller、およびライセンスサーバーが一覧表示されます。表示はマシン名でフィルタリングできます。診断を収集する各マシンの横にあるチェックボックスをオンにして、 をクリックします。その他のコンポーネントタイプ(StoreFront サーバーや VDA マシンなど)を追加するには、「Add machines manually」および「Import VDA machines」を参照してください。Citrix Provisioning™ サーバーまたはライセンスサーバーを手動で追加することはできません。Scout は、選択された各マシンで検証テストを自動的に起動し、Verification tests に記載されている基準を満たしていることを確認します。検証に失敗した場合、 列にメッセージが表示され、そのマシンのチェックボックスがオフになります。次のいずれかを実行できます。
-
問題を解決してから、マシンのチェックボックスを再度オンにします。これにより、検証テストが再試行されます。
-
そのマシンをスキップします(チェックボックスは選択解除のままにします)。そのマシンではヘルスチェックは実行されません。
検証テストが完了したら、続行をクリックします。 -
-
選択したマシンでヘルスチェックを実行します。概要には、テストが実行されたマシン(検証テストに合格した選択済みのマシン)が一覧表示されます。チェック開始をクリックします。チェック中およびチェック後:
-
ステータス列は、マシンの現在のチェック状態を示します。
-
進行中のすべてのチェックを停止するには、ページ右下隅にあるチェック停止をクリックします。(単一のマシンのヘルスチェックをキャンセルすることはできず、選択したすべてのマシンのみをキャンセルできます。チェックが完了したマシンからの情報は保持されます。).
-
選択したすべてのマシンのチェックが完了すると、右下隅のチェック停止ボタンが完了に変わります。
-
チェックが失敗した場合は、アクション列の再試行をクリックできます。
-
チェックが問題なく完了した場合、アクション列は空になります。
-
チェックで問題が見つかった場合は、詳細表示をクリックして結果を表示します。
-
選択したすべてのマシンのチェックが完了した後、戻るをクリックしないでください。(クリックすると、チェック結果が失われます。)
-
-
チェックが完了したら、完了をクリックして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は、ネットワークサービスで実行されます。
AOTトレースフォルダーは
C:\ProgramData\Citrix\TelemetryService\CitrixAOTに保存されます。
Administratorグループ、System、およびTelemetry Service SIDのユーザーのみが、
HKEYLOCALMACHINE:SOFTWARE\Citrix\Telemetryレジストリにアクセスする権限を持っています。
Telemetry Serviceをアンインストールした後も、Telemetry Service SIDはPerformance Log Usersグループに残りますが、手動で削除できます。
検証テスト
診断コレクションまたはヘルスチェックが開始される前に、選択された各マシンに対して検証テストが自動的に実行されます。これらのテストは、要件が満たされていることを確認します。マシンのテストが失敗した場合、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 and XenDesktop 7.14にアップグレードしてください。
-
WMIがマシンで実行されていません - Windows Management Instrumentation (WMI) アクセスが有効になっていることを確認してください。
-
WMI接続がブロックされています - WindowsファイアウォールサービスでWMIを有効にしてください。
-
より新しいバージョンのCitrix Telemetry Serviceが必要です - (バージョンはCollectおよびTrace & Reproduceでのみチェックされます。) マシン上のTelemetry Serviceのバージョンをアップグレードしてください (インストールとアップグレードを参照)。サービスをアップグレードしない場合、そのマシンはCollectまたはTrace & Reproduceアクションに含まれません。
-
Scoutがこのマシン上のsystemdソケットに接続できません - 以下を確認してください。
-
ポート7503が開いていること。systemd ctxtelemetry.socketがマシン上のポート7503でリッスンしていることを確認してください。ctxtelemetry.socketポートが変更されている場合、ポートが異なる可能性があります。ポートを調整するには、Scoutの構成を参照してください。
-
ネットワーク接続が正しく機能していることを確認します。(これには、ファイアウォールが適切に構成されていることの確認が含まれる場合があります。)
-
-
このマシンでLinux VDAテレメトリーサービスが開始されていません - 以下を確認してください。
-
ポート7502が開いていることを確認します。Linux VDAテレメトリーサービスがマシンにインストールされ、開始されていることを確認します。テレメトリーサービスポートが変更されている場合、ポートが異なる可能性があります。ポートを調整するには、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が資格情報を検証すると、Scoutウィザードを続行できます。
-
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は自動的に検出したControllerと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 サーバーなど)を手動で追加するには、「マシンを手動で追加する」を参照してください。
診断情報を収集する各マシンの横にあるチェックボックスをオンにして、続行をクリックします。Scoutは、選択した各マシンで検証テストを自動的に起動し、検証テストに記載されている基準を満たしていることを確認します。検証に失敗すると、ステータス列にメッセージが表示され、そのマシンのチェックボックスがオフになります。次のいずれかを実行できます。-
問題を解決してから、そのマシンのチェックボックスを再度オンにします。これにより、検証テストが再試行されます。
-
そのマシンをスキップします(チェックボックスをオフのままにします)。そのマシンからは診断情報は収集されません。
検証テストが完了したら、続行をクリックします。 -
-
診断情報を収集します。概要には、診断情報が収集されるすべてのマシン(検証テストに合格した選択済みのマシン)が一覧表示されます。収集開始をクリックします。収集中:
-
ステータス列には、マシンの現在の収集状態が表示されます。
-
単一マシンでの進行中の収集を停止するには、そのマシンのアクション列にあるキャンセルをクリックします。
-
進行中のすべての収集を停止するには、ページの右下隅にある収集を停止をクリックします。収集が完了したマシンからの診断情報は保持されます。収集を再開するには、各マシンのアクション列にある再試行をクリックします。
-
選択したすべてのマシンで収集が完了すると、右下隅にある収集を停止ボタンが続行に変わります。
-
診断情報を再度収集するには、そのマシンのアクション列にある再度収集をクリックします。新しい収集は以前の収集を上書きします。
-
収集に失敗した場合は、アクション列にある再試行をクリックできます。正常に収集されたもののみがアップロードまたは保存されます。
-
選択したすべてのマシンで収集が完了した後、戻るをクリックしないでください。(クリックすると、収集は失われます。)
収集が完了したら、続行をクリックします。 -
-
コレクションを保存またはアップロードします。ファイルをCitrixにアップロードするか、ローカルマシンに保存するかを選択します。今すぐファイルをアップロードする場合は、手順5に進みます。ファイルをローカルに保存することを選択した場合:
-
Windowsの保存ダイアログボックスが表示されます。目的の場所に移動します。
-
ローカル保存が完了すると、ファイルのパス名が表示され、リンクされます。ファイルを表示できます。後でファイルをCitrixにアップロードできます。CTX136396を参照してください。
完了をクリックしてScoutの開始ページに戻ります。この手順でこれ以上ステップを完了する必要はありません。 -
-
アップロードの認証を行い、必要に応じてプロキシを指定します。詳細については、(#upload-authorization)を参照してください。
-
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」を選択します。開始ページで、「トレースと再現」をクリックします。
-
マシンを選択します。「マシンの選択」ページには、サイト内のすべてのVDAとControllerが一覧表示されます。マシン名で表示をフィルタリングできます。トレースと診断を収集する各マシンの横にあるチェックボックスをオンにします。次に、「続行」をクリックします。その他のマシンを手動で追加するには (StoreFrontまたはCitrix Provisioningサーバーなど)、マシンを手動で追加するを参照してください。Scout は、選択された各マシンで検証テストを自動的に起動し、検証テスト に記載されている基準を満たしていることを確認します。マシンの検証が失敗した場合、Status 列にメッセージが投稿され、そのマシンのチェックボックスは選択解除されます。次のいずれかを実行できます。
-
問題を解決してから、そのマシンのチェックボックスを再度選択します。これにより、検証テストが再試行されます。
-
そのマシンをスキップします(チェックボックスは選択解除のままにします)。そのマシンからは診断情報とトレースは収集されません。
検証テストが完了したら、Continue をクリックします。 -
-
トレースを開始します。概要には、トレースが収集されるすべてのマシンが一覧表示されます。Start Tracing をクリックします。選択したマシンのいずれかまたは複数で、発生した問題を再現します。その間、トレースの収集は続行されます。問題の再現が完了したら、Scout で Continue をクリックします。これによりトレースが停止します。トレースを停止した後、トレース中に問題を再現したかどうかを示します。
-
マシンから診断情報を収集します。Start Collecting をクリックします。収集中に:
-
Status 列には、マシンの現在の収集状態が表示されます。
-
単一マシンで進行中の収集を停止するには、そのマシンの Action 列にある Cancel をクリックします。
-
進行中のすべての収集を停止するには、ページの右下隅にある Stop Collection をクリックします。収集が完了したマシンからの診断情報は保持されます。収集を再開するには、各マシンの Action 列にある Retry をクリックします。
-
選択したすべてのマシンで収集が完了すると、右下隅の Stop Collection ボタンが Continue に変わります。
-
マシンから診断情報を再度収集するには、そのマシンの Action 列にある Collect Again をクリックします。新しい収集は以前のものを上書きします。
-
収集が失敗した場合、Action 列にある Retry をクリックできます。正常に収集されたもののみがアップロードまたは保存されます。
-
選択したすべてのマシンで収集が完了したら、Back をクリックしないでください。(クリックすると、収集は失われます。)
収集が完了したら、続行をクリックします。 -
-
コレクションを保存またはアップロードします。ファイルをCitrixにアップロードするか、ローカルに保存するかを選択します。今すぐファイルをアップロードする場合は、手順6に進みます。ファイルをローカルに保存する場合:
-
Windowsの保存ダイアログボックスが表示されます。目的の場所を選択します。
-
ローカル保存が完了すると、ファイルのパス名が表示され、リンクされます。ファイルを表示できます。注意: ファイルは後でCitrixからアップロードできます。Citrix Insight Servicesについては、CTX136396を参照してください。
完了をクリックしてScoutの開始ページに戻ります。この手順でこれ以上完了する必要のある手順はありません。 -
-
アップロードの認証を行い、必要に応じてプロキシを指定します。このプロセスの詳細については、アップロードの承認を参照してください。
-
Scoutを介して認証していない場合は、この手順に進みます。
-
Scoutを介して認証した場合、保存されている認証トークンがデフォルトで使用されます。この操作を行う場合は、このオプションを選択して続行をクリックします。このコレクションの資格情報は要求されません。手順7に進みます。
-
以前に認証済みで、再認証して新しいトークンを取得したい場合は、変更/再認証をクリックしてこの手順に進みます。
アップロードを認証するために、Citrix資格情報を使用するか、Citrix Cloud資格情報を使用するかを選択します。続行をクリックします。資格情報ページは、保存されたトークンを使用していない場合にのみ表示されます。資格情報ページで:-
ファイルアップロードにプロキシサーバーを使用する場合は、プロキシの構成をクリックします。Scoutに、ブラウザーのインターネットプロパティで構成されているプロキシ設定を使用するように指示できます。または、プロキシサーバーのIPアドレスとポート番号を入力することもできます。プロキシダイアログボックスを閉じます。
-
Citrix Cloudアカウントの場合、トークンの生成をクリックします。デフォルトのブラウザーがCitrix Cloudページを起動し、トークンが表示されます。トークンをコピーし、Scoutページに貼り付けます。
-
Citrixアカウントの場合は、資格情報を入力します。
完了したら、続行をクリックします。 -
-
アップロードに関する情報を提供します。アップロードの詳細を入力します。
-
名前フィールドには、収集された診断ファイルのデフォルト名が含まれています。ほとんどの収集ではこれで十分ですが、名前を変更することもできます。(デフォルト名を削除して名前フィールドを空のままにした場合、デフォルト名が使用されます。)
-
オプションで、8桁のCitrixサポートケース番号を指定します。
-
オプションの「説明」フィールドに、問題について説明し、該当する場合は問題が発生した時期を示します。
完了したら、アップロードの開始をクリックします。アップロード中、ページの左下部分にアップロードの完了率が概算で表示されます。進行中のアップロードをキャンセルするには、アップロードの停止をクリックします。アップロードが完了すると、その場所のURLが表示され、リンクされます。リンクをたどってCitrixの場所に移動し、アップロードの分析を表示したり、リンクをコピーしたりできます。完了をクリックして、Scoutの開始ページに戻ります。 -
追加のログ収集を有効にする
追加のログ収集を有効にする機能を使用すると、perfmon、Netsh、DebugView、Wiresharkなどのツールでトレースおよび再現機能を使用できます。
注:
これはローカルマシンにのみ適用されます。
追加のログ収集を設定するには:
-
Citrix Scout を起動します。
-
設定ギアをクリックします。
-
追加ツールによるログ収集を有効にするをクリックします。
-
「保存」をクリックします。
追加のログを収集するには:
-
Scout のホームページで、トレースと再現をクリックします。
-
マシンの選択ページで、ローカルマシンの右側にあるギアをクリックします。
-
ログ記録に必要なツールの選択ページで、ツールのダウンロードをクリックします。
-
ツールのダウンロードページで、使用したいツールを選択し、ダウンロードをクリックします。Wireshark を除くツールがダウンロードされます。Wireshark は手動でのみダウンロードおよびインストールできます。 注:他のツールを手動でダウンロードすることを選択した場合、ダウンロードした .zip ファイルの内容を
C:\ProgramData\Citrix\TelemetryService\CDC\Lib\Resources\Tools\<toolname>に抽出する必要があります。たとえば、DebugView.zip ファイルをダウンロードした場合、そのファイルの内容をC:\ProgramData\Citrix\TelemetryService\CDC\Lib\Resources\Tools\DebugView\に解凍します。 -
ログ記録に必要なツールの選択ページで、ステータスの更新をクリックします。選択したすべてのツールが、ステータス列の下に存在として表示されます。
-
ログ記録用のツールを選択し、次へをクリックします。
-
トレースと再現 の手順に従います。
-
完了後、zip ファイル内のログを確認します。ログは CDCLogs フォルダーに圧縮されています。
注:
トレースに Procmon ツールが選択されている場合、Process Monitor のログはすぐに大きくなる可能性があります。必要なツールのみを選択するようにしてください。ログのサイズは %temp%\Scout-CDC-Log で監視することもできます。
コレクションのスケジュール設定
注:
現在、コレクションはスケジュールできますが、ヘルスチェックはできません。
スケジュール手順は、マシンを選択し、スケジュールを設定またはキャンセルすることで構成されます。スケジュールされたコレクションは、Citrixに自動的にアップロードされます。(PowerShellインターフェイスを使用して、スケジュールされたコレクションをローカルに保存できます。(/ja-jp/citrix-virtual-apps-desktops/2203-ltsr/manage-deployment/cis.html#citrix-call-home)を参照してください。)
-
Scoutを起動します。マシンのスタートメニューから、Citrix > Citrix Scoutを選択します。開いたページで、Scheduleをクリックします。
-
マシンを選択します。サイト内のすべてのVDAとコントローラーが一覧表示されます。マシン名で表示をフィルターできます。グラフィカルインターフェイスを使用してVDAとコントローラーをインストールしたときに、Call Homeスケジュールを設定した場合 ((/ja-jp/citrix-virtual-apps-desktops/2203-ltsr/manage-deployment/cis.html#citrix-call-home)を参照)、Scoutはデフォルトでそれらの設定を表示します。このバージョンのScoutを使用して、スケジュールされたコレクションを初めて開始したり、以前に構成したスケジュールを変更したりできます。コンポーネントのインストール中にマシンごとにCall Homeを有効/無効にした場合でも、Scoutで構成されたスケジュールは、選択したすべてのマシンに影響します。診断情報を収集する各マシンの横にあるチェックボックスをオンにして、Continueをクリックします。その他のマシン (StoreFrontサーバーやCitrix Provisioningサーバーなど) を手動で追加するには、(#add-machines-manually)を参照してください。Scoutは、選択した各マシンで検証テストを自動的に起動し、(#verification-tests)の基準を満たしていることを確認します。マシンの検証が失敗した場合、Status列にメッセージが表示され、そのマシンのチェックボックスはオフになります。次のいずれかを実行できます。
-
問題を解決してから、そのマシンのチェックボックスを再度オンにします。これにより、検証テストが再試行されます。
-
そのマシンをスキップします (チェックボックスをオフのままにします)。そのマシンからは診断情報 (またはトレース) は収集されません。
検証テストが完了したら、Continueをクリックします。概要ページには、スケジュールが適用されるマシンが一覧表示されます。Continueをクリックします。 -
-
スケジュールを設定します。診断情報を収集するタイミングを指定します。注意:スケジュールは、選択したすべてのマシンに影響します。
-
選択したマシンに週次スケジュールを構成するには、Weeklyをクリックします。曜日を選択します。コレクションを開始する時刻 (24時間形式) を入力します。
-
選択したマシンに日次スケジュールを構成するには、Dailyをクリックします。コレクションを開始する時刻 (24時間形式) を入力します。
続行をクリックします。 -
-
アップロードの認証を行い、必要に応じてプロキシを指定します。このプロセスの詳細については、アップロード認証 を参照してください。注意: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の使用状況データ収集(/en-us/citrix-virtual-apps-desktops/2203-ltsr/media/scout-usage.png)