シトリックス スカウト

最終公開日 : Nov 13, 2026

はじめに

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サーバー、Federated Authentication Service(FAS)サーバー、およびライセンスサーバーの診断情報を取得したり、チェックを実行したりします。VDAからScoutを実行して、ローカル診断情報を収集することもできます。
    注:
    現在、FAS構成の問題を診断するためのヘルスチェックは、FASサーバー上の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プロセスのクラッシュダンプ。
  • 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トレースは他の診断情報とともに収集されます。
  • 最大サイズ (デフォルト = 10 MB) とスライス期間は、Enable-CitrixTrace cmdletまたはHKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Telemetry DefaultListenレジストリ文字列を使用して変更できます。
  • トレースは、ファイルがMaxSizeの10%に達するまでファイルに追加されます。
Scoutが収集するデータポイントのリストについては、「Call Homeの主要データポイント」(/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/manage-deployment/call-home-datapoints.html)を参照してください。

Scoutの構成

ScoutはLinux VDAで動作するように構成できます。Linux VDAとテレメトリの詳細については、「Citrix Telemetry Serviceとの統合」(/ja-jp/linux-virtual-delivery-agent/current-release.html)を参照してください。
Linux VDAは、ctxtelemetryソケットポートまたはテレメトリサービス用のポートを自動的に変更する場合があります。その場合は、ポートを手動で構成する必要があります。
  1. C:\Program Files\Citrix\Telemetry Service に移動します
  2. ScoutUI.exe.configファイルを開きます。
  3. LinuxVDATelemetryServicePortまたはLinuxVDATelemetryWakeupPortの値を、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 の構成チェック

サイトの健全性チェックの一環として、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 ファイルの存在
  • Customer Success Servicesの資格取得日
  • シトリックス ライセンスサーバーの更新
  • License Server証明書がDelivery Controllerの信頼されたルートストアにあるかどうか
ヘルスチェックの権限と要件を満たすことに加えて、License Serverはドメインに参加している必要があります。そうでない場合、License Serverは検出されません。

ヘルスチェックの実行

ヘルスチェックの手順は、マシンの選択、チェックの開始、および結果レポートの確認で構成されます。
  1. Scoutを起動します。マシンのスタートメニューから、Citrix > Citrix Scoutを選択します。開いたページで、Health Checkをクリックします。
  2. マシンを選択します。Find machineをクリックしてマシンを検出します。Select machinesページには、サイトで検出されたすべてのVDA、Delivery Controller、およびLicense Serverが一覧表示されます。マシン名で表示をフィルタリングできます。診断情報を収集する各マシンの横にあるチェックボックスを選択し、Continueをクリックします。
    その他のコンポーネントタイプ(StoreFrontサーバーやVDAマシンなど)を追加するには、マシンを手動で追加するおよびVDAマシンをインポートするを参照してください。Citrix Provisioning™ ServerまたはLicense Serverを手動で追加することはできません。
    Scoutは、選択された各マシンで検証テストを自動的に起動し、検証テストに記載されている基準を満たしていることを確認します。検証に失敗した場合、Status列にメッセージが表示され、そのマシンのチェックボックスがオフになります。次のいずれかを実行できます。
    • 問題を解決し、そのマシンのチェックボックスを再度選択します。これにより、検証テストが再試行されます。
    • そのマシンをスキップします(チェックボックスは選択解除のままにします)。そのマシンではヘルスチェックは実行されません。
    検証テストが完了したら、続行をクリックします。
  3. 選択したマシンでヘルスチェックを実行します。概要には、テストが実行されるマシン(検証テストに合格した選択済みのマシン)が一覧表示されます。チェック開始をクリックします。
    チェック中およびチェック後:
    • ステータス列には、マシンの現在のチェック状態が表示されます。
    • 進行中のすべてのチェックを停止するには、ページの右下隅にあるチェック停止をクリックします。(単一のマシンのヘルスチェックをキャンセルすることはできません。選択したすべてのマシンのみです。チェックが完了したマシンからの情報は保持されます。).
    • 選択したすべてのマシンのチェックが完了すると、右下隅のチェック停止ボタンが完了に変わります。
    • チェックが失敗した場合は、アクション列の再試行をクリックできます。
    • チェックが問題なく完了した場合、アクション列は空になります。
    • チェックで問題が見つかった場合は、詳細の表示をクリックして結果を表示します。
    • 選択したすべてのマシンのチェックが完了したら、戻るをクリックしないでください。(クリックすると、チェック結果が失われます。)
  4. チェックが完了したら、完了をクリックして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で実行されます。
Scoutデータ使用量 1
AOTトレースフォルダーはC:\ProgramData\Citrix\TelemetryService\CitrixAOTに保存されます。
Administratorグループ、System、およびTelemetry Service SIDのユーザーのみが、HKEYLOCALMACHINE:SOFTWARE\Citrix\Telemetryレジストリにアクセスする権限を持っています。
Scoutデータ使用量 2
Telemetry Serviceをアンインストールした後も、Telemetry Service SIDはPerformance Log Usersグループに残りますが、手動で削除できます。
Scoutデータ使用量 3

検証テスト

診断収集またはヘルスチェックが開始される前に、選択された各マシンに対して検証テストが自動的に実行されます。これらのテストは、要件が満たされていることを確認します。マシンのテストが失敗した場合、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 ファイアウォールサービスで WMI を有効にしてください。
  • Citrix Telemetry Service の新しいバージョンが必要です - (バージョンは、収集およびトレースと再現の場合にのみチェックされます。) マシン上の Telemetry Service のバージョンをアップグレードしてください (インストールとアップグレード を参照)。サービスをアップグレードしない場合、そのマシンは収集またはトレースと再現アクションに含まれません。
  • Scout がこのマシン上の systemd ソケットに接続できません - 以下を確認してください。
    • ポート 7503 が開いていること。systemd ctxtelemetry.socket がマシン上のポート 7503 でリッスンしていることを確認してください。ctxtelemetry.socket ポートが変更されている場合、ポートが異なる可能性があります。ポートを調整するには、Scout の構成 を参照してください。
    • ネットワーク接続が正常に機能していること。(これには、ファイアウォールが適切に構成されていることの確認が含まれる場合があります。)
  • このマシンでLinux VDAテレメトリサービスが開始されていません - 以下を確認してください。
    • ポート7502が開いていること。Linux VDAテレメトリサービスがマシンにインストールされ、開始されていることを確認します。テレメトリサービスのポートが変更されている場合、ポートが異なる可能性があります。ポートを調整するには、(#scout-configuration)のを参照してください。
    • ネットワーク接続が正常に機能していること。(これには、ファイアウォールが適切に構成されていることの確認が含まれる場合があります。)

バージョン互換性

このバージョンのScout(3.x)は、Citrix Virtual Apps and Desktops(または最低でもXenAppおよびXenDesktop 7.14)のControllerおよびVDAで実行することを目的としています。
| 機能 | スカウト 2.23 | スカウト 3.0 | --- | --- | ---| -- | Citrix Virtual Apps and Desktops(およびXenAppおよび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 資格情報をサポート | はい | はい アップロード用のプロキシサーバーをサポート | はい | はい スケジュールを調整 | 該当なし | はい スクリプトのサポート | コマンドライン (ローカルコントローラーのみ) | 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は自動的に検出したControllerとVDAを一覧表示します。
Delivery ControllerからScout Health Checkを実行するときに、Find machineをクリックすると、デリバリーコントローラー、VDA、ライセンスサーバー、StoreFrontサーバーなどのマシンが検出されます。
ドメインに参加しているがDelivery ControllerではないマシンからScout Health Checkを実行すると、Scoutはマシンを自動的に検出できません。手動でマシンを追加するか、VDAマシンをインポートする必要があります。

マシンを手動で追加する

Scoutが検出したControllerとVDAを一覧表示した後、StoreFrontサーバー、License Server、Citrix Provisioningサーバーなど、展開内の他のマシンを手動で追加できます。
ヘルスチェックを実行する場合:
  • ドメイン内のCitrix License Serverは自動的に検出されます。License Serverを手動で追加することはできません。
  • ヘルスチェックは現在、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 Serverマシンを手動で追加し、同時に収集をトリガーできます。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. マシンタイプを選択します。
  5. をクリックします。
  6. machineList.txtファイルを選択します。
  7. をクリックします。
インポートされたVDAマシンは、Scout Health Checkページに一覧表示されます。
Scoutヘルスチェック

診断情報の収集

手順には、マシンの選択、診断情報収集の開始、および収集を含むファイルをCitrixにアップロードするかローカルに保存する作業が含まれます。
  1. Scoutを起動します。マシンの**** メニューから、 > を選択します。開いたページで、 をクリックします。
  2. マシンを選択します。
    • Controllerでは、 ページにサイト内のすべてのVDAとControllerが一覧表示されます。マシン名で表示をフィルターできます。他のマシン(StoreFrontやCitrix Provisioningサーバーなど)を手動で追加するには、マシンの手動追加を参照してください。
    • StoreFrontでは、「マシンの選択」ページにローカルマシンのみが表示されます。同じクラスター内の他のStoreFrontマシンを追加するには、「手動でマシンを追加」を参照してください。
    • その他のコンポーネント(VDAサーバーなど)では、「マシンの選択」ページにローカルマシンのみが表示されます。マシンの手動追加はサポートされていません。
    診断情報を収集する各マシンの横にあるチェックボックスをオンにし、「続行」をクリックします。
    Scoutは、選択された各マシンで検証テストを自動的に起動し、検証テストに記載されている基準を満たしていることを確認します。検証に失敗した場合、「ステータス」列にメッセージが表示され、そのマシンのチェックボックスはオフになります。次のいずれかを実行できます。
    • 問題を解決してから、そのマシンのチェックボックスを再度オンにします。これにより、検証テストが再試行されます。
    • そのマシンをスキップします(チェックボックスをオフのままにします)。そのマシンからは診断情報は収集されません。
    検証テストが完了したら、「続行」をクリックします。
  3. 診断情報を収集します。概要には、診断情報が収集されるすべてのマシン(検証テストに合格した選択済みのマシン)が一覧表示されます。「収集の開始」をクリックします。
    収集中:
    • 「ステータス」列には、マシンの現在の収集状態が表示されます。
    • 単一マシンで進行中の収集を停止するには、そのマシンの「アクション」列にある「キャンセル」をクリックします。
    • 進行中のすべての収集を停止するには、ページの右下隅にある「収集の停止」をクリックします。収集が完了したマシンからの診断情報は保持されます。収集を再開するには、各マシンの「アクション」列にある「再試行」をクリックします。
    • 選択されたすべてのマシンで収集が完了すると、右下隅にある「収集の停止」ボタンが「続行」に変わります。
    • 診断情報を再度収集するには、そのマシンの「アクション」列にある「再収集」をクリックします。新しい収集は以前の収集を上書きします。
    • 収集に失敗した場合、「アクション」列にある「再試行」をクリックできます。正常に収集されたもののみがアップロードまたは保存されます。
    • 選択したすべてのマシンで収集が完了したら、戻るをクリックしないでください。(クリックすると、収集は失われます。)
    収集が完了したら、続行をクリックします。
  4. 収集を保存またはアップロードします。ファイルをCitrixにアップロードするか、ローカルマシンに保存するかを選択します。
    今すぐファイルをアップロードすることを選択した場合は、手順5に進みます。
    ファイルをローカルに保存することを選択した場合:
    • Windowsの保存ダイアログボックスが表示されます。目的の場所に移動します。
    • ローカル保存が完了すると、ファイルのパス名が表示され、リンクされます。ファイルを表示できます。後でファイルをCitrixにアップロードできます。CTX136396を参照してください。
    完了をクリックしてScoutの開始ページに戻ります。この手順でこれ以上ステップを完了する必要はありません。
  5. アップロードの認証を行い、必要に応じてプロキシを指定します。詳細については、(#upload-authorization)を参照してください。
    • 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とコントローラーが一覧表示されます。マシン名で表示をフィルターできます。トレースと診断を収集する各マシンの横にあるチェックボックスをオンにします。次に、続行をクリックします。
    他のマシン(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は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 をより効果的に使用でき、問題を迅速に診断するのに役立ちます。
注:
これはローカルマシンにのみ適用されます。
追加のログ収集を有効にするには、次の必要なツールがインストールされており、指定された場所にディレクトリが手動で作成されていることを確認してください。
ツールのインストール場所:
  • 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 を手動でインストールします。
追加のログを収集するには:
  1. Scout のホームページで、Trace & Reproduce をクリックします。
  2. データを収集する マシンの選択または追加 ページで、ローカルマシンのチェックボックスをオンにします。ステータスは Verified と表示されている必要があります。
  3. Citrix Data Collection Tool を使用した追加のログ収集を有効にする チェックボックスをオンにして、追加のログ収集を有効にします。
  4. 「コントロールファイルのアップロード」ボタンをクリックして、1つのCTLファイルをロードします。このボタンを使用すると、ScoutでのAOTコレクションのために、AOTコレクションリストに追加のGUIDを追加できます。
  5. 「続行」をクリックし、トレースと再現の手順に従います。
  6. 完了後、zipファイル内のログを確認します。ログはCDCLogsフォルダーにzip圧縮されています。
    追加ログ収集を有効にする
注:
トレースにProcmonツールが選択されている場合、Process Monitorログはすぐに大きくなる可能性があります。必要なツールのみを選択するようにしてください。ログのサイズは、%temp%\Scout-CDC-Logで監視することもできます。

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

注:
現在、コレクションをスケジュールすることはできますが、ヘルスチェックをスケジュールすることはできません。
スケジュール手順は、マシンを選択し、スケジュールを設定またはキャンセルすることで構成されます。スケジュールされたコレクションは自動的にCitrixにアップロードされます。(PowerShellインターフェイスを使用して、スケジュールされたコレクションをローカルに保存できます。Citrix Call Homeを参照してください。)
  1. Scoutを起動します。マシンのスタートメニューから、「Citrix > Citrix Scout」を選択します。開いたページで、「スケジュール」をクリックします。
  2. マシンを選択します。サイト内のすべてのVDAとコントローラーが一覧表示されます。マシン名で表示をフィルターできます。
    グラフィカルインターフェイスを使用してVDAとコントローラーをインストールしたときに、Call Homeスケジュールを設定した場合(Citrix Call Homeを参照)、Scoutはデフォルトでそれらの設定を表示します。このバージョンのScoutを使用して、スケジュールされたコレクションを初めて開始したり、以前に構成したスケジュールを変更したりできます。
    コンポーネントのインストール中にマシンごとにCall Homeを有効/無効にした場合でも、Scoutで構成されたスケジュールは、選択したすべてのマシンに影響します。
    診断情報を収集する各マシンの横にあるチェックボックスをオンにして、「続行」をクリックします。
    その他のマシン(StoreFrontやCitrix Provisioningサーバーなど)を手動で追加するには、マシンの手動追加を参照してください。
    Scoutは、選択した各マシンで検証テストを自動的に起動し、検証テストの基準を満たしていることを確認します。マシンの検証が失敗した場合、ステータス列にメッセージが表示され、そのマシンのチェックボックスはオフになります。次のいずれかを実行できます。
    • 問題を解決してから、マシンのチェックボックスをもう一度選択します。これにより、検証テストが再試行されます。
    • そのマシンをスキップします(チェックボックスをオフのままにします)。そのマシンからは診断(またはトレース)は収集されません。
    検証テストが完了したら、Continue をクリックします。
    概要ページには、スケジュールが適用されるマシンが一覧表示されます。Continue をクリックします。
  3. スケジュールを設定します。診断を収集するタイミングを指定します。注意:スケジュールは、選択したすべてのマシンに影響します。
    • 選択したマシンに週次スケジュールを構成するには、Weekly をクリックします。曜日を選択します。収集を開始する時刻(24時間形式)を入力します。
    • 選択したマシンに日次スケジュールを構成するには、Daily をクリックします。収集を開始する時刻(24時間形式)を入力します。
    • 選択したマシンの既存のスケジュールをキャンセルするには(そして別のスケジュールに置き換えない場合)、Off をクリックします。これにより、それらのマシンに対して以前に構成されていたスケジュールがすべてキャンセルされます。
    続行をクリックします。
  4. アップロードの認証を行い、必要に応じてプロキシを指定します。このプロセスの詳細については、アップロード認証 を参照してください。注意:Scout スケジュールを使用する場合、保存されたトークンを使用して認証することはできません。
    アップロードを認証するために、Citrix 資格情報を使用するか、Citrix Cloud 資格情報を使用するかを選択します。Continue をクリックします。
    資格情報ページで:
    • ファイルアップロードにプロキシサーバーを使用する場合は、Configure proxy をクリックします。Scout に、ブラウザーのインターネットプロパティ用に構成されたプロキシ設定を使用するように指示できます。または、プロキシサーバーの IP アドレスとポート番号を入力することもできます。プロキシダイアログボックスを閉じます。
    • Citrix Cloud アカウントの場合は、Generate token をクリックします。デフォルトのブラウザーが Citrix Cloud ページに起動し、トークンが表示されます。トークンをコピーし、Scout ページに貼り付けます。
    • Citrix アカウントの場合は、資格情報を入力します。
    完了したら、Continue をクリックします。
    設定されたスケジュールを確認します。完了をクリックして、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. 診断情報を収集するには、収集またはトレースと再現をクリックします。
  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 の使用状況データ収集

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