トレースオン
概要
ログの収集および問題の再現によって、診断速度やユーザーエクスペリエンスが低下します。トレースオン機能は、こうした事態に対応します。トレースは、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-->
ログレベル | コマンドパラメーター(大文字と小文字を区別しない) |
---|---|
無効 | none |
Inherited | inherit |
Verbose | verbose |
情報 | 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ファイルを使用して構成されます。このファイルは、ルートユーザーのみが作成できます。他のユーザーは、このファイルへの書き込み権限がありません。ルートユーザーは、他のユーザーに書き込み権限を許可しないことをお勧めします。許可すると、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
サービスを再起動します。