Always On Tracing の一般的な問題のトラブルシューティング
適用対象: Citrix Virtual Apps and Desktops 2402 CU4、2507 CU1、2511、2603 以降、DaaS
要件: AOT Log Server が展開されていること。AuthKey が Director または Monitor の設定で構成されていること。
Always On Tracing (AOT) は、VDA、Delivery Controller、StoreFront、License Server、Citrix Workspace App など、すべての Citrix コンポーネントでログを継続的にキャプチャします。問題が報告された場合でも、データはすでに存在します。この記事では、Citrix Director または Monitor の ログ ノードを使用して問題の原因を特定する方法と、Citrix テクニカルサポートに提出するために Director または Monitor からログをエクスポートする方法について説明します。
開始する前に — すべてのシナリオでこれを収集してください
-
影響を受けるユーザーまたはマシン — 特定のユーザー名、VDA ホスト名、またはデリバリーグループ名
-
障害発生時刻 — おおよその時間枠でも、デフォルトの時間フィルターを絞り込むのに役立ちます。報告された障害発生前の期間をカバーするように時間範囲を調整してください。
-
範囲 — 1人のユーザー、1台のマシン、それとも環境全体か?ログを開く前に、範囲だけで正しい障害パターンを特定できることがよくあります。
-
最近の変更 — 関連する期間における CVAD の更新、グループポリシーの変更、電源管理の変更、またはネットワークの変更
Director および Monitor のログノード
ログノードは、Citrix Director (オンプレミス CVAD) と Citrix Monitor (DaaS) の両方で利用できます。アクセスするには、左側のナビゲーションパネルから ログ を選択します。インターフェイスはどちらの環境でも同じです。
-
検索バー — キーワード、トランザクション ID、カテゴリ、またはホスト名
-
時間フィルター — 障害をカバーする時間枠を選択します
-
カテゴリフィルター — イベントタイプでフィルターします
-
ログレベルフィルター — 重大度でフィルター
-
ホスト名フィルター — 1つ以上のマシンを選択
-
適用ボタン — すべてのアクティブなフィルター選択を適用します
-
エクスポートアイコン — ログをダウンロードしてCitrixテクニカルサポートに提出
フィルターバー
フィルターバーには4つのフィルターと、独立した適用ボタンがあります。まずフィルターを設定し、次に適用をクリックしてログビューを更新します。現在のログ数はフィルターバーの下に表示されます(例:バッチ1に850個のログ)。バッチナビゲーション矢印を使用して、大規模な結果セットをページ移動します。
| フィルター | 機能 | オプション |
|---|---|---|
| 時間 | ログ取得の時間枠を設定します。報告された障害の前に開始する時間枠に設定して、障害に至ったイベントをキャプチャします。 | 過去5分 · 過去1時間 · 過去24時間 · 過去48時間 · 過去7日間 · カスタム (UTC) (CVAD 2603以降のクラウドリリースのみ) |
| カテゴリ | イベントタイプでフィルターします。各カテゴリは、Citrixコンポーネントのライフサイクルの特定の部分に対応しています。名前でカテゴリをすばやく見つけるためのカテゴリ検索フィールドが含まれています。 | アプリケーション起動 · クリップボード · CWA-PostLaunch · CWA-PreLaunch · データベース · デバイス · など |
| ログレベル | 重大度でフィルターします。1つ以上選択します。選択がアクティブな場合、ボタンのラベルには選択された数が表示されます(例:1つのログレベルが選択済み)。 | 情報 · 警告 · エラー · 重大 |
| ホスト名 | 1つまたは複数の特定のコンピューターにフィルターを適用します。検索ホストフィールドと、現在ログサーバーにログを送信しているすべてのコンピューターのチェックボックスリストが含まれます。アクティブな場合、*N ホスト名が選択されました*と表示されます。 | ログサーバーに登録されているすべてのコンピューター |
| ログレベル | 使用するタイミング |
|---|---|
| 情報 | 標準コンポーネントイベント — セッション開始、VDA登録、ライセンスチェックアウト。完全なライフサイクルシーケンスを確認するために使用します。 |
| 警告 | 問題を示す可能性のある重要ではない問題 — セッション切断、アイドルタイムアウト、ハートビート警告。切断シナリオの場合はここから開始します。 |
| エラー | 調査が必要な障害 — 起動エラー、登録失敗、ライセンス枯渇。ほとんどのシナリオの場合はここから開始します。 |
| 重大 | サービスに影響を与える重大な障害 — 通常、コンポーネントのクラッシュまたは回復不能な状態 |
ログテーブル — 列
ログテーブルには、各エントリに対してデフォルトで5つの列が表示されます。列ボタンをクリックすると、新しい列を追加できます。いずれかの行にある > 展開矢印をクリックすると、完全なログメッセージと追加フィールドが表示されます。
アプリケーション起動カテゴリがアクティブなログテーブル。ログ数とバッチナビゲーションはテーブルの上に表示されます。> 矢印で任意の行を展開して、完全なメッセージを読みます。
| 列 | 表示される内容 |
|---|---|
| 時刻 (UTC) | イベントのUTCタイムスタンプ。ミリ秒単位の精度。発生順にイベントのシーケンスを読み取るには、昇順でソートします。 |
| ログレベル | 重大度バッジ: 情報、警告、エラー、または致命的 |
| メッセージ | コンポーネントからのログメッセージ。テーブルでは切り詰められています。行の > 展開矢印をクリックして、完全なメッセージを読み取ります。完全なメッセージは主要な診断テキストです。 |
| ホスト名 | ログエントリを生成したマシン |
| ホストの種類 | コンポーネントの種類: DDC、StoreFront、WVDA (Windows VDA)、CWAWindows、およびログサーバーに登録されているものに応じてその他の種類。 |
Citrixテクニカルサポート向けログのエクスポート
エクスポートアイコン (上記の注釈付きスクリーンショットの 7) は、ログセクションの右上隅に表示されます。これを使用して、現在フィルターされているログビューをファイルとしてダウンロードします。エクスポートする前に:
バージョン提供状況:
エクスポートアイコンは、Cloud 129 (2026年4月~5月) リリース以降のDaaSで利用でき、CVAD 2603以降のCitrix Virtual Apps and Desktopsでも利用できます。それ以前のバージョンではこのオプションは利用できません。
AuthKeyが必要です:
「ログ」ノードは、AuthKeyがDirectorまたはMonitorの設定で構成されている場合にのみデータを表示します。AuthKeyはログサーバーのセットアップ中に生成されます。AuthKeyがない場合、「ログ」ノードにはエントリが表示されません。
シナリオ1:セッション起動の失敗
ユーザーが公開されたデスクトップまたはアプリケーションをクリックすると、起動エラーが発生します。セッションは開かれません。エラーはCitrix Workspaceアプリの画面に表示されるか、進行状況バーが停止してタイムアウトし、セッションが接続されない場合があります。
「ログ」ノードで、カテゴリをアプリケーション起動に、ログレベルをエラーに設定し、時間を障害発生期間をカバーするように調整します。適用をクリックします。時間 (UTC) で昇順に並べ替え、メッセージとホストタイプの列を一緒に読み取ります。これらは、起動パスのどのコンポーネントが失敗し、それが何を報告したかを示します。
参照のみ:
以下のログメッセージは例示的なものです。実際の環境でのメッセージは、同じ形式と列構造に従いますが、正確な文言は異なる場合があります。
例:デリバリーグループで利用可能なVDAがない
DDCは起動要求を受信しましたが、デスクトップを割り当てることができませんでした。デリバリーグループ内のすべてのVDAが登録解除されているか、セッション容量に達していました。
| 時間 (UTC) | ログレベル | メッセージ | ホスト名 | ホストタイプ |
|---|---|---|---|---|
| 2026-07-20T09:14:22.1034Z | 情報 | APPLICATION LAUNCH: ユーザー DOMAIN\jsmith がデリバリーグループ 'Windows 11 VDAs' からデスクトップを要求しました | DDC-01 | DDC |
| 2026-07-20T09:14:22.3841Z | エラー | APPLICATION LAUNCH: 適切なデスクトップが見つかりませんでした — デリバリーグループ 'Windows 11 VDAs' 内のすべての VDA が未登録であるか、セッション容量に達しています | DDC-01 | DDC |
| 2026-07-20T09:14:22.4102Z | エラー | APPLICATION LAUNCH: ユーザー DOMAIN\jsmith の起動に失敗しました — 利用可能なリソースがありません | STF-01 | StoreFront |
DDC からのエラーは、ブローカーが利用可能な VDA を見つけられなかったことを示しています。Web Studio → で VDA の登録を確認してください。VDA 登録のトラブルシューティングについては、シナリオ 2: VDA 登録の失敗 を参照してください。
例: VDA は割り当てられたが、セッションの初期化に失敗した
DDC は VDA を割り当てましたが、VDA はセッションを開始できませんでした。一般的な原因としては、FSLogix またはローミングプロファイルコンテナの障害、グループポリシー処理エラー、または VDA リソースの枯渇が挙げられます。
| 時刻 (UTC) | ログレベル | メッセージ | ホスト名 | ホストの種類 |
|---|---|---|---|---|
| 2026-07-20T09:22:11.0234Z | 情報 | アプリケーション起動: ユーザー DOMAIN\jsmith の VDA WIN11MS-CC-VDA4 が選択されました | DDC-01 | DDC |
| 2026-07-20T09:22:11.8820Z | エラー | アプリケーション起動: ユーザー DOMAIN\jsmith のセッション初期化に失敗しました — FSLogix プロファイルコンテナを \\fileserver\profiles\jsmith.vhdx にマウントできませんでした |
WIN11MS-CC-VDA4 | WVDA |
| 2026-07-20T09:22:12.0011Z | エラー | アプリケーション起動: 起動要求が失敗しました — VDA WIN11MS-CC-VDA4 がユーザー DOMAIN\jsmith のセッション準備エラーを報告しました | DDC-01 | DDC |
ホストタイプWVDAからのエラーは、VDAを障害点として特定し、メッセージには正確な原因が表示されます。その行の**>**展開矢印をクリックして、完全なプロファイルコンテナパスとエラーコードを含む完全なメッセージを読みます。
例: CWA起動中の仮想チャネルエラー
セッションはVDA側で作成されましたが、CWAクライアントはICA仮想チャネル接続を確立できませんでした。ホスト名をCWAマシンでフィルタリングして、クライアント側のエラーを確認します。
| 時刻 (UTC) | ログレベル | メッセージ | ホスト名 | ホストタイプ |
|---|---|---|---|---|
| 2026-07-20T09:31:04.5521Z | 情報 | アプリケーション起動: シームレスホスト仮想ドライバーが正常に初期化されました | WIN11MS-CC-VDA4 | WVDA |
| 2026-07-20T09:31:05.1204Z | エラー | CWA-POSTLAUNCH::VIRTUAL CHANNEL: 仮想ドライバーのロードに失敗しました — チャネルネゴシエーションがタイムアウトしました。ポート1494および2598のファイアウォールルールを確認してください。 | ウィン22-CC-01 | CWA (ウィンドウズ版) |
ホストタイプCWAWindowsでCWA-POSTLAUNCHエラーが発生した場合、VDAは準備ができていたものの、クライアントとVDA間のICAデータパスがブロックされていたことを意味します。クライアントマシンからVDAへのポート1494および2598が開いていることを確認してください。
シナリオ2:VDA登録の失敗
VDAはDirectorまたはWeb Studio → Search Machinesで未登録と表示されます。ユーザーには「現在、利用可能なデスクトップはありません。」と表示されます。公開されたデスクトップはStoreFrontまたはCitrix Workspaceでグレー表示されます。
ログノードで、カテゴリをVDA登録に、ログレベルをエラーに設定し、ホスト名を影響を受けるVDAとDDCの両方に設定します。適用をクリックします。登録ハンドシェイクの両側(同じタイムスタンプのVDA行とDDC行)を一緒に読むことで、障害がどこで発生したかを正確に示します。
参照のみ:
以下のログメッセージは例示です。お使いの環境での実際のメッセージは、同じ形式と列構造に従いますが、正確な文言は異なる場合があります。
例:VDAがDelivery Controllerに到達できない
VDAは登録を試みていますが、DDCはリクエストを受信しません。VDA側のエラーのみが表示され、同じタイムスタンプで一致するDDC行はありません。
| 時刻 (UTC) | ログレベル | メッセージ | ホスト名 | ホストタイプ |
|---|---|---|---|---|
| 2026-07-20T08:30:11.2341Z | エラー | 登録: ポート443でDelivery Controller DDC-01.domain.comに接続できませんでした — 接続がタイムアウトしました | WIN11MS-CC-VDA4 | WVDA |
| 2026-07-20T08:30:41.2341Z | エラー | 登録: ポート443でDelivery Controller DDC-01.domain.comに接続できませんでした — 接続がタイムアウトしました | WIN11MS-CC-VDA4 | WVDA |
| 2026-07-20T08:31:11.2341Z | エラー | 登録: ポート443でDelivery Controller DDC-01.domain.comに接続できませんでした — 接続がタイムアウトしました | WIN11MS-CC-VDA4 | WVDA |
同じエラーが一定の間隔で繰り返されるのは再試行ループです。VDAは稼働していますがブロックされています。VDAからDDCへのポート80と443が開いていることを確認し、VDAの
ListOfDDCsレジストリキーで古いまたは誤ったDDCアドレスをチェックしてください。
例: DDCが登録要求を拒否する
VDAはDDCに到達しましたが、DDCはVDAの登録を拒否しました。VDAとDDCの両方の行が表示されます。拒否理由についてはDDCメッセージを読んでください。
| 時刻 (UTC) | ログレベル | メッセージ | ホスト名 | ホストタイプ |
|---|---|---|---|---|
| 2026-07-20T08:30:11.2341Z | 情報 | REGISTRATION: VDA WIN11MS-CC-VDA4 が DDC-01.domain.com への登録を試行しています | WIN11MS-CC-VDA4 | WVDA |
| 2026-07-20T08:30:11.8820Z | エラー | REGISTRATION: 登録が拒否されました — マシンアカウント WIN11MS-CC-VDA4$ が無効になっているか、Active Directory に見つかりません | DDC-01 | DDC |
エラー行はホストタイプDDCから来ています。DDCが障害点であり、VDAではありません。DDC行の**>**展開矢印をクリックして、拒否理由の全文を読んでください。一般的な理由としては、Active Directoryでのマシンアカウントの無効化、VDA/DDCのバージョン不一致、ライセンスプールの枯渇などがあります。
例:VDAが登録された後、すぐに登録解除される
登録は成功しますが、DDCが数秒以内に登録解除を開始します。これがループで繰り返されます。電源管理ドレインポリシーにより、VDAがセッションを受け入れる前にシャットダウンされています。
| 時刻 (UTC) | ログレベル | メッセージ | ホスト名 | ホストタイプ |
|---|---|---|---|---|
| 2026-07-20T09:01:33.1240Z | 情報 | 登録:VDA WIN11MS-CC-VDA4がDDC-01.domain.comに正常に登録されました | WIN11MS-CC-VDA4 | WVDA |
| 2026-07-20T09:01:47.4421Z | エラー | 電源管理:PowerManagementDrainが開始されました — デリバリーグループの電源ポリシーにより、マシンはシャットダウンがスケジュールされています | WIN11MS-CC-VDA4 | WVDA |
| 2026-07-20T09:01:47.6830Z | エラー | REGISTRATION: VDA WIN11MS-CC-VDA4 の登録が解除されました — 理由: 電源管理によるドレイン | DDC-01 | DDC |
登録と登録解除の間の14秒のギャップが原因です。Web Studio → デリバリーグループ → 電源管理 を確認し、営業時間中に適用されているドレインまたはシャットダウンのスケジュールがないか確認してください。
注:
この記事のシナリオは、Citrix Director または Monitor でログを検索および調査する方法の例です。同じ方法論は、セッション障害、認証エラー、接続の問題、VDA の不安定性、またはその他のコンポーネントレベルの問題など、遭遇するあらゆる Citrix 関連の問題に適用されます。適切な カテゴリ、ログレベル、および ホスト名 フィルターを設定し、時間 (UTC) 順にログシーケンスを読み取り、個々の行を展開して完全な メッセージ を読み取ります。最初にエラーをログに記録したコンポーネントとメッセージの内容が、シナリオに関係なく根本原因を示します。
ヒント — Citrix Aidrien アクセス権を持つ DaaS のお客様へ: AOT ログからエラーメッセージをコピーし、Citrix Aidrien に直接貼り付けます。Aidrien がエラーを説明し、推奨されるトラブルシューティング手順を提供します。これだけであらゆる問題が解決するわけではありませんが、根本原因を絞り込み、多くの場合、Citrix テクニカルサポートに連絡する前に解決策へと導きます。
Citrix テクニカルサポートへのエスカレーション
セルフサービスによる調査で問題が解決しない場合は、サポートチケットを開く際に以下を含めてください。
-
障害発生期間をカバーするエクスポートされたログファイル — 上記のオプション 7 で説明されているエクスポートアイコンを使用します。状況に応じて、2つの方法でエクスポートできます。
-
ターゲットを絞ったエクスポート — 時間、カテゴリ、ホスト名のフィルターを適用してからエクスポートします。これにより、サポートは障害に絞り込んだログセットを得ることができます。
-
広範囲なエクスポート — 時間フィルターのみを適用し、他のフィルターなしでエクスポートします。これにより、サポートは障害発生期間のログ全体像を得ることができ、範囲が不明確な場合に役立ちます。
ファイルがダウンロードされると、ファイル名には AOT がプレフィックスとして付加されます。このプレフィックスを削除したり、名前を変更したりしないでください。その後のファイル名の部分は編集できますが、常に先頭に AOT を保持してください。 -
-
上記のセクションで特定された障害パターン
-
CVADバージョン、コンポーネントバージョン(VDA、DDC、StoreFront)、およびログサーバーバージョン
-
失敗したイベントのトランザクションIDまたはセッションID — プレースホルダー「"Search logs by transaction ID, keyword, category, hostname"」を使用してログノードの検索バーで検索可能
AOTはログを継続的にキャプチャし、すべてのエントリにホスト名、ホストタイプ、タイムスタンプが含まれているため、Citrixテクニカルサポートは、問題の再現や新しいトレースの収集を依頼することなく、すぐに分析を開始できます。