Linux Virtual Delivery Agent

トレースオン

概要

ログの収集および問題の再現によって、診断速度やユーザーエクスペリエンスが低下します。トレースオン機能は、こうした事態に対応します。トレースは、Linux VDAでデフォルトで有効になっています。

構成

Linux VDAパッケージに、ctxlogdデーモンおよびsetlogユーティリティが追加されました。ctxlogdデーモンは、Linux VDAをインストールして構成すると、デフォルトで開始されます。

ctxlogdデーモン

トレースされた他のサービスはすべてctxlogdデーモンに依存しています。Linux VDAをトレースしない場合は、ctxlogdデーモンを停止できます。

setlogユーティリティ

トレースオン機能は、setlogユーティリティ(パス:/opt/Citrix/VDA/bin/)で構成されます。このユーティリティを実行する権限があるのは、ルートユーザーのみです。GUIを使用するかコマンドを実行して、構成を表示したり変更したりできます。setlogユーティリティのヘルプを表示するには、次のコマンドを実行します:

setlog help
<!--NeedCopy-->

デフォルトでは、[ログ出力パス]/var/log/xdl/hdx.log[最大ログサイズ] は200MBに設定されています。[ログ出力パス] には、最大2つの古いログファイルを保存できます。

現在の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
<!--NeedCopy-->

単一のsetlog値を表示または設定します:

setlog value <name> [<value>]
<!--NeedCopy-->

例:

setlog value log_size 100
<!--NeedCopy-->

レベル

デフォルトでは、ログレベルはwarning(大文字と小文字を区別しない)に設定されています。

さまざまなコンポーネントに設定されたログレベルを表示するには、次のコマンドを実行します:

setlog levels
<!--NeedCopy-->

ログレベル(Disabled、Inherited、Verbose、Information、Warnings、Errors、Fatal Errors)を設定するには、次のコマンドを実行します:

setlog level <class> [<level>]
<!--NeedCopy-->
ログレベル コマンドパラメーター(大文字と小文字を区別しない)
Disabled none
Inherited inherit
Verbose verbose
Information info
Warnings warning
Errors error
Fatal Errors fatal

<class>変数は、Linux VDAの1つのコンポーネントを指定します。すべてのコンポーネントをカバーするには、allに設定します。例:

setlog level all error
<!--NeedCopy-->

フラグ

デフォルトでは、フラグは次のように設定されています:

setlog flags

DATE = true

TIME = true

NAME = true

PID = true

TID = false

SID = true

UID = false

GID = false

CLASS = false

LEVEL = false

FUNC = true

FILE = false
<!--NeedCopy-->

現在のフラグを表示します:

setlog flags
<!--NeedCopy-->

1つのログフラグを表示または設定します:

setlog flag <flag> [<state>]
<!--NeedCopy-->

デフォルトに戻す

すべてのレベル、フラグ、値をデフォルト設定に戻します:

setlog default
<!--NeedCopy-->

重要:

ctxlogdサービスは/var/xdl/.ctxlogファイルを使用して構成されます。このファイルは、ルートユーザーのみが作成できます。他のユーザーは、このファイルへの書き込み権限がありません。ルートユーザーが他のユーザーに書き込み権限を許可しないことをCitrixではお勧めします。許可すると、ctxlogdが恣意的に、または悪意をもって構成される危険性があります。これによってサーバーのパフォーマンスが影響を受け、ユーザーエクスペリエンスにも影響を与える可能性があります。

トラブルシューティング

/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.
<!--NeedCopy-->

この問題を解決するには、ルートユーザーとしてsetlogを実行して、/var/xdl/.ctxlogファイルを再度作成します。次に、他のサービスが依存するctxlogdサービスを再起動します。

トレースオン