ログ収集

最終公開日 : Nov 13, 2026
Related information
管理

ロギングメカニズムの概要

次の表は、Linux VDA のロギングメカニズムの概要を示しています。
ロギングモジュール ログファイル名の形式 ログファイル名の例 ロギングスコープ 最大単一ファイルサイズ ローテーションしきい値（デフォルト） 構成
HDX hdx.log[.n] hdx.log、hdx.log.1 グラフィック、ログイン、オーディオ、キーボード、マウス 200 MiB 1つが現在、2つが古いもの setlogユーティリティを介して構成可能
ジェイプロキシ 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/log4j2.xml を介したJproxyロギングの構成

注:
単一ログファイルの最大サイズなどの他のロギングパラメータを深く掘り下げずに、Jproxyロギングのログレベルのみを構成したい場合は、この記事の後半で説明するsetlogユーティリティを使用できます。それ以外の場合は、/etc/xdl/log4j2.xml を使用してください。
以下は、/etc/xdl/log4j2.xml を介してJproxyロギングを構成する例です。この例では、SizeBasedTriggeringPolicy パラメータが単一のJproxyログファイルの最大サイズを指定し、DefaultRollerStrategy パラメータが保持できるJproxyログファイルの総数を設定します。
Jproxyロギングの構成

setlogユーティリティを介したHDX™ロギングの構成

setlogユーティリティは、/opt/Citrix/VDA/bin/ パスにあります。rootユーザーのみが実行する権限を持っています。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サービスは、/var/xdl/.ctxlogファイルを使用して構成されます。このファイルはrootユーザーのみが作成できます。他のユーザーはこのファイルへの書き込み権限を持っていません。rootユーザーは他のユーザーに書き込み権限を与えないことをお勧めします。これに従わない場合、ctxlogdに任意のまたは悪意のある構成が適用される可能性があり、これにより、サーバーのパフォーマンス、ひいてはユーザーエクスペリエンスに影響を与える可能性があります。

ログ収集

ログを収集するには、bash /opt/Citrix/VDA/bin/xdlcollect.shコマンドを実行します。ログの収集に使用されるxdlcollect Bashスクリプトは、Linux VDAソフトウェアに統合されており、/opt/Citrix/VDA/binにあります。
ログ収集が完了すると、VDA上の**/tmp/xdlcollect**にZIPファイルが生成されます。

トラブルシューティング

/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**サービスを再起動します。