製品ドキュメント
Citrix Virtual Apps and Desktops
Current Release Service 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR

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

May 31, 2026
寄稿者: 
C

CVAD 2507 CU1およびCVAD 2511以降、AOTログはすべての該当するコンポーネントから収集されます。サポートされているコンポーネントには、DDC、ストアフロント、シトリックス ディレクター、Windows VDA、Linux VDA、Mac VDA、ライセンスサーバー、FAS、クラウドコネクタ、PVS、WEM、セッションレコーディング、シトリックス ワークスペース UI、およびシトリックス ゲートウェイが含まれます。

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で設定されたログサーバーの詳細を受け取るコンポーネントのリストです。

  • シトリックス ディレクター/モニター
  • シトリックス デリバリーコントローラー
  • ウィンドウズ VDA
  • リナックス ブイディーエー
  • マック ブイディーエー
  • ストアフロント
  • セッションレコーディングエージェント
  • シーダブリューエーエス

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

AOTログサーバー設定(/ja-jp/citrix-virtual-apps-desktops/2511/media/aot-log-server-settings.png)

  1. Web Studioにサインインし、左ペインで設定を選択します。
  2. ログサーバーが構成されていない場合は、ログサーバータイルで追加を選択します。
  3. ログサーバーページで、ログサーバーへのログ転送を有効にするをオンにします。

  4. ログサーバーアドレスとポートを入力します。VDAとDelivery Controllerは、この情報を使用してAOTログを転送します。

    注:

    1. Citrix Connector Applianceを使用してLog Serverを展開している場合は、ポート443のみが構成されていることを確認してください。

    2. Citrix Studioでログサーバーのアドレスとポートを更新すると、最初は機能しますが、設定を再確認し、認証キーを再入力せずにログサーバーの詳細を変更すると、操作が成功したように見えても、保存後に認証キーのプレースホルダーが空になります。その結果、DirectorとMonitorで構成が欠落したり無効になったりします。回避策として、この問題が解決されるまで、ログサーバー設定を変更するたびに認証キーを再入力して検証してください。

  5. どのコンポーネントがログを転送するかを選択します:

    1. デリバリーコントローラーを含める: すべてのデリバリーコントローラーからAOTログを送信します。

    2. デリバリーグループを選択: 選択したデリバリーグループ内のVDAからログを送信します。

      • すべてのデリバリーグループ: すべてのVDAからログを送信します。
      • 特定のデリバリーグループを選択: 含める個々のデリバリーグループを選択します。
  6. ログサーバーで生成されたAuthKeyを入力します。dDirectorはこのキーを使用して認証し、ログを取得します。
  7. 構成を適用するには、保存を選択します。

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

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

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

Always On Tracing (AOT) は、オンプレミス (CVAD) とCitrix DaaS (クラウド) の両方の展開でサポートされています。ただし、ログ収集の動作は、コンポーネントがホストされている場所によって異なります。

AOTログサーバー (Linux、Windows、またはConnector Appliance上) をインストールして構成した後、クラウド展開の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. ログサーバーによって生成された認証キーを入力します。Monitor はこのキーを使用して、表示用のログを認証および取得します。
  7. 構成を適用するには、「保存」を選択します。

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

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

セッションレコーディングサーバーマシンで次の PowerShell コマンドを実行することにより、セッションレコーディングサーバーが AOT ログを中央ログサーバーにアップロードするように構成できます。

#Enable - run following command in Session Recording Server PowerShell
Enable-CitrixAOTUpload -AotDataStoreEndpoint <server address>:<server port> -Role SessionRecording

#Disable - run following command in Session Recording Server PowerShell
Disable-CitrixAOTUpload
<!--NeedCopy-->

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

FAS サーバーで次の PowerShell コマンドを実行することにより、FAS が AOT ログを中央ログサーバーにアップロードするように構成できます。

#Enable - run following command in FAS PowerShell
Enable-CitrixAOTUpload -AotDataStoreEndpoint <server address>:<server port> -Role FAS

#Disable - run following command in FAS PowerShell
Disable-CitrixAOTUpload
<!--NeedCopy-->

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

PVS サーバーで次の PowerShell コマンドを実行すると、PVS が AOT ログを中央ログサーバーにアップロードするように構成できます。

#Enable - run following command in PVS PowerShell
Enable-CitrixAOTUpload -AotDataStoreEndpoint <server address>:<server port> -Role PVS

#Disable - run following command in PVS PowerShell
Disable-CitrixAOTUpload
<!--NeedCopy-->

注:

複数の PVS サーバーがある場合は、各サーバーで AOT ログのアップロードを有効または無効にするコマンドを実行してください。

ライセンスサーバーの AOT ログをアップロードする

  • The Logserver URL needs to be updated inside SLS config file, which can be find at the location “C:\Program Files (x86)\Citrix\Licensing\WebServicesForLicensing\SimpleLicenseServiceConfig.xml” with XML tag “AotServerURL”

例:

<AotServerURL>https://10.110.249.168:8443/ctxlogserver/UploadCitrixLogStream</AotServerURL>
<!--NeedCopy-->
  • ライセンスサーバーは、定期的にログを AOT サーバーに自動的にアップロードします。

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

AOT ログサーバーで Cloud Connector ログを収集するには、次の要件が適用されます。

  • Cloud Connector は バージョン 6.157.0.19398 以降である必要があります。

  • Cloud DDC 展開では、ログサーバーの構成詳細は、5月リリース (DDC 128) でレジストリに自動的に同期されるため、手動での構成は不要です。

  • ハイブリッド展開 (オンプレミス DDC) では、ログ収集を有効にするために手動でのレジストリ構成が必要です。Cloud Connector マシンに次のレジストリエントリを作成します。

パス: HKLM\Software\Citrix\ConfigSyncService

エントリ:

  • LogServerEnabled (REG_DWORD) = 1

  • LogServerEndpoint (REG_SZ) = <https://<logserver-fqdn>:<port>>

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

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

システム要件

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

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

  • NetScaler CLIにSSH接続し、「shell」コマンドを実行してNetScalerシェルに入ります。

  • /var/analytics_confディレクトリに移動します

    cd /var/analytics_conf
<!--NeedCopy-->
  • 対話型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
<!--NeedCopy-->

生成されたスキーマファイルの例 

{
     "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": ""
     }
 }
<!--NeedCopy-->
  • シェルを終了し、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}
<!--NeedCopy-->

例：

add audit syslogAction act1 10.102.154.196 -serverPort 8088 -logLevel ALL -transport HTTP -httpAuthToken fbb94d5b234d86a6cb155e3f808dd33c9698a0d1a866e814573b1909e4c9e56896f433da1071e3276bd133269fd69203d8f29166816f4d427e709773ceb9d41d531043331f7f76 -httpEndpointUrl "/services/collector/event" -httpSchemaFile sample.json
<!--NeedCopy-->
  • syslogアクションを監査Syslogポリシーにバインドします。
add audit syslogPolicy {PolicyName} True {Name of the Syslog Action}
<!--NeedCopy-->

例：

add audit syslogPolicy pol1 true act1
<!--NeedCopy-->
CVADコアコンポーネントからのAOTログのアップロード
May 31, 2026
寄稿者: 
C
May 31, 2026
寄稿者: 
C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.