Citrix スカウト
はじめに
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 サーバー、および License Server の診断情報を取得したり、チェックを実行したりします。VDA から Scout を実行して、ローカル診断情報を収集することもできます。
-
Citrix DaaS(旧称 Citrix Virtual Apps and Desktops サービス)を使用する Citrix Cloud 環境では、VDA から Scout を実行してローカル診断情報を収集します。
Scout アプリケーションのログは
C:\ProgramData\Citrix\TelemetryService\ScoutUI.log に保存されます。このファイルはトラブルシューティングに使用できます。
収集されるもの
Scoutが収集する診断情報には、Citrix Diagnostic Facility (CDF) トレースログファイルが含まれます。Always-on Tracing (AOT) と呼ばれるCDFトレースのサブセットも含まれています。AOT情報は、VDA登録やアプリケーション/デスクトップの起動などの一般的な問題のトラブルシューティングに役立ちます。その他のEvent Tracing for Windows (ETW) 情報は収集されません。
収集される情報には以下が含まれます。
-
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トレースは、他の診断情報とともに収集されます。
-
最大サイズ(デフォルト = 10 MB)とスライス期間は、
Enable-CitrixTraceコマンドレットまたはHKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Telemetry DefaultListenレジストリ文字列を使用して変更できます。 -
トレースは、ファイルが
MaxSizeの10%に達するまでファイルに追加されます。
Scout が収集するデータポイントのリストについては、Call Home key datapoints を参照してください。
Scout の構成
Scout は Linux VDA で動作するように構成できます。Linux VDA とテレメトリの詳細については、Integrate with the 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) サービスの包括的な評価を提供する Environment Test Service に含まれています。これらのチェックは、サービスの可用性を確認するだけでなく、データベース接続などの他のヘルスインジケーターも調べます。
サイトヘルスチェックは Delivery Controller で実行されます。サイトの規模によっては、これらのチェックの完了に最大 1 時間かかる場合があります。
Delivery Controller の構成チェック
サイトの健全性チェックの一環として、Citrix Virtual Apps and Desktopsサイトに関するCitrixの推奨事項に基づき、Delivery Controllerの構成チェックは以下の問題が存在するかどうかを確認します。
-
1つ以上のDelivery Controllerが失敗状態にある。
-
サイトにDelivery Controllerが1つしかない。
-
Delivery Controllerのバージョンが異なる。
健全性チェックの権限と要件を満たすことに加えて、Delivery Controllerの構成チェックには以下が必要です。
-
少なくとも1つのControllerが電源オンになっていること。
-
Controller上でBroker Serviceが実行されていること。
-
Controllerからサイトデータベースへの接続が機能していること。
VDAの健全性チェック
VDAの健全性チェックは、一般的なVDA登録、セッション起動、およびタイムゾーンリダイレクトの問題の考えられる原因を特定します。
VDAでの登録について、Scoutは以下をチェックします。
-
VDAソフトウェアのインストール
-
VDAマシンのドメインメンバーシップ
-
VDA通信ポートの可用性
-
VDAサービスの状態
-
Windows ファイアウォールの構成
-
Controller との通信
-
Controller との時刻同期
-
VDA 登録ステータス
VDA でのセッション起動について、Scout は以下を確認します。
-
セッション起動通信ポートの可用性
-
セッション起動サービスのステータス
-
セッション起動 Windows ファイアウォールの構成
-
VDA リモートデスクトップサービス クライアントアクセスライセンス
-
VDA アプリケーション起動パス
-
セッション起動レジストリ設定
VDA でのタイムゾーンリダイレクトについて、Scout は以下を確認します。
-
Windows ホットフィックスのインストール
-
Citrix ホットフィックスのインストール
-
Microsoft グループポリシー設定
-
Citrix グループポリシー設定
VDA 上のプロファイル管理について、Scout は以下をチェックします。
-
ハイパーバイザーの検出
-
プロビジョニングの検出
-
シトリックス バーチャル アプリ アンド デスクトップ
-
Personal vDisk の構成
-
ユーザー ストア
-
プロファイル管理サービスのステータス検出
-
Winlogon.exe フック テスト
プロファイル管理のチェックを実行するには、VDA にプロファイル管理をインストールして有効にする必要があります。プロファイル管理の構成チェックの詳細については、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 ライセンスサービスのステータス
-
ライセンスサーバーの猶予期間の状態
-
ライセンスサーバーのポート接続
-
Citrix ベンダーデーモン (CITRIX) が実行中であるか
-
システムクロックが同期されているかどうか
-
Citrix Licensingサービスがローカルサービスアカウントで実行されているかどうか
-
CITRIX.optファイルの存在 -
Customer Success Servicesの資格取得日
-
Citrix License Server アップデート
-
ライセンスサーバー証明書がDelivery Controllerの信頼されたルートストアにあるかどうか
ヘルスチェックの権限と要件を満たすことに加えて、ライセンスサーバーはドメインに参加している必要があります。そうでない場合、ライセンスサーバーは検出されません。
ヘルスチェックの実行
ヘルスチェックの手順は、マシンの選択、チェックの開始、結果レポートの確認で構成されます。
-
Scoutを起動します。マシンのスタートメニューから、Citrix > Citrix Scoutを選択します。開いたページで、Health Checkをクリックします。
-
マシンを選択します。Find machineをクリックしてマシンを検出します。Select machinesページには、サイトで検出されたすべてのVDA、Delivery Controller、およびLicense Serverが一覧表示されます。マシン名で表示をフィルタリングできます。診断情報を収集する各マシンの横にあるチェックボックスを選択し、Continueをクリックします。その他のコンポーネントタイプ(StoreFrontサーバーやVDAマシンなど)を追加するには、マシンを手動で追加およびVDAマシンをインポートを参照してください。Citrix Provisioning™サーバーまたはLicense Serverを手動で追加することはできません。Scoutは、選択された各マシンで検証テストを自動的に起動し、検証テストに記載されている基準を満たしていることを確認します。検証が失敗した場合、Status列にメッセージが表示され、そのマシンのチェックボックスがオフになります。次のいずれかを実行できます。
-
問題を解決し、そのマシンのチェックボックスを再度選択します。これにより、検証テストが再試行されます。
-
そのマシンをスキップします(チェックボックスをオフのままにします)。そのマシンではヘルスチェックは実行されません。
検証テストが完了したら、続行をクリックします。 -
-
選択したマシンでヘルスチェックを実行します。概要には、テストが実行されたマシン(検証テストに合格した選択済みのマシン)が一覧表示されます。チェックの開始をクリックします。チェック中およびチェック後:
-
ステータス列には、マシンの現在のチェック状態が表示されます。
-
進行中のすべてのチェックを停止するには、ページの右下隅にあるチェックの停止をクリックします。(単一のマシンのヘルスチェックをキャンセルすることはできません。選択したすべてのマシンのみです。チェックが完了したマシンからの情報は保持されます。).
-
選択したすべてのマシンのチェックが完了すると、右下隅にあるチェックの停止ボタンが完了に変わります。
-
チェックが失敗した場合は、アクション列の再試行をクリックできます。
-
チェックが問題なく完了した場合、アクション列は空になります。
-
チェックで問題が見つかった場合は、詳細の表示をクリックして結果を表示します。
-
選択したすべてのマシンのチェックが完了したら、戻るをクリックしないでください。(クリックすると、チェック結果が失われます。)
-
-
チェックが完了したら、完了をクリックしてScoutの開始ページに戻ります。
ヘルスチェックの結果
レポートを生成するCitrixチェックの場合、レポートには以下が含まれます。
-
結果レポートが生成された日時
-
チェックされたマシン
-
チェックがターゲットマシンで探した条件
権限と要件
権限:
-
診断情報を収集するには:
-
診断情報を収集する各マシンで、ローカル管理者およびドメインユーザーである必要があります。
-
各マシンでLocalAppDataディレクトリへの書き込み権限が必要です。
-
-
ヘルスチェックを実行するには:
-
ドメインユーザーグループのメンバーである必要があります。
-
フル管理者であるか、サイトに対する読み取り専用および環境テストの実行権限を持つカスタムロールを持っている必要があります。
-
スクリプトの実行を許可するには、スクリプト実行ポリシーを少なくとも
RemoteSignedに設定します。例:Set-ExecutionPolicy RemoteSigned。注: 他のスクリプト実行権限でも機能する場合があります。
-
-
Scoutを起動するときは、管理者として実行を使用します。
診断情報を収集したり、ヘルスチェックを実行したりする各マシンについて:
-
Scoutがマシンと通信できる必要があります。
-
ファイルとプリンターの共有が有効になっている必要があります。
-
PSRemotingとWinRMが有効になっている必要があります。また、マシンではPowerShell 3.0以降が実行されている必要があります。
-
Citrix Telemetry Service はマシン上で実行されている必要があります。
-
Windows Management Infrastructure (WMI) アクセスはマシン上で有効になっている必要があります。
-
診断収集のスケジュールを設定するには、マシンで互換性のあるScoutバージョンが実行されている必要があります。
パス名で指定するユーザー名にドル記号 ($) を使用しないでください。診断情報の収集が妨げられます。
Scout は、選択したマシンで検証テストを実行し、これらの要件が満たされていることを確認します。
Windows 用の Telemetry Service は Network Service で実行されます。
AOT トレースフォルダーは
C:\ProgramData\Citrix\TelemetryService\CitrixAOT に保存されます。
Administrator グループ、System、および Telemetry Service SID のユーザーのみが
HKEYLOCALMACHINE:SOFTWARE\Citrix\Telemetry レジストリにアクセスする権限を持っています。
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 および XenDesktop 7.14 にアップグレードしてください。
-
WMI がマシンで実行されていません - Windows Management Instrumentation (WMI) アクセスが有効になっていることを確認してください。
-
WMI 接続がブロックされています - Windows ファイアウォールサービスで WMI を有効にしてください。
-
新しいバージョンの Citrix Telemetry Service が必要です - (バージョンは、収集とトレースおよび再現の場合にのみチェックされます。) マシン上のテレメトリサービスバージョンをアップグレードしてください (インストールとアップグレード を参照)。サービスをアップグレードしない場合、そのマシンは 収集 または トレースおよび再現 アクションに含まれません。
-
Scout がこのマシン上の systemd ソケットに接続できません - 以下を確認してください。
-
ポート 7503 が開いています。systemd ctxtelemetry.socket がマシン上のポート 7503 でリッスンしていることを確認してください。ctxtelemetry.socket ポートが変更されている場合、ポートが異なる可能性があります。ポートを調整するには、Scout の構成 を参照してください。
-
ネットワーク接続が正常に機能しています。(これには、ファイアウォールが適切に構成されていることの確認が含まれる場合があります。)
-
-
このマシンで Linux VDA Telemetry Service が開始されていません - 以下を確認してください。
-
ポート7502が開いています。マシンにLinux VDAテレメトリーサービスがインストールされ、起動していることを確認してください。テレメトリーサービスのポートが変更されている場合、ポートが異なる可能性があります。ポートを調整するには、Scoutの構成を参照してください。
-
ネットワーク接続が正常に機能しています。(これには、ファイアウォールが適切に構成されていることの確認が含まれる場合があります。)
-
バージョンの互換性
このバージョンのScout(3.x)は、Citrix Virtual Apps and Desktops(または最低でもXenAppおよびXenDesktop 7.14)のコントローラーおよび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トレースをキャプチャ | はい | はい 常時オンのトレース(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アドレスとポート番号を指定することもできます。
マシンの検索
Collect、Trace & Reproduce、およびScheduleの手順では、Scoutは自動的に検出したControllerとVDAを一覧表示します。
Delivery ControllerからScout Health Checkを実行するときは、Find machineをクリックして、デリバリーコントローラー、VDA、ライセンスサーバー、StoreFrontサーバーなどのマシンを検出します。
Delivery Controllerではないドメイン参加済みマシンからScout Health Checkを実行する場合、Scoutはマシンを自動的に検出できません。add machines manuallyまたはimport VDA machinesする必要があります。
マシンを手動で追加する
Scoutが検出したControllerとVDAをリストした後、StoreFrontサーバー、ライセンスサーバー、Citrix Provisioningサーバーなど、展開内の他のマシンを手動で追加できます。
ヘルスチェックを実行する場合:
-
ドメイン内のCitrix License Serverは自動的に検出されます。License Serverを手動で追加することはできません。
-
ヘルスチェックは現在、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」ページに一覧表示されます。
診断情報の収集
-
マシンを選択します。
-
コントローラーでは、 ページにサイト内のすべてのVDAとコントローラーが一覧表示されます。マシン名で表示をフィルターできます。その他のマシン(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とコントローラーが一覧表示されます。マシン名で表示をフィルタリングできます。トレースと診断を収集する各マシンの横にあるチェックボックスをオンにします。次に、続行をクリックします。他のマシン(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のホームページで、「Trace & Reproduce」をクリックします。
-
「Select machines」ページで、ローカルマシンの右側にある歯車アイコンをクリックします。
-
「Select the tools require for logging:」ページで、「Download Tools」をクリックします。
-
「Download Tools」ページで、使用したいツールを選択し、「Download」をクリックします。Wiresharkを除き、ツールがダウンロードされます。Wiresharkは手動でのみダウンロードおよびインストールできます。 注:他のツールを手動でダウンロードすることを選択した場合、ダウンロードした.zipファイルの内容を
C:\ProgramData\Citrix\TelemetryService\CDC\Lib\Resources\Tools\<toolname>に抽出する必要があります。たとえば、DebugView.zipファイルをダウンロードした場合、そのファイルの内容をC:\ProgramData\Citrix\TelemetryService\CDC\Lib\Resources\Tools\DebugView\に解凍します。 -
「Select the tools require for logging:」ページで、「Refresh Status」をクリックします。選択されたすべてのツールが、ステータス列の下に「Present」と表示されます。
-
ログ記録用のツールを選択し、「Next」をクリックします。
-
Trace and Reproduceの手順に従います。
-
完了後、zipファイル内のログを確認します。ログはCDCLogsフォルダーに圧縮されています。
注:
Procmonツールがトレース用に選択されている場合、Process Monitorのログはすぐに大きくなる可能性があります。必要なツールのみを選択するようにしてください。ログのサイズは*%temp%\Scout-CDC-Log*で監視することもできます。
コレクションのスケジュール
注:
現在、コレクションはスケジュールできますが、ヘルスチェックはスケジュールできません。
スケジュール手順は、マシンを選択し、スケジュールを設定またはキャンセルすることから構成されます。スケジュールされたコレクションは自動的にCitrixにアップロードされます。(PowerShellインターフェイスを使用して、スケジュールされたコレクションをローカルに保存できます。Citrix Call Homeを参照してください。)
-
Scoutを起動します。マシンのスタートメニューから「Citrix > Citrix Scout」を選択します。開いたページで「Schedule」をクリックします。
-
マシンを選択します。サイト内のすべての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アカウントの場合は、トークンの生成をクリックします。デフォルトのブラウザがCitrix Cloudページに起動し、トークンが表示されます。トークンをコピーし、Scoutページに貼り付けます。
-
Citrixアカウントの場合は、資格情報を入力します。
完了したら、続行をクリックします。構成されたスケジュールを確認します。完了をクリックして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」を選択します。このオプションはデフォルトで有効になっています。
-
データマスクを構成します。デフォルトのルールでデータマスキングを実行することも、ルールをカスタマイズすることもできます。
-
診断コレクションをアップロードするか保存するかを選択します。
-
診断コレクションをCitrixにアップロードを選択すると、マスクされた診断ファイルがCitrixにアップロードされます。
-
診断コレクションをローカルマシンに保存を選択すると、元の診断とマスクされた診断の両方が指定された場所に保存されます。
-
マスクされたデータファイルとマッピングファイルの場所
診断コレクションをアップロードまたは保存した後、リンクをクリックして元の診断とマスクされた診断を開き、マッピング情報ファイルを開きます。
使用状況データの収集
Scoutを使用すると、CitrixはGoogle Analyticsを使用して匿名の使用状況データを収集し、将来の製品機能や改善に役立てます。データ収集はデフォルトで有効になっています。
使用状況データの収集とアップロードを変更するには、Scout UIの設定ギアをクリックします。その後、はいまたはいいえを選択し、保存をクリックして情報を送信するかどうかを選択できます。