Citrix Virtual Apps and Desktops

Always On Tracingの一般的な問題のトラブルシューティング

対象: Citrix Virtual Apps and Desktops 2402 CU4、2507 CU1、2511、2603以降、DaaS

必須: AOTログサーバーが展開済み。AuthKeyがDirectorまたはMonitorの設定で構成済み

Always On Tracing (AOT) は、すべてのCitrixコンポーネント(VDA、Delivery Controller、StoreFront、License Server、Citrix Workspaceアプリ)でログを継続的にキャプチャします。問題が報告された時点で、データはすでに存在しています。この記事では、Citrix DirectorまたはMonitorのログノードを使用して問題の原因を特定する方法と、Citrixテクニカルサポートに提出するためにDirectorまたはMonitorからログをエクスポートする方法について説明します。

開始する前に — すべてのシナリオでこれを収集してください

  • 影響を受けるユーザーまたはマシン — 特定のユーザー名、VDAホスト名、またはデリバリーグループ名
  • 障害発生時刻 — おおよその時間帯でも、デフォルトの時間フィルターを絞り込むのに役立ちます。報告された障害発生前の期間をカバーするように時間範囲を調整してください。
  • 範囲 — 1人のユーザー、1台のマシン、または環境全体か?ログを開く前に、範囲だけで正しい障害パターンがわかることがよくあります
  • 最近の変更 — 関連する期間におけるCVADの更新、グループポリシーの変更、電源管理の変更、またはネットワークの変更

DirectorおよびMonitorのログノード

ログノードは、Citrix Director (オンプレミスCVAD) と Citrix Monitor (DaaS) の両方で利用できます。アクセスするには、左側のナビゲーションパネルからログを選択します。インターフェイスは両方の環境で同じです。

AOT Monitorログ (注釈付き)

  1. 検索バー — キーワード、トランザクションID、カテゴリ、またはホスト名
  2. 時間フィルター — 障害をカバーする時間帯を選択します
  3. カテゴリフィルター — イベントタイプでフィルター
  4. ログレベルフィルター — 重大度でフィルター
  5. ホスト名フィルター — 1つ以上のマシンを選択
  6. 適用ボタン — すべてのアクティブなフィルター選択を適用
  7. エクスポートアイコン — ログをダウンロードしてCitrixテクニカルサポートに提出

フィルターバー

フィルターバーには4つのフィルターと、独立した適用ボタンがあります。まずフィルターを設定し、次に適用をクリックしてログビューを更新します。現在のログ数はフィルターバーの下に表示されます(例:バッチ1に850個のログ)。バッチナビゲーション矢印を使用して、大量の結果セットをページ移動します。

フィルター 機能 オプション
時間 ログ取得の時間枠を設定します。報告された障害に至るイベントをキャプチャするために、障害発生前に開始する時間枠に設定してください。 過去5分 · 過去1時間 · 過去24時間 · 過去48時間 · 過去7日間 · カスタム (UTC) (CVAD 2603以降のクラウドリリースのみ)
カテゴリ イベントタイプでフィルターします。各カテゴリはCitrixコンポーネントのライフサイクルの特定の部分に対応しています。名前でカテゴリを素早く見つけるための検索カテゴリフィールドが含まれています。 アプリケーション起動 · クリップボード · CWA-PostLaunch · CWA-PreLaunch · データベース · デバイス · など
ログレベル 重大度でフィルタリングします。1つ以上選択します。選択がアクティブな場合、ボタンのラベルには選択された数が表示されます(例: 1 Log Level Selected)。 情報 · 警告 · エラー · 重大
ホスト名 1つ以上の特定のコンピューターにフィルタリングします。ホスト検索フィールドと、現在ログサーバーにログを送信しているすべてのコンピューターのチェックボックスリストが含まれます。アクティブな場合、N Hostname Selectedと表示されます。 ログサーバーに登録されているすべてのコンピューター
ログレベル 使用するタイミング
情報 標準コンポーネントイベント — セッション開始、VDA登録、ライセンスチェックアウト。完全なライフサイクルシーケンスを確認するために使用します。
警告 問題を示す可能性のある非重大な問題 — セッション切断、アイドルタイムアウト、ハートビート警告。切断シナリオの場合はここから開始します。
エラー 調査が必要な障害 — 起動エラー、登録失敗、ライセンス枯渇。ほとんどのシナリオの場合はここから開始します。
重大 サービスに影響を与える重大な障害 — 通常、コンポーネントのクラッシュまたは回復不能な状態

ログテーブル — 列

ログテーブルには、各エントリに対してデフォルトで5つの列が表示されます。列ボタンをクリックすると、新しい列を追加できます。任意の行の > 展開矢印をクリックすると、完全なログメッセージと追加フィールドが表示されます。

AOTモニターログメイン

アプリケーション起動カテゴリがアクティブなログテーブル。ログ数とバッチナビゲーションはテーブルの上に表示されます。> 矢印で任意の行を展開して、完全なメッセージを読みます。

表示内容
時刻 (UTC) イベントのUTCタイムスタンプ(ミリ秒精度)。発生順にイベントのシーケンスを読み取るには、昇順でソートします。
ログレベル 重大度バッジ: 情報、警告、エラー、または致命的
メッセージ コンポーネントからのログメッセージ。テーブルでは切り詰められています — 行の > 展開矢印をクリックして完全なメッセージを読みます。完全なメッセージは主要な診断テキストです。
ホスト名 ログエントリを生成したマシン
ホストタイプ コンポーネントタイプ: DDC、StoreFront、WVDA (Windows VDA)、CWAWindows、その他Log Serverに登録されているもの

Citrixテクニカルサポート向けログのエクスポート

エクスポートアイコン(上記の注釈付きスクリーンショットの7)は、ログセクションの右上隅に表示されます。これを使用して、現在フィルターされているログビューをファイルとしてダウンロードします。エクスポートする前に:

バージョン提供状況:

エクスポートアイコンは、DaaSではCloud 129(2026年4月~5月)リリース以降、Citrix Virtual Apps and DesktopsではCVAD 2603以降で利用可能です。以前のバージョンではこのオプションは利用できません。

AuthKeyが必要です:

ログノードは、AuthKeyがDirectorまたはMonitorの設定で構成されている場合にのみデータを表示します。AuthKeyはLog Serverのセットアップ中に生成されます。AuthKeyがない場合、ログノードにはエントリが表示されません。

シナリオ1:セッション起動の失敗

ユーザーが公開デスクトップまたはアプリケーションをクリックすると、起動エラーが発生します。セッションは開かず、エラーがCitrix Workspaceアプリの画面に表示されるか、プログレスバーが停止してタイムアウトし、セッションが接続されません。

ログノードで、カテゴリアプリケーション起動に、ログレベルエラーに設定し、時間を障害発生期間に調整します。適用をクリックします。時間 (UTC) で昇順に並べ替え、メッセージホストタイプの列を一緒に読み取ると、起動パスのどのコンポーネントが失敗し、何が報告されたかがわかります。

参照のみ:

以下のログメッセージは例示的なものです。実際の環境でのメッセージは、同じ形式と列構造に従いますが、正確な文言は異なる場合があります。

例:デリバリーグループで利用可能なVDAがない

DDCは起動要求を受信しましたが、デスクトップを割り当てることができませんでした。デリバリーグループ内のすべてのVDAが未登録であるか、セッション容量に達していました。

時刻 (UTC) ログレベル メッセージ ホスト名 ホストの種類
2026-07-20T09:14:22.1034Z 情報 アプリケーション起動: ユーザー DOMAIN\jsmith がデリバリーグループ ‘Windows 11 VDAs’ からデスクトップを要求しました DDC-01 DDC
2026-07-20T09:14:22.3841Z エラー アプリケーション起動: 適切なデスクトップが見つかりませんでした — デリバリーグループ ‘Windows 11 VDAs’ 内のすべての VDA が未登録であるか、セッション容量に達しています DDC-01 DDC
2026-07-20T09:14:22.4102Z エラー アプリケーション起動: ユーザー DOMAIN\jsmith の起動に失敗しました — 利用可能なリソースがありません STF-01 StoreFront

DDCからのエラーは、ブローカーが利用可能なVDAを見つけられなかったことを示しています。Web Studio → Search MachinesでVDA登録を確認してください。シナリオ2: VDA登録の失敗で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::仮想チャネル: 仮想ドライバーの読み込みに失敗しました — チャネルネゴシエーションがタイムアウトしました。ポート1494および2598のファイアウォールルールを確認してください。 Win22-CC-01 CWAウィンドウズ

ホストタイプ CWAWindows で CWA-POSTLAUNCH エラーが発生した場合、VDA は準備ができていたものの、クライアントと VDA 間の ICA データパスがブロックされていたことを意味します。クライアントマシンから VDA へのポート 1494 および 2598 が開いていることを確認してください。

シナリオ 2: VDA 登録の失敗

Director または Web Studio → マシンの検索で、VDA が 未登録 と表示されます。ユーザーには「現在、利用可能なデスクトップはありません。」と表示されます。公開されたデスクトップは、StoreFront™ または Citrix Workspace™ でグレー表示されます。

[ログ] ノードで、カテゴリVDA 登録 に、ログレベルエラー に設定し、ホスト名 を影響を受ける VDA と DDC の両方に設定します。適用 をクリックします。登録ハンドシェイクの両側(同じタイムスタンプの VDA 行と DDC 行)を合わせて読むことで、障害がどこで発生したかを正確に示します。

参照のみ:

以下のログメッセージは例示です。実際の環境でのメッセージは、同じ形式と列構造に従いますが、正確な表現は異なる場合があります。

例: VDA が Delivery Controller に到達できない

VDA は登録を試みていますが、DDC はリクエストを受信していません。VDA 側のエラーのみが表示され、同じタイムスタンプの DDC 行は一致しません。

時刻 (UTC) ログレベル メッセージ ホスト名 ホストタイプ
2026-07-20T08:30:11.2341Z エラー 登録: Delivery Controller DDC-01.domain.com にポート 443 で接続できませんでした — 接続がタイムアウトしました WIN11MS-CC-VDA4 WVDA
2026-07-20T08:30:41.2341Z エラー 登録: Delivery Controller DDC-01.domain.com にポート 443 で接続できませんでした — 接続がタイムアウトしました WIN11MS-CC-VDA4 WVDA
2026-07-20T08:31:11.2341Z エラー 登録: Delivery Controller DDC-01.domain.com にポート 443 で接続できませんでした — 接続がタイムアウトしました WIN11MS-CC-VDA4 WVDA

同じエラーが一定の間隔で繰り返されるのは、リトライループです — VDA は稼働していますがブロックされています。VDA から DDC へのポート 80 および 443 が開いていることを確認し、VDA 上の ListOfDDCs レジストリキーで古いまたは誤った DDC アドレスがないか確認してください。

例: DDC が登録要求を拒否する

VDA は DDC に到達しましたが、DDC はその登録を拒否しました。VDA と DDC の両方の行が表示されます。拒否理由については DDC メッセージを読んでください。

時刻 (UTC) ログレベル メッセージ ホスト名 ホストタイプ
2026-07-20T08:30:11.2341Z 情報 登録: VDA WIN11MS-CC-VDA4 が DDC-01.domain.com への登録を試行中 WIN11MS-CC-VDA4 WVDA
2026-07-20T08:30:11.8820Z エラー 登録: 登録が拒否されました — マシンアカウント 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 エラー 登録: 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 — プレースホルダーを使用してログノードの検索バーで検索可能: 「トランザクションID、キーワード、カテゴリ、ホスト名でログを検索」

AOTは継続的にログをキャプチャし、すべてのエントリにホスト名、ホストタイプ、タイムスタンプが含まれているため、Citrixテクニカルサポートは、問題の再現や新しいトレースの収集を依頼することなく、すぐに分析を開始できます。

Always On Tracingの一般的な問題のトラブルシューティング