シトリックス スカウト
はじめに
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ライセンスサーバーのヘルスチェックを実行できます。チェック中に問題が見つかった場合、Scoutは詳細なレポートを提供します。Scoutが起動するたびに、更新されたヘルスチェックスクリプトがないか確認します。新しいバージョンが利用可能な場合、Scoutはそれらを自動的にダウンロードし、次回のヘルスチェック実行時に使用します。
注：
トレースと再現、スケジュール、およびヘルスチェックの手順は、現在Linux VDAでは利用できません。
この記事で説明されているグラフィカルインターフェイスは、Scoutを使用する主要な方法です。または、PowerShellを使用して、1回限りの診断情報収集またはスケジュールされた診断情報収集とアップロードを構成することもできます。「Call Home」を参照してください。
Scoutの実行場所：
- オンプレミス展開では、Delivery Controller™からScoutを実行して、1つ以上のVirtual Delivery Agent (VDA)、Delivery Controller、StoreFrontサーバー、およびライセンスサーバーで診断情報を取得したり、チェックを実行したりできます。VDAからScoutを実行して、ローカル診断情報を収集することもできます。
- シトリックス DaaS（旧称 シトリックス バーチャルアプリ アンド デスクトップサービス）を使用するシトリックス クラウド環境では、VDAからスカウトを実行してローカル診断情報を収集します。
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管理インストゥルメンテーション (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の主要データポイント」(/ja-jp/citrix-virtual-apps-desktops/2203-ltsr/manage-deployment/call-home-datapoints.html)を参照してください。
スカウトの構成
ScoutはLinux VDAで動作するように構成できます。Linux VDAとテレメトリの詳細については、「Citrix Telemetry Serviceとの統合」(/ja-jp/linux-virtual-delivery-agent/current-release.html)を参照してください。
Linux VDAは、ctxtelemetry ソケットポートまたはテレメトリサービス用のポートを自動的に変更する場合があります。その場合、ポートを手動で構成する必要があります。
- Navigate to C:\Program Files\Citrix\Telemetry Service
- ScoutUI.exe.config という名前のファイルを開きます。
- 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"/>
- 変更を保存してファイルを閉じます。
- Scoutを再度開いて、最新の構成がロードされていることを確認します。
ヘルスチェックについて
ヘルスチェックデータは、C:\ProgramData\Citrix\TelemetryService\ の下のフォルダーに保存されます。
サイトヘルスチェック
サイトヘルスチェックは、FlexCast Management Architecture (FMA) サービスの包括的な評価を提供する環境テストサービスに含まれています。これらのチェックでは、サービスの可用性を確認するだけでなく、データベース接続などの他のヘルスインジケーターも確認します。
サイトヘルスチェックは、Delivery Controller で実行されます。サイトの規模によっては、これらのチェックの完了に最大1時間かかる場合があります。
デリバリーコントローラーの構成チェック
サイトヘルスチェックの一部として、Delivery Controller の構成チェックでは、Virtual Apps and Desktops サイトに関するCitrixの推奨事項に基づいて、以下の問題が存在するかどうかを確認します。
- 1つ以上のDelivery Controllerが失敗状態にある。
- サイトには 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 は以下をチェックします。
- ハイパーバイザーの検出
- プロビジョニングの検出
- シトリックス バーチャル アプリケーションズ アンド デスクトップ
- パーソナル ブイディスク の構成
- ユーザー ストア
- プロファイル マネジメント サービス のステータス検出
- Winlogon.exe フッキングテスト
Profile Managementのチェックを実行するには、VDAにProfile Managementをインストールして有効にする必要があります。Profile Managementの構成チェックの詳細については、Knowledge Centerの記事CTX132805を参照してください。
StoreFrontの健全性チェック
StoreFrontのチェックでは、以下を確認します。
- Citrix Default Domainサービスが実行されていること
- シトリックス クレデンシャルウォレット サービスが実行されていること
- StoreFront サーバーから アクティブディレクトリ ポート 88 への接続
- StoreFront サーバーから アクティブディレクトリ ポート 389 への接続
- ベースURLが有効なFQDNを持っていること
- ベースURLから正しいIPアドレスを取得できること
- IISアプリケーションプールが.NET 4.0を使用していること
- 証明書がホストURLのSSLポートにバインドされているか
- 証明書チェーンが完全であるか
- 証明書が有効期限切れであるか
- 証明書が間もなく（30日以内）有効期限が切れるか
ライセンスサーバーのチェック
ライセンスサーバーのチェックで確認される項目は次のとおりです。
- Delivery Controllerからのライセンスサーバー接続
- ライセンスサーバーのファイアウォールリモートアクセスステータス
- Citrix ライセンスサービスの状態
- ライセンスサーバーの猶予期間の状態
- ライセンスサーバーポートの接続
- Citrixベンダーデーモン（CITRIX）が実行されているかどうか
- システムクロックが同期されているかどうか
- Citrix Licensingサービスがローカルサービスアカウントで実行されているかどうか
-
CITRIX.optファイルの存在 - カスタマーサクセスサービス 資格有効期限
- Citrix ライセンスサーバーの更新
- ライセンスサーバー証明書がDelivery Controllerの信頼されたルートストアにあるかどうか
ヘルスチェックの権限と要件を満たすことに加えて、ライセンスサーバーはドメインに参加している必要があります。そうでない場合、ライセンスサーバーは検出されません。
ヘルスチェックの実行
ヘルスチェックの手順は、マシンの選択、チェックの開始、結果レポートの確認で構成されます。
- Scoutを起動します。マシンのスタートメニューから、Citrix > Citrix Scoutを選択します。開いたページで、Health Checkをクリックします。
-
マシンを選択します。Find machineをクリックしてマシンを検出します。Select machinesページには、サイトで検出されたすべてのVDA、Delivery Controller、およびLicense Serverが一覧表示されます。マシン名で表示をフィルターできます。診断情報を収集する各マシンの横にあるチェックボックスをオンにして、Continueをクリックします。
その他のコンポーネントタイプ（StoreFrontサーバーやVDAマシンなど）を追加するには、「Add machines manually」および「Import VDA machines」を参照してください。Citrix Provisioning™サーバーまたはLicense Serverを手動で追加することはできません。
Scoutは、選択された各マシンで検証テストを自動的に起動し、「Verification tests」に記載されている基準を満たしていることを確認します。検証に失敗した場合、Status列にメッセージが表示され、そのマシンのチェックボックスはオフになります。次のいずれかを実行できます。
- 問題を解決してから、マシンのチェックボックスを再度オンにします。これにより、検証テストが再試行されます。
- そのマシンをスキップします（チェックボックスをオフのままにします）。そのマシンではヘルスチェックは実行されません。
検証テストが完了したら、Continueをクリックします。
-
選択したマシンでヘルスチェックを実行します。概要には、テストが実行されるマシン（検証テストに合格した選択済みのマシン）が一覧表示されます。Start Checkingをクリックします。
チェック中およびチェック後：
- Status列には、マシンの現在のチェック状態が表示されます。
- 進行中のすべてのチェックを停止するには、ページ右下隅にあるStop Checkingをクリックします。（個々のマシンのヘルスチェックをキャンセルすることはできず、選択されているすべてのマシンのみをキャンセルできます。チェックが完了したマシンからの情報は保持されます。
- 選択されたすべてのマシンのチェックが完了すると、右下隅のStop CheckingボタンがDoneに変わります。
- チェックが失敗した場合は、Action列のRetryをクリックできます。
- チェックが問題なく完了した場合、Action列は空になります。
- チェックで問題が見つかった場合は、View Details をクリックして結果を表示します。
- 選択したすべてのマシンでチェックが完了したら、Back をクリックしないでください。(クリックすると、チェック結果が失われます。)
- チェックが完了したら、Done をクリックして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グループ、System、およびTelemetry Service SIDのユーザーのみがHKEYLOCALMACHINE:SOFTWARE\Citrix\Telemetryレジストリにアクセスする権限を持っています。
Telemetry Service 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 |
|---|---|---|
| シトリックス バーチャル アプリ アンド デスクトップ (ゼナップおよびゼンデスクトップ 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トレースをキャプチャ | はい | はい |
| 常時トレース (AOT) をキャプチャ | いいえ | はい |
| 診断データの収集を許可 | 一度に最大10台のマシン (デフォルト) | 無制限 (リソースの可用性による) |
| 診断データをCitrixに送信することを許可 | はい | はい |
| 診断データをローカルに保存することを許可 | はい | はい |
| Citrix Cloud™ 資格情報をサポート | いいえ | はい |
| Citrix資格情報のサポート | はい | はい |
| アップロード用プロキシサーバーのサポート | はい | はい |
| スケジュールの調整 | 該当なし | はい |
| スクリプトのサポート | コマンドライン（ローカルControllerのみ） | Call Homeコマンドレットを使用したPowerShell（Telemetry Serviceがインストールされている任意のコンピューター） |
| ヘルスチェック | いいえ | はい |
| データマスキング | いいえ | 3.17以降 |
インストールとアップグレード
デフォルトでは、VDAまたはControllerをインストールまたはアップグレードする際に、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が資格情報を検証した後、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アドレスとポート番号を指定することもできます。
マシンを検索
収集、トレースと再現、スケジュールの手順では、Scoutは自動的に検出したコントローラーとVDAを一覧表示します。
Delivery ControllerからScout Health Checkを実行するときは、マシンを検索をクリックして、デリバリーコントローラー、VDA、ライセンスサーバー、StoreFrontサーバーなどのマシンを検出します。
Delivery Controllerではないドメイン参加済みマシンからScout Health Checkを実行すると、Scoutはマシンを自動的に検出できません。マシンを手動で追加するか、VDAマシンをインポートする必要があります。
マシンを手動で追加
Scoutが検出したコントローラーとVDAを一覧表示した後、StoreFrontサーバー、ライセンスサーバー、Citrix Provisioningサーバーなど、展開内の他のマシンを手動で追加できます。
ヘルスチェックを実行する場合：
- ドメイン内のCitrixライセンスサーバーは自動的に検出されます。ライセンスサーバーを手動で追加することはできません。
- ヘルスチェックは現在、Citrix Provisioningサーバーをサポートしていません。
検出されたマシンを一覧表示するScoutの任意のページで、+ マシンを追加をクリックします。追加したいマシンのFQDNを入力し、続行をクリックします。必要に応じて、他のマシンを追加するために繰り返します。（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 を起動するドメイン参加済みマシンにコピーします。
- Scout Health Check ページで、マシンの追加 をクリックします。
- [Windows VDA] マシンタイプを選択します。
- VDA マシンのインポート をクリックします。
- machineList.txt ファイルを選択します。
- [Open] をクリックします。
インポートされた VDA マシンは、Scout Health Check ページに表示されます。
診断情報の収集
「収集」の手順は、マシンの選択、診断情報の収集の開始、そして収集を含むファイルをCitrixにアップロードするか、ローカルに保存することから構成されます。
-
Scoutを起動します。マシンのスタートメニューから、Citrix > Citrix Scoutを選択します。開いたページで、収集をクリックします。
-
マシンを選択します。
- コントローラーでは、マシンの選択ページにサイト内のすべてのVDAとコントローラーが一覧表示されます。マシン名で表示をフィルターできます。他のマシン（StoreFrontやCitrix Provisioningサーバーなど）を手動で追加するには、「マシンの手動追加」を参照してください。
- その他のコンポーネント（VDAサーバーなど）では、マシンの選択ページにはローカルマシンのみが表示されます。マシンの手動追加はサポートされていません。
診断情報を収集する各マシンの横にあるチェックボックスをオンにしてから、続行をクリックします。
Scoutは、選択された各マシンで検証テストを自動的に起動し、「検証テスト」に記載されている基準を満たしていることを確認します。検証に失敗した場合、ステータス列にメッセージが表示され、そのマシンのチェックボックスはオフになります。次のいずれかを実行できます。
- 問題を解決してから、そのマシンのチェックボックスを再度オンにします。これにより、検証テストが再試行されます。
- そのマシンをスキップします（チェックボックスをオフのままにします）。そのマシンからは診断情報は収集されません。
検証テストが完了したら、続行をクリックします。
-
診断情報を収集します。概要には、診断情報が収集されるすべてのマシン（検証テストに合格した選択済みのマシン）が一覧表示されます。収集の開始をクリックします。
収集の際：
- ステータス列には、マシンの現在の収集状態が表示されます。
- 単一マシンでの進行中の収集を停止するには、そのマシンのアクション列にあるキャンセルをクリックします。
- 進行中のすべての収集を停止するには、ページ右下隅にある収集の停止をクリックします。収集が完了したマシンからの診断情報は保持されます。収集を再開するには、各マシンのアクション列にある再試行をクリックします。
- 選択したすべてのマシンでコレクションが完了すると、右下隅にあるコレクションの停止ボタンが続行に変わります。
- 診断を再度収集するには、そのマシンのアクション列にある再収集をクリックします。新しいコレクションが以前のコレクションを上書きします。
- コレクションが失敗した場合は、アクション列にある再試行をクリックできます。正常に完了したコレクションのみがアップロードまたは保存されます。
- 選択したすべてのマシンでコレクションが完了したら、戻るをクリックしないでください。（クリックすると、コレクションは失われます。）
コレクションが完了したら、続行をクリックします。
-
コレクションを保存またはアップロードします。ファイルを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を選択します。開いたページで、トレースと再現をクリックします。
-
マシンを選択します。「マシンの選択」ページには、サイト内のすべてのVDAとコントローラーが一覧表示されます。マシン名で表示をフィルタリングできます。トレースと診断を収集したい各マシンの横にあるチェックボックスを選択します。次に、続行をクリックします。
その他のマシン（StoreFrontやCitrix Provisioningサーバーなど）を手動で追加するには、「マシンの手動追加」を参照してください。
Scoutは、選択された各マシンで検証テストを自動的に起動し、検証テストに記載されている基準を満たしていることを確認します。マシンの検証が失敗した場合、ステータス列にメッセージが表示され、そのマシンのチェックボックスは選択解除されます。次のいずれかの操作を実行できます。
- 問題を解決してから、マシンのチェックボックスを再度選択します。これにより、検証テストが再試行されます。
- そのマシンをスキップします（チェックボックスは選択解除のままにします）。そのマシンからは診断とトレースは収集されません。
検証テストが完了したら、続行をクリックします。
-
トレースを開始します。概要には、トレースが収集されるすべてのマシンが一覧表示されます。トレースの開始をクリックします。
選択した1台以上のマシンで、発生した問題を再現します。その間、トレース収集は継続されます。問題の再現が完了したら、Scoutで続行をクリックします。これによりトレースが停止します。
トレースを停止した後、トレース中に問題を再現したかどうかを示します。
-
マシンから診断を収集します。収集の開始をクリックします。収集中：
- ステータス列には、マシンの現在の収集状態が表示されます。
- 単一マシンで進行中の収集を停止するには、そのマシンのアクション列にあるキャンセルをクリックします。
- 進行中のすべてのコレクションを停止するには、ページの右下隅にある [コレクションの停止] をクリックします。コレクションが完了したマシンからの診断は保持されます。コレクションを再開するには、各マシンの [アクション] 列にある [再試行] をクリックします。
- 選択したすべてのマシンでコレクションが完了すると、右下隅にある [コレクションの停止] ボタンが [続行] に変わります。
- マシンから診断を再度収集するには、そのマシンの [アクション] 列にある [再収集] をクリックします。新しいコレクションは以前のコレクションを上書きします。
- コレクションが失敗した場合は、[アクション] 列にある [再試行] をクリックできます。正常に完了したコレクションのみがアップロードまたは保存されます。
- 選択したすべてのマシンでコレクションが完了したら、[戻る] をクリックしないでください。(クリックすると、コレクションは失われます。)
コレクションが完了したら、[続行] をクリックします。
-
コレクションを保存またはアップロードします。ファイルを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などの追加ツールを使用してトレースおよび再現機能を使用できます。
「注：」
これはローカルマシンにのみ適用されます。
追加ログ収集を設定するには：
- シトリックス スカウトを起動します。
- 「設定」ギアをクリックします。
- 「追加ツールで追加ログ収集を有効にする」をクリックします。
- 「保存」をクリックします。
追加ログを収集するには：
- 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フォルダーにzip圧縮されています。
注:
トレースにProcmonツールが選択されている場合、Process Monitorのログはすぐに大きくなる可能性があります。必要なツールのみを選択するようにしてください。ログのサイズは%temp%\Scout-CDC-Logで監視することもできます。
コレクションのスケジュール設定
注:
現在、コレクションのスケジュール設定は可能ですが、ヘルスチェックはできません。
スケジュール手順は、マシンを選択し、スケジュールを設定またはキャンセルすることから構成されます。スケジュールされたコレクションは自動的にCitrixにアップロードされます。(PowerShellインターフェースを使用して、スケジュールされたコレクションをローカルに保存できます。Citrix Call Homeを参照してください。)
-
Scoutを起動します。マシンのスタートメニューから「Citrix > Citrix Scout」を選択します。開いたページで「スケジュール」をクリックします。
-
マシンを選択します。サイト内のすべてのVDAとコントローラーが一覧表示されます。マシン名で表示をフィルターできます。
グラフィカルインターフェースを使用してVDAとコントローラーをインストールしたときに、Call Homeスケジュールを設定した場合（Citrix Call Homeを参照）、Scoutはデフォルトでそれらの設定を表示します。このバージョンのScoutを使用して、初めてスケジュールされたコレクションを開始したり、以前に構成されたスケジュールを変更したりできます。
コンポーネントのインストール中にマシンごとにCall Homeを有効/無効にした場合でも、Scoutで構成されたスケジュールは、選択したすべてのマシンに影響します。
診断情報を収集したい各マシンの横にあるチェックボックスを選択し、「続行」をクリックします。
他のマシンを手動で追加するには (StoreFront または Citrix Provisioning サーバーなど)、マシンを手動で追加するを参照してください。
Scout は、選択した各マシンで検証テストを自動的に起動し、検証テストの基準を満たしていることを確認します。マシンの検証が失敗した場合、ステータス列にメッセージが表示され、そのマシンのチェックボックスがオフになります。次のいずれかを実行できます。
- 問題を解決し、マシンのチェックボックスを再度選択します。これにより、検証テストが再試行されます。
- そのマシンをスキップします (チェックボックスをオフのままにします)。そのマシンからは診断 (またはトレース) は収集されません。
検証テストが完了したら、続行をクリックします。
概要ページには、スケジュールが適用されるマシンが一覧表示されます。続行をクリックします。
-
スケジュールを設定します。診断を収集するタイミングを指定します。注意: スケジュールは、選択したすべてのマシンに影響します。
- 選択したマシンに週次スケジュールを設定するには、週次をクリックします。曜日を選択します。収集を開始する時刻 (24時間形式) を入力します。
- 選択したマシンに日次スケジュールを設定するには、日次をクリックします。収集を開始する時刻 (24時間形式) を入力します。
- 選択したマシンの既存のスケジュールをキャンセルするには (別のスケジュールに置き換えない場合)、オフをクリックします。これにより、それらのマシンに対して以前に構成されたすべてのスケジュールがキャンセルされます。
続行をクリックします。
-
アップロードの認証を行い、必要に応じてプロキシを指定します。このプロセスの詳細については、アップロードの承認を参照してください。注意: Scout スケジュールを使用している場合、保存されたトークンを使用して認証することはできません。
アップロードを認証するために、Citrix 資格情報を使用するか、Citrix Cloud 資格情報を使用するかを選択します。続行をクリックします。
資格情報ページで:
- ファイルアップロードにプロキシサーバーを使用する場合は、プロキシの構成をクリックします。Scout に、ブラウザのインターネットプロパティで構成されているプロキシ設定を使用するように指示できます。または、プロキシサーバーの IP アドレスとポート番号を入力することもできます。プロキシダイアログボックスを閉じます。
- Citrix Cloudアカウントの場合は、Generate tokenをクリックします。デフォルトのブラウザがCitrix Cloudページに起動し、トークンが表示されます。トークンをコピーし、Scoutページに貼り付けます。
- Citrixアカウントの場合は、資格情報を入力します。
完了したら、Continueをクリックします。
構成されたスケジュールを確認します。DoneをクリックしてScoutの開始ページに戻ります。
収集中、選択された各マシンの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。 - 続行するには「Enable data masking」を選択します。このオプションはデフォルトで有効になっています。
- データマスクを構成します。デフォルトのルールでデータマスキングを実行することも、ルールをカスタマイズすることもできます。
- 診断情報の収集をアップロードするか保存するかを選択します。
- 「Upload the diagnostics collection to Citrix」を選択した場合、マスクされた診断ファイルがCitrixにアップロードされます。
- 「Save the diagnostics collection on your local machine」を選択すると、元の診断情報とマスクされた診断情報の両方が指定された場所に保存されます。
マスクされたデータファイルとマッピングファイルの場所
診断情報の収集をアップロードまたは保存した後、リンクをクリックして元の診断情報とマスクされた診断情報を開き、マッピング情報ファイルを開きます。
使用状況データの収集
Scoutを使用すると、CitrixはGoogle Analyticsを使用して匿名の使用状況データを収集し、将来の製品機能と改善に役立てます。データ収集はデフォルトで有効になっています。
使用状況データの収集とアップロードを変更するには、Scout UIのSettingsギアをクリックします。その後、YesまたはNoを選択し、Saveをクリックして情報を送信するかどうかを選択できます。
Scoutの使用状況データ収集(/ja-jp/citrix-virtual-apps-desktops/2203-ltsr/media/scout-usage.png)