ログ収集
ロギングメカニズムの概要
次の表は、Linux VDA のロギングメカニズムの概要を示しています。
| ロギングモジュール | ログファイル名の形式 | ログファイル名の例 | ロギングスコープ | 最大単一ファイルサイズ | ローテーションしきい値（デフォルト） | 構成 |
|---|---|---|---|---|---|---|
| HDX | hdx.log[.n] | hdx.log、hdx.log.1 | グラフィック、ログイン、オーディオ、キーボード、マウス | 200 MiB | 1つが現在、2つが古い | setlogユーティリティを介して構成可能 |
| Jプロキシ | jproxy.log[.n.log] | jproxy.log, jproxy.log.1.log | VDA登録、ユーザー認証 | 20 MiB | 現在のファイル1つ、古いファイル10個 | setlogユーティリティまたは/etc/xdl/log4j2.xmlを介して設定可能 |
| VDA | vda.YYYY-MM-DD.hh.mm.ss.log | vda.2024-05-06.20.18.40.log | VDA登録 | 50 MiB | 現在のファイル1つ、古いファイル1つ | setlogユーティリティまたは/etc/xdl/brokeragent.confを介して設定可能 |
注:
-
最初のログファイルには名前に番号がなく、後続のファイルには「.n」という番号が付けられます。ここで「n」はファイル番号を表します。たとえば、「hdx.log」は最初のHDXログファイルであり、「hdx.log.1」は2番目のファイルです。
-
単一のログファイルの最大サイズはメビバイト (MiB) で測定されます。
-
生成中で、まだ単一ファイルの最大サイズに達していないログファイルは、「現在の」ログファイルと呼ばれます。「現在の」ログファイルが単一ファイルの最大サイズに達すると、ロールオーバーされて「古い」ログファイルになります。
-
ローテーションしきい値は、保持できる「古い」ログファイルの数を制限するように設定可能です。制限に達すると、最も古いログファイルが削除されます。
ロギング構成
このセクションでは、上記の表に示されている詳細を補完する、ロギング構成に関する追加情報を提供します。
Linux VDA のロギングはデフォルトで有効
ctxlogd デーモンと setlog ユーティリティは、Linux VDA リリースパッケージに含まれています。デフォルトでは、Linux VDA をインストールして構成すると、ctxlogd デーモンが起動します。トレースされる他のすべてのサービスは、ctxlogd デーモンに依存します。Linux VDA のトレースを継続したくない場合は、ctxlogd デーモンを停止できます。
/etc/xdl/brokeragent.conf を介した VDA ロギングの構成
注:
単一ログファイルの最大サイズなどの他のロギングパラメータを深く掘り下げずに、VDA ロギングのログレベルのみを構成したい場合は、この記事の後半で説明する setlog ユーティリティを使用できます。それ以外の場合は、/etc/xdl/brokeragent.conf を使用してください。
VDA 上の /etc/xdl/brokeragent.conf ファイルは、VDA ロギングの構成に使用できます。例：
/etc/xdl/brokeragent.conf ファイル(/en-us/linux-virtual-delivery-agent/current-release/media/brokeragent-conf.png)
/etc/xdl/log4j2.xml を介した Jproxy ロギングの構成
注:
単一ログファイルの最大サイズなどの他のロギングパラメータを深く掘り下げずに、Jproxy ロギングのログレベルのみを構成したい場合は、この記事の後半で説明する setlog ユーティリティを使用できます。それ以外の場合は、/etc/xdl/log4j2.xml を使用してください。
以下は、/etc/xdl/log4j2.xml を介して Jproxy ロギングを構成する例です。そのうち、SizeBasedTriggeringPolicy パラメータは単一の Jproxy ログファイルの最大サイズを指定し、DefaultRollerStrategy パラメータは保持できる Jproxy ログファイルの総数を設定します。
Jproxy ロギングの構成(/en-us/linux-virtual-delivery-agent/current-release/media/log4j2-xml.png)
setlog ユーティリティを介した HDX™ ロギングの構成
setlog ユーティリティは /opt/Citrix/VDA/bin/ パスにあります。ルートユーザーのみが実行する権限を持っています。GUI を使用するか、コマンドを実行して、値（ログファイルのパス、単一ファイルのサイズ制限、ローテーションしきい値）やログレベルを含む構成オプションを表示および変更できます。setlog ユーティリティのヘルプについては、次のコマンドを実行してください。
setlog help
値
既定では、HDXログは/var/log/xdl/hdx.logに保存されます。単一のHDXログファイルのサイズ制限は200 MiBで、最大2つの「古い」HDXログファイルを**/var/log/xdl/hdx.log**に保存できます。
現在のすべてのsetlog値を表示するには、次のコマンドを実行します。
setlog values
log_path (Log Output Path) = /var/log/xdl/hdx.log
log_size (Max Log Size (MiB)) = 200
log_count (Max Old Log Files) = 2
単一のsetlog値を表示または設定するには、次のコマンドを実行します。
setlog value <name> [<value>]
例:
setlog value log_size 100
レベル
既定では、ログレベルはinfo (大文字と小文字を区別しません) に設定されています。
トラブルシューティングが必要な問題が発生した場合は、ほとんどのシナリオでログレベルをverboseに設定することをお勧めします。その後、問題を再現し、ログを収集してください。
ログレベル (Disabled、Inherited、Trace、Verbose、Information、Warnings、Errors、Fatal Errorsを含む) を設定するには、次のコマンドを実行します。
setlog level <class> [<level>]
| ログレベル | コマンドパラメーター (大文字と小文字を区別しません) |
|---|---|
| 無効 | なし |
| 継承 | 継承 |
| トレース | トレース |
| 詳細 | 詳細 |
| 情報 | 情報 |
| 警告 | 警告 |
| エラー | エラー |
| 致命的なエラー | 致命的 |
<class> 変数は、Linux VDA のコンポーネントを指定します。すべてのコンポーネントを対象とするには、それを all に設定します。例:
setlog level all error
サポートされているすべてのクラスまたはコンポーネントを表示するには、次のコマンドを実行します。
setlog levels
デフォルトに戻す
すべてのレベルと値をデフォルト設定に戻します。
setlog default
重要:
ctxlogd サービスは、root ユーザーのみが作成できる /var/xdl/.ctxlog ファイルを使用して構成されます。他のユーザーはこのファイルへの書き込み権限を持っていません。root ユーザーは他のユーザーに書き込み権限を与えないことをお勧めします。これに従わない場合、ctxlogd に任意のまたは悪意のある構成が適用され、サーバーのパフォーマンス、ひいてはユーザーエクスペリエンスに影響を与える可能性があります。
ログ収集
ログを収集するには、bash /opt/Citrix/VDA/bin/xdlcollect.sh コマンドを実行します。ログの収集に使用される xdlcollect Bash スクリプトは、Linux VDA ソフトウェアに統合されており、/opt/Citrix/VDA/bin にあります。
ログ収集が完了すると、VDA 上の /tmp/xdlcollect に ZIP ファイルが生成されます。
AOT ログの収集とアップロード
概要
この機能は、Virtual Delivery Agent (VDA) 上のコンポーネントから Always-On Tracing (AOT) ログを収集します。これは以下をサポートします。
-
再現が困難な問題のトラブルシューティング
-
日常的なヘルスチェック
-
集中ログ管理
ログは構造化されたイベントに変換され、クエリと分析のために一元化されたログサーバーにアップロードされます。
構成
グループポリシーの構成
この機能をグループポリシー経由で有効にするには、ログサーバーが**Delivery Controller (DDC)**で適切に構成されていることを確認してください。手順は次のとおりです。
AOTログサーバー(/en-us/linux-virtual-delivery-agent/current-release/media/aot-log-server.png)
-
ログサーバーへのログ転送を有効にするには、ログサーバーのアドレスとポートを設定します。
AOTログ構成(/en-us/linux-virtual-delivery-agent/current-release/media/aot-log-config.png)
ローカルレジストリ構成
ローカルレジストリはポリシーよりも優先されます。ローカルレジストリ経由でこの機能を有効にするには、VDAで次のコマンドを実行します（
<ip> と <port> をご自身のものに置き換えてください）。
AOTデータ収集を有効にする:
ログサーバーのエンドポイントを設定する:
sudo /opt/Citrix/VDA/bin/ctxreg create \
-k "HKLM\System\CurrentControlSet\Control\Citrix\AOT" \
-t "REG_DWORD" \
-v "EnableAotDataCollection" \
-d "0x00000001" --force
sudo /opt/Citrix/VDA/bin/ctxreg create \
-k "HKLM\System\CurrentControlSet\Control\Citrix\AOT" \
-t "REG_SZ" \
-v "AotDataStoreEndpoint" \
-d "<http/https>://<fqdn-or-ip-address>:<port>" --force
Studioからプッシュされたポリシー設定が変更された場合、またはローカルレジストリ設定が変更された場合、ctxvectorサービスは1分以内に自動的に変更を適用します。手動で再起動する必要はありません。
TLS認証
この機能は、ログサーバーへのHTTPおよびHTTPS接続をサポートしています。HTTPSの場合、ルートCA証明書をLinuxシステムキーストアにインストールします。VDAは、ログサーバー証明書を認証した後にのみHTTPS接続を正常に確立できます。ログサーバーはVDAを認証しません。
トラブルシューティング
/var/xdl/.ctxlogファイルが見つからない場合（例えば、誤って削除された場合）、ctxlogdデーモンが失敗し、ctxlogdサービスを再起動できません。
/var/log/messages:
Apr 1 02:28:21 RH72 citrix-ctxlogd[17881]: Failed to open logging configuration file.
Apr 1 02:28:21 RH72 systemd: ctxlogd.service: main process exited, code=exited, status=1/FAILURE
Apr 1 02:28:21 RH72 systemd: Unit ctxlogd.service entered failed state.
Apr 1 02:28:21 RH72 systemd: ctxlogd.service failed.
この問題を解決するには、rootユーザーとしてsetlogを実行して**/var/xdl/.ctxlogファイルを再作成します。その後、他のサービスが依存しているctxlogd**サービスを再起動します。