Citrix Virtual Apps and Desktops

Citrix Scout

はじめに

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

  • 収集ファイルを Citrix にアップロードして、Citrix Support から分析とガイダンスを受けることができます。または、コレクションをローカルに保存して自分で確認し、後でそのコレクションファイルを 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 サーバー、Federated Authentication Service (FAS) サーバー、および License Server で診断情報を取得したり、チェックを実行したりします。VDA から Scout を実行して、ローカル診断情報を収集することもできます。

  • 注:

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

  • 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) 情報は収集されません。

収集される情報には以下が含まれます。

  • HKEY_LOCAL_MACHINE\SOFTWARE\Citrix の下に Citrix Virtual Apps and Desktops によって作成されたレジストリエントリ。
  • 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 トレースは、他の診断情報とともに収集されます。
  • Enable-CitrixTrace コマンドレットまたは HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Telemetry DefaultListen レジストリ文字列を使用して、最大サイズ (デフォルト = 10 MB) とスライス期間を変更できます。
  • ファイルが MaxSize の 10% に達するまで、トレースはファイルに追加されます。

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

Scout の構成

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

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

  1. C:\Program Files\Citrix\Telemetry Service に移動します。
    1. ScoutUI.exe.config ファイルを開きます。
    1. LinuxVDATelemetryServicePort または LinuxVDATelemetryWakeupPort の値を、Linux VDA で構成された値に変更します。
  • <add key="LinuxVDATelemetryServicePort" value="7502"/>
  • <add key="LinuxVDATelemetryWakeupPort" value="7503"/>

    1. 変更を保存してファイルを閉じます。
    1. 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 Remote Desktop Services クライアントアクセスライセンス
  • VDA アプリケーション起動パス
  • セッション起動レジストリ設定

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

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

    • VDA での Profile Management について、Scout は以下をチェックします。
  • ハイパーバイザーの検出
  • プロビジョニングの検出
  • Citrix Virtual Apps and Desktops
  • 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 の資格日
    • Citrix License Server Update
    • ライセンスサーバー証明書が Delivery Controller の信頼されたルートストアにあること
  • ヘルスチェックの 権限と要件 を満たすことに加えて、ライセンスサーバーはドメインに参加している必要があります。そうでない場合、ライセンスサーバーは検出されません。

健康チェックの実行

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

    1. Scout を起動します。マシンの [スタート] メニューから、[Citrix] > [Citrix Scout] を選択します。起動ページで、[Health Check] をクリックします。
    1. マシンを選択します。[Find machine] をクリックしてマシンを検出します。[Select machines] ページには、サイトで検出されたすべての VDA、Delivery Controller、および License Server が一覧表示されます。マシン名で表示をフィルタリングできます。診断情報を収集する各マシンの横にあるチェックボックスをオンにして、[Continue] をクリックします。
  • 他のコンポーネントタイプ (StoreFront サーバーや VDA マシンなど) を追加するには、手動でのマシンの追加およびVDA マシンのインポートを参照してください。Citrix Provisioning™ Server または License Server を手動で追加することはできません。

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

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

    • 検証テストが完了したら、[Continue] をクリックします。
  1. 選択したマシンで健康チェックを実行します。概要には、テストが実行されるマシン (検証テストに合格した選択済みのマシン) が一覧表示されます。[Start Checking] をクリックします。

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

    • [Status] 列は、マシンの現在のチェック状態を示します。
    • 進行中のすべてのチェックを停止するには、ページ右下隅にある [Stop Checking] をクリックします。(単一のマシンの健康チェックをキャンセルすることはできず、選択したすべてのマシンのみをキャンセルできます。チェックが完了したマシンからの情報は保持されます。)
    • 選択したすべてのマシンのチェックが完了すると、右下隅の [Stop Checking] ボタンが [Done] に変わります。
    • チェックが失敗した場合は、[Action] 列の [Retry] をクリックできます。
    • チェックが問題なく完了した場合、[Action] 列は空になります。
    • チェックで問題が見つかった場合は、[View Details] をクリックして結果を表示します。
    • 選択したすべてのマシンのチェックが完了した後、[Back] をクリックしないでください。(クリックすると、チェック結果が失われます。)
  2. チェックが完了したら、[Done] をクリックして 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 バージョン](#version-compatibility)が実行されている必要があります。

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

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

Windows 用 Telemetry Service は Network Service で実行されます。

Scout データ使用量 1

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

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

Scout data usage 2

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

Scout data usage 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 FirewallサービスでWMIを有効にしてください。
-  **より新しいバージョンのCitrix Telemetry Serviceが必要** - (バージョンはCollectおよびTrace & Reproduceでのみチェックされます。)マシン上のTelemetry Serviceのバージョンをアップグレードしてください([インストールとアップグレード](#install-and-upgrade)を参照)。サービスをアップグレードしない場合、そのマシンは**Collect**または**Trace & Reproduce**アクションに含まれません。
-  **Scoutがこのマシン上のsystemdソケットに接続できません** - 以下を確認してください:

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

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

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

バージョンの互換性

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

-  | 機能 | Scout 2.23 | Scout 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資格情報のサポート はい はい
アップロード用のプロキシサーバーのサポート はい はい
スケジュールの調整 該当なし はい
  • スクリプトのサポート
コマンドライン(ローカル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 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を実行する場合、マシンの検索をクリックして、Delivery Controller、VDA、ライセンスサーバー、StoreFrontサーバーなどのマシンを検出します。

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

-  ## マシンの手動追加

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

ヘルスチェックの実行時:

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

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

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

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

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

-  Scoutは、手動で追加されたマシンを削除するまで記憶しています。Scoutを閉じてから再度開いても、手動で追加されたマシンはリストの最上部に表示されたままです。

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

ヒント:

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

VDAマシンのインポート

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

  1. Delivery ControllerまたはConnectorで、PowerShellコマンドを使用してマシンリストファイルを生成します。Connectorでは、Citrix資格情報を入力し、ポップアップダイアログで顧客を選択する必要があります Get-BrokerMachine| foreach { $_.DnsName } | out-file C:\machineList.txt
  2. machineList.txtファイルを、Scout Health Checkを起動するドメイン参加済みマシンにコピーします
  3. Scout Health Checkページで、マシンの追加をクリックします
  4. Windows VDAマシンタイプを選択します
  5. VDAマシンのインポートをクリックします
  6. machineList.txtファイルを選択します
  7. 開くをクリックします

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

Scout Health Check

診断情報の収集

-  **収集**手順は、マシンの選択、診断情報収集の開始、そして収集を含むファイルをCitrixにアップロードするかローカルに保存することから構成されます。
  1. Scoutを起動します。マシンのスタートメニューから、Citrix > Citrix Scoutを選択します。開いたページで、収集をクリックします
  2. マシンを選択します

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

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

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

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

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

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

    収集中:

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

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

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

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

    • ファイルをローカルに保存する場合:

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

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

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

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

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

    資格情報ページで:

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

    1. アップロードに関する情報を入力します。
    • 名前フィールドには、収集された診断情報のファイルのデフォルト名が含まれています。ほとんどの収集ではこれで十分ですが、名前を変更することもできます。(デフォルト名を削除して名前フィールドを空のままにすると、デフォルト名が使用されます。)
    • オプションで、8桁のCitrixサポートケース番号を指定します。
    • オプションの説明フィールドに、問題について説明し、該当する場合は問題が発生した時期を示します。

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

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

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

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

トレースと再現

トレースと再現」の手順は、マシンの選択、トレースの開始、問題の再現、診断情報の収集完了、そしてファイルのCitrixへのアップロードまたはローカル保存で構成されます。

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

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

  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のホームぺージで、[トレースと再現] をクリックします。
  2. データ収集元の[マシンの選択または追加] ページで、ローカルマシンのチェックボックスをオンにします。ステータスは検証済みと表示されている必要があります。
  3. [Citrixデータ収集ツールで追加ログ収集を有効にする] チェックボックスをオンにして、追加ログ収集を有効にします。
  4. [制御ファイルのアップロード] ボタンをクリックして、1つのCTLファイルをロードします。このボタンを使用すると、ScoutでのAOT収集のために、AOT収集リストに追加のGUIDを追加できます。

  5. [続行] をクリックし、トレースと再現の手順に従います。
  6. 完了後、zipファイル内のログを確認します。ログはCDCLogsフォルダーに圧縮されています。

    追加ログ収集の有効化

注:

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

収集のスケジュール設定

注:

現在、収集をスケジュールすることはできますが、ヘルスチェックはできません。

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

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

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

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

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

    診断情報を収集する各マシンの横にあるチェックボックスを選択し、[続行] をクリックします。

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

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

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

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

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

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

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

    [続行] をクリックします。

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

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

    資格情報ページで:

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

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

    構成されたスケジュールを確認します。[完了] をクリックしてScoutの開始ページに戻ります。

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

データマスキング

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

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

注:

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

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

新しい診断情報の収集とデータマスキングの実行

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

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

既存の診断情報に対するデータマスキングの実行

  1. Windowsで、コマンドプロンプトを管理者として開きます。
  2. Scoutがインストールされているディレクトリに移動します: cd C:\Program Files\Citrix\Telemetry Service
  3. データマスキングモードでScoutを直接起動します: ScoutUI.exe datamasking filePath
  4. 続行するには「Enable data masking」を選択します。このオプションはデフォルトで有効になっています。
  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) プロセス、レジストリ、クラッシュレポート、ヘッダー、トレース、msivcu、ツールテレメトリ、およびローカルデータ)から診断を除外します。 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