CVADコアコンポーネントからのAOTログのアップロード

最終公開日 : Nov 13, 2026
CVAD 2507 CU1およびCVAD 2511以降、AOTログはすべての該当するコンポーネントから収集されます。サポートされているコンポーネントには、DDC、StoreFront、Citrix Director、Windows VDA、Linux VDA、Mac VDA、License Server、FAS、Cloud Connector、PVS、WEM、Session Recording、Citrix Workspace UI、およびCitrix Gatewayが含まれます。
Related information
Citrix Always On トレース

CVADオンプレミス向けCitrix Web Studioを介した集中型ログ転送構成

Citrix Web Studioは、サイト全体のAlways-on Tracing (AOT) ログ転送を構成するための集中管理された場所を提供します。この設定は、AOTログの送信先を定義し、構成を環境内の関連コンポーネントに自動的に伝播します。
Web Studioでログサーバーを構成すると、次のようになります。
  • サイトデータベースに構成が書き込まれます。
  • Delivery Controllerは更新された設定を取得し、選択されたデリバリーグループ内のVDAに配布します。
  • VDAは受信した構成を使用して、AOTログを指定されたログサーバーに転送します。
  • AOTログ記録に参加するStoreFrontは、同じ集中管理メカニズムを通じて必要な詳細情報を受け取ります。
  • Directorは、提供されたAuthKeyとログサーバーの詳細を使用して、監視およびトラブルシューティングのためにAOTログをクエリおよび表示します。
この集中管理アプローチにより、各コンポーネントを個別に構成する必要がなくなります。Web Studioでログサーバーの詳細を一度設定するだけで、Citrixは構成をサイト全体に自動的に伝播します。
以下は、Web Studioで設定されるとログサーバーの詳細を取得するコンポーネントのリストです。
  • シトリックス ディレクター/モニター
  • シトリックス デリバリー コントローラー
  • ウィンドウズ ブイディーエー
  • リナックス ブイディーエー
  • Mac VDA
  • StoreFront
  • セッション録画エージェント
  • CWA

オンプレミス環境のログサーバー設定を構成するには

AOTログサーバー設定
  1. Web Studioにサインインし、左側のペインで設定を選択します。
  2. 「ログサーバー」タイルで、ログサーバーが構成されていない場合は、「追加」を選択します。
  3. 「ログサーバー」ページで、「ログサーバーへのログ転送を有効にする」をオンにします。
  4. 「ログサーバーアドレス」と「ポート」を入力します。VDAとDelivery Controllerは、この情報を使用してAOTログを転送します。
    注:
    1. Citrix Connector Applianceを使用してログサーバーを展開する場合は、ポート443のみが構成されていることを確認してください。
    2. Citrix Studioでログサーバーのアドレスとポートを更新すると、最初は機能しますが、設定を再確認し、認証キーを再入力せずにログサーバーの詳細を変更すると、操作が成功したように見えても、保存後に認証キーのプレースホルダーが空になります。これにより、DirectorとMonitorで構成が欠落したり無効になったりします。回避策として、この問題が解決されるまで、ログサーバー設定を変更する際は常に認証キーを再入力して検証してください。
  5. ログを転送するコンポーネントを選択します。
    1. Delivery Controllerを含める: すべてのDelivery ControllerからAOTログを送信します。
    2. デリバリーグループを選択: 選択したデリバリーグループ内のVDAからログを送信します。
    • すべてのデリバリーグループ: すべてのVDAからログを送信します。
    • 特定のデリバリーグループを選択: 含める個々のデリバリーグループを選択します。
  6. ログサーバーで生成されたAuthKeyを入力します。Directorは、このキーを使用してログを認証および取得します。
  7. 構成を適用するには、「保存」を選択します。

既存の構成を編集するには

ログサーバーを更新するか、ログ記録スコープを変更するには、設定 > ログサーバーに移動し、編集を選択します。

DaaS設定を介してCitrix DaaS/Cloud環境のログサーバー設定を構成する

Always On Tracing (AOT) は、オンプレミス (CVAD) と Citrix DaaS (クラウド) の両方の展開でサポートされています。ただし、ログ収集の動作は、コンポーネントがホストされている場所によって異なります。
AOTログサーバー (Linux、Windows、またはコネクタアプライアンス上) をインストールして構成した後、クラウド展開用のCitrix DaaS設定でログサーバーへのログ転送を有効にするには、以下を完了します。
AOTログサーバー設定 1
DaaS 用 Citrix Web Studio (DaaS 設定) は、クラウド管理サイトの Always-on Tracing (AOT) ログ転送を構成するための一元的な場所を提供します。この構成により、AOT ログの送信先が決定され、どの VDA がログ転送に参加するかが制御されます。Monitor はこれらの設定を使用して、トラブルシューティングのためにログを取得および表示します。
  1. DaaS 用 Web Studio (DaaS 設定) にサインインし、左ペインで 設定 を選択します。
  2. ログサーバー タイルで、現在ログサーバーが構成されていない場合は、追加 を選択します。
  3. ログサーバー ページで、ログサーバーアドレス と ポート を入力します。VDA はこの情報を使用して、AOT ログをサーバーに転送します。
  4. ログを転送するVDAを定義します。
    1. スコープを制御するには、デリバリーグループの選択 を選択します。
    2. すべてのデリバリーグループ (デフォルト) は、サイト内のすべてのVDAからログを転送します。
    3. 特定のVDAをターゲットにするには、特定のデリバリーグループの選択 を選択し、含めるデリバリーグループを選択します。
    注:
    Citrix Connector Applianceを使用してログサーバーを展開する場合は、ポート443のみが構成されていることを確認してください。
  5. ログサーバーが展開されているゾーン (リソースの場所) を選択します。
  6. ログサーバーによって生成された認証キーを入力します。モニターはこのキーを使用して、ログを認証し、表示のために取得します。
  7. 構成を適用するには、 を選択します。

その他のコンポーネントのログ転送構成

Citrix Cloud展開におけるStoreFrontのAOTログアップロードの構成

Citrix Cloud (ハイブリッド) 展開で、Cloud DDC とともにオンプレミスのStoreFront (Citrix Workspaceの代わりに) が使用されている場合、StoreFrontはCloud ConnectorからAOTログサーバー構成を自動的に受信しません。StoreFrontサーバーで次のPowerShellコマンドを実行して、AOTログサーバーエンドポイントを手動で構成します。
# Enable - Run the following command in StoreFront PowerShell

Enable-CitrixAOTUpload -AoTDataStoreEndpoint https://<FQDNofLogServer>:<server_port> -Role StoreFront

# Disable - Run the following command in StoreFront PowerShell
Disable-CitrixAOTUpload
注:
このコマンドは、Cloud DDCを使用するCitrix Cloud (ハイブリッド) 展開でのみ実行してください。StoreFrontがオンプレミスのDelivery ControllerとペアになっているオンプレミスのCVAD展開では、ログサーバー構成が自動的に同期され、手動構成は不要なため、このコマンドを実行しないでください。

セッションレコーディングサーバーのAOTログアップロードの構成

セッションレコーディングサーバーマシンで次のPowerShellコマンドを実行することにより、セッションレコーディングサーバーがAOTログを中央ログサーバーにアップロードするように構成できます。
#Enable - run following command in Session Recording Server PowerShell
Enable-CitrixAOTUpload -AotDataStoreEndpoint <https://FQDNofServer>:<server port> -Role SessionRecording

#Disable - run following command in Session Recording Server PowerShell
Disable-CitrixAOTUpload

FASのAOTログアップロードの構成

FASサーバーで次のPowerShellコマンドを実行することにより、FASがAOTログを中央ログサーバーにアップロードするように構成できます。
#Enable - run following command in FAS PowerShell
Enable-CitrixAOTUpload -AotDataStoreEndpoint <https://FQDNofServer>:<server port> -Role FAS

#Disable - run following command in FAS PowerShell
Disable-CitrixAOTUpload
注:
FASインストーラーMSIファイル - FederatedAuthenticationService_x64.msi を使用してインストールまたはアップグレードした場合、常時オンのトレースは利用できません。
FASは常にCVAD MetaInstallerまたはXenDesktopFasSetup.exeまたはFasSetup_xxxx.exeからインストールしてください。

PVSのAOTログアップロードの構成

PVSサーバーで次のPowerShellコマンドを実行することにより、PVSがAOTログを中央ログサーバーにアップロードするように構成できます。
#Enable - run following command in PVS PowerShell
Enable-CitrixAOTUpload -AotDataStoreEndpoint <https://FQDNofServer>:<server port> -Role PVS

#Disable - run following command in PVS PowerShell
Disable-CitrixAOTUpload
注:
複数のPVSサーバーがある場合は、それぞれのサーバーでAOTログのアップロードを有効または無効にするコマンドを実行してください。

License Server の AOT ログのアップロード

  • Logserver URL は、場所「C:\Program Files (x86)\Citrix\Licensing\WebServicesForLicensing\SimpleLicenseServiceConfig.xml」にあるSLS 設定ファイル内で、XML タグ「AotServerURL」を使用して更新する必要があります。
例:
<AotServerURL>https://<FQDNofLogServer:443>//ctxlogserver/UploadCitrixLogStream</AotServerURL>
注:
License Server でログはいつ生成されますか？
License Server AOT ログは、License Server のインストールまたはアップグレード、WSL (Citrix Web Services for Licensing) サービスの再起動、ライセンスアクティベーションの失敗、ダークサイトアクティベーションの失敗、クロック関連のライセンス問題など、特定のイベント中にのみ生成されます。
これらのイベントのいずれも最近発生していない場合、ログがないことは必ずしも問題を示しているわけではありません。

クイックチェック

  1. 最近、対象となるイベント（再起動、アップグレード、アクティベーションの問題など）が発生したかどうかを確認します。
  2. Citrix Web Services for Licensing サービスを再起動し、アップロード処理に最大1時間かかります。
  3. AOT Log Server URL が正しく構成されていることを確認します。
  4. Citrix Web Services for Licensing サービスが実行中であることを確認します。
  5. 確認: C:\Program Files (x86)\Citrix\Licensing\LS\resource\aot ファイルにデータが含まれている場合、ログはアップロードを待機している可能性があります。
注:
License Server AOT ロギングはイベント駆動型であり、継続的ではありません。対象となるイベントが発生していない場合にログが表示されないのは正常です。
  • License Server は、定期的にログを AOT サーバーに自動的にアップロードします。

Citrix Connector の AOT ログアップロードを構成する

AOT Log Server で Cloud Connector ログを収集するには、次の要件が適用されます。
  • Cloud Connector は バージョン 6.169.0.22492 以降である必要があります。
  • Cloud DDC 展開では、ログサーバーの構成詳細は5月リリースでレジストリに自動的に同期され、手動での構成は不要です。
  • ハイブリッド展開 (オンプレミス DDC) では、ログ収集を有効にするために手動でのレジストリ構成が必要です。Cloud Connector マシンに以下のレジストリエントリを作成してください。
パス: HKLM\Software\Citrix\ConfigSyncService
エントリ：
  • LogServerEnabled (REG_DWORD) = 1
  • LogServerEndpoint (REG_SZ) = https://&lt;logserver-fqdn:<port>>

Citrix Workspace アプリの AOT ログアップロードを構成する

Citrix は、Citrix Workspace アプリクライアントが診断ログを集中ログサーバーに自動的にアップロードできるようにします。この機能により、管理者は手動でのログ収集を必要とせずに、クライアント側の診断情報に即座にアクセスできるため、トラブルシューティングの効率が向上します。クライアント側の AOT は自動的にアップロードされ、AOT 機能が CVAD 環境全体で有効になっている場合、およびユーザーがリソースを起動したときにトリガーされます。

システム要件

  • Citrix Virtual Apps and Desktops 2511 または CVAD 2507 CU1 以降のバージョン
  • Citrix Workspace アプリ 2511 または CWA 2507.1 CU1 以降のバージョン
  • 選択した Citrix Workspace アプリ (CWA) の必要なバージョンがインストールされていることを確認してください。詳細については、サポートされているバージョンを参照してください。

前提条件

Citrix Workspace アプリの Web 起動
Citrix Workspace アプリの Web 起動 (WebHelper、直接 ICA ファイルダウンロード、Web ブラウザ拡張機能起動方法を含む) の場合、StoreFront は最新のユーザーインターフェイス (UI エクスペリエンス) を使用するように構成する必要があります。 最新の UI エクスペリエンスを有効にする手順については、StoreFront ドキュメントを参照してください。
注:
この前提条件は Web ベースの起動にのみ適用され、ネイティブの Citrix Workspace アプリの起動には必要ありません。

NetScaler の AOT ログアップロードを構成する

  • NetScaler CLI に SSH で接続し、「shell」コマンドを実行して NetScaler シェルに入ります。
  • /var/analytics_conf ディレクトリに移動します
    cd /var/analytics_conf
  • インタラクティブなPythonスクリプト「python {auditlog_schema_generator_for_hec_export.py}」を実行して、スキーマファイルを生成します。スキーマファイルは、HTTPヘッダー（Auth-token、User-Agentなど）とペイロード属性（Role、Machine IPなど）を定義します。

このスクリプトによって生成された出力のスニペット

root@Raju-adc2# python auditlog_schema_generator_for_hec_export.py
Schema Builder: Follow the prompts to define your schema.
Include 'Auth-Token'? (Y/n):  
Enter the display name (alias) for 'Auth-Token' (press Enter to keep as is): Authkey
'Auth-Token' can only go in 'header'. Automatically selected.
Include 'HostName'? (Y/n): n
Include 'Content-type'? (Y/n): y
Enter the display name (alias) for 'Content-type' (press Enter to keep as is):
'Content-type' can only go in 'header'. Automatically selected.
Default value for 'Content-type' is 'application/json'.  
Do you want to change it? (y/N):  
Include 'User-agent'? (Y/n):  
Enter the display name (alias) for 'User-agent' (press Enter to keep as is):
'User-agent' can only go in 'header'. Automatically selected.
Default value for 'User-agent' is 'AUDITLOGS/1.0'.  
Do you want to change it? (y/N):  
Include 'Role'? (Y/n): y  
Enter the display name (alias) for 'Role' (press Enter to keep as is):  
Where should 'Role' be included? (HEADER/payload): HEADER  
Default value for 'Role' is 'GW'.  
Do you want to change it? (y/N): y  
Enter new default value for 'Role': Gateway  

生成されたスキーマファイルのサンプル

{
     "Header": {
         "Auth-Token": {
             "name": "AuthKey"
         },
         "Content-type": {
             "name": "Content-type",
             "value": "application/json"
         },
         "User-agent": {
             "name": "User-agent",
             "value": "AUDITLOGS/1.0"
         },
         "Role": {
             "name": "Role",
             "value": "Gateway"
         },
         "MachineIP": {
             "name": "MachineIP"
         },
         "MachineName": {
             "name": "MachineName"
         }
     },
     "Payload": {
         "LogLevel": "Level",
         "MessageContent": "Message",
         "ModuleName": "Module",
         "Time": "TimeStamp"
     },
     "Format": {
         "delimiter": ""
     }
 }
  • シェルを終了し、NetScaler CLIに戻ります
  • Syslogサーバー、ポート、およびスキーマファイル（前の手順で作成したもの）などを定義するsyslogアクションを作成します
add audit syslogAction {Action Name} {AOT Server IP/FQDN} -serverPort {Destination Port} -logLevel {Log Level} -transport HTTP -httpAuthToken {Authentication Token generated on the AOT sever} -httpEndpointUrl {AOT Server URL where logs will be sent} -httpSchemaFile {Schema File created in Previous Step}
例:
add audit syslogAction act1 10.102.154.196 -serverPort 8088 -logLevel ALL -transport HTTP -httpAuthToken fbb94d5b234d86a6cb155e3f808dd33c9698a0d1a866e814573b1909e4c9e56896f433da1071e3276bd133269fd69203d8f29166816f4d427e709773ceb9d41d531043331f7f76 -httpEndpointUrl "/services/collector/event" -httpSchemaFile sample.json
  • syslogActionを監査Syslogポリシーにバインドします
add audit syslogPolicy {PolicyName} True {Name of the Syslog Action}
例:
add audit syslogPolicy pol1 true act1