ログ収集
概要
ログの収集と問題の再現は、診断を遅らせ、ユーザーエクスペリエンスを低下させます。トレースオン機能は、このような作業を軽減します。Linux VDAでは、トレースはデフォルトで有効になっています。
構成
ctxlogdデーモンとsetlogユーティリティは、Linux VDAリリースパッケージに含まれるようになりました。デフォルトでは、Linux VDAをインストールして構成すると、ctxlogdデーモンが起動します。
ctxlogdデーモン
トレースされる他のすべてのサービスは、
ctxlogdデーモンに依存します。Linux VDAのトレースを継続したくない場合は、ctxlogdデーモンを停止できます。
setlogユーティリティ
トレースオンは、/opt/Citrix/VDA/bin/ パスにある
setlogユーティリティを使用して構成されます。rootユーザーのみが実行する権限を持っています。GUIを使用するか、コマンドを実行して構成を表示および変更できます。setlogユーティリティに関するヘルプについては、次のコマンドを実行してください。
setlog help
値
デフォルトでは、ログ出力パスは**/var/log/xdl/hdx.log**に設定され、最大ログサイズは200 MBに設定されており、ログ出力パスの下に最大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
単一の
setlog値を表示または設定します。
setlog value <name> [<value>]
例:
setlog value log_size 100
レベル
デフォルトでは、ログレベルはwarning（大文字と小文字を区別しない）に設定されています。
異なるコンポーネントに設定されているログレベルを表示するには、次のコマンドを実行します。
setlog levels
ログレベル（Disabled、Inherited、Verbose、Information、Warnings、Errors、Fatal Errorsを含む）を設定するには、次のコマンドを実行します。
setlog level <class> [<level>]
| ログレベル | コマンドパラメーター（大文字と小文字を区別しない） |
|---|---|
| 無効 | なし |
| 継承済み | 継承 |
| 詳細 | 詳細 |
| 情報 | 情報 |
| 警告 | 警告 |
| エラー | エラー |
| 致命的なエラー | 致命的 |
<class> 変数は、Linux VDA の 1 つのコンポーネントを指定します。すべてのコンポーネントを対象とするには、これを all に設定します。例:
setlog level all error
フラグ
デフォルトでは、フラグは次のように設定されています。
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
現在のフラグを表示します。
setlog flags
単一のログフラグを表示または設定します。
setlog flag <flag> [<state>]
デフォルトに戻す
すべてのレベル、フラグ、および値をデフォルト設定に戻します。
setlog default
重要:
ctxlogd サービスは /var/xdl/.ctxlog ファイルを使用して構成されます。このファイルはrootユーザーのみが作成できます。他のユーザーはこのファイルへの書き込み権限を持っていません。rootユーザーは他のユーザーに書き込み権限を与えないことをお勧めします。これに従わない場合、任意のまたは悪意のある構成がctxlogdされ、サーバーのパフォーマンス、ひいてはユーザーエクスペリエンスに影響を与える可能性があります。
ログ収集
ログを収集するには、
bash /opt/Citrix/VDA/bin/xdlcollect.sh コマンドを実行します。ログの収集に使用されるxdlcollect Bashスクリプトは、Linux VDAソフトウェアに統合されており、/opt/Citrix/VDA/bin にあります。
ログ収集が完了すると、スクリプトと同じフォルダーに圧縮ログファイルが生成されます。
xdlcollect Bashスクリプトは、圧縮ログファイルをCitrix Insight Services (CIS) にアップロードするかどうかを尋ねることができます。同意すると、アップロード完了後にxdlcollectがupload\_IDを返します。アップロードしても、圧縮ログファイルはローカルマシンから削除されません。他のユーザーはupload\_IDを使用してCIS内のログファイルにアクセスできます。
トラブルシューティング
/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サービスを再起動します。