トレースログの有効化、設定、無効化:KAVSHELL TRACE

2023年2月20日

ID 146718

KAVSHELL TRACE コマンドを使用すると、Kaspersky Embedded Systems Security のすべてのサブシステムのトレースログの有効化と無効化、およびログの詳細レベルの設定を行うことができます。

Kaspersky Embedded Systems Security では、暗号化されていない形式でトレースファイルとダンプファイルに情報を書き込みます。

KAVSHELL TRACE コマンドの構文

KAVSHELL TRACE </ON /F:<トレースログファイル フォルダーへのパス> [/S:<メガバイト単位の最大ログサイズ>] [/LVL:debug|info|warning|error|critical] [/r:<最大ログファイル数ローテーション用トレースファイル>] | /オフ>

トレースログが有効化されている場合に設定を変更するには、/ON オプションを使用して KAVSHELL TRACE コマンドを入力し、/S パラメータと /LVL パラメータを使用してトレースログの設定を指定します(次の表を参照)。

KAVSHELL TRACE コマンドのキー

ライセンス

説明

/ON

トレースログの有効化。

/F:<トレースログファイルを保存するフォルダー>

このパラメータで、トレースログファイルを保存するフォルダーの絶対パスを指定します(必須)。

存在しないフォルダーのパスを指定すると、トレースログは作成されません。他の保護対象デバイスのネットワークドライブ上のフォルダーへのパスは指定できません。

パラメータによって指定されたパスに空白文字が含まれる場合は、引用符で囲む必要があります(例:/F:"C:\Trace Folder")。

トレースログファイルのパスを指定する時にシステム環境変数を使用できます。ユーザー環境変数は使用できません。

/S: <メガバイト単位でのログファイルの最大サイズ>

このキーで、単一のトレースログファイルの最大サイズを設定します。ログファイルが最大サイズに達するとすぐに、Kaspersky Embedded Systems Security によって情報は新しいファイルに記録され、前のログファイルは保存されます。

このパラメータの値を指定しない場合、1 つのログファイルの最大サイズは 50 MB です。

/LVL:debug|info|warning|error|critical

このパラメータで、すべてのイベントがログに記録される最大(すべてのデバッグ情報)から緊急イベントのみ記録される最小(緊急イベント)まで、ログの詳細レベルを設定します。

このパラメータを指定しない場合、詳細レベル「すべてのデバッグ情報」に含まれるすべてのイベントがトレースログに記録されます。

/r:<ローテーション用のトレースファイルの最大数>

このパラメータは、トレースファイルのローテーションを有効にします。トレースファイルのローテーションが有効で、<ローテーションのトレースファイルの最大数> に達した場合、新しいファイルが作成される前に、最も古いファイルが削除されます。

使用可能な値:1 ~ 999。値が指定されていない場合、トレースファイルのローテーションは有効にならず、アプリケーションはエラーを返します。

/OFF

このオプションで、トレースログを無効にします。

KAVSHELL TRACE コマンドの例

詳細レベル「すべてのデバッグ情報」を使用してログの最大サイズ 200 MB でトレースログを有効にし、ログファイルを「C:\Trace Folder」フォルダーに保存するには、次のコマンドを実行します:

KAVSHELL TRACE /ON /F:"C:\Trace Folder" /S:200

詳細レベル「注意が必要なイベント」を使用してトレースログを有効にし、ログファイルを「C:\Trace Folder」フォルダーに保存するには、次のコマンドを実行します:

KAVSHELL TRACE /ON /F:"C:\Trace Folder" /LVL:warning

注意が必要なイベントの詳細レベルを使用してトレースログを有効にし、ログファイルを「C:\Trace Folder」フォルダーに保存し、トレースファイルの最大数が 50 に達した後にトレースファイルのローテーションを有効にするには、次のコマンドを実行します:

KAVSHELL TRACE /ON /F:"C:\Trace Folder" /LVL:warning /r:50

トレースログを無効にするには、次のコマンドを実行します:

KAVSHELL TRACE /OFF

KAVSHELL TRACE コマンドのリターンコード

この記事はお役に立ちましたか?
改善できる点がありましたらお聞かせください。
フィードバックをいただき、ありがとうございました。改善に向けて取り組んでまいります。
フィードバックをいただき、ありがとうございました。改善に向けて取り組んでまいります。