8.3.2 拡張コマンドが出力するログファイルについて

拡張コマンドを実行すると，拡張コマンド用ログファイルに拡張コマンドの実行履歴および障害発生時のエラーステータスが記録されます。拡張コマンドのログ情報は，次の場合に出力されます。

拡張コマンドの処理開始時
拡張コマンドの処理終了時
拡張コマンド内でApplication Agentのコマンド（drmxxx）以外のコマンドを実行した場合
拡張コマンド内でApplication Agentのコマンド（drmxxx）以外のコマンドが正常終了した場合
拡張コマンド内でのコマンド（Application Agentのコマンドを含む）を実行し，エラーとなった場合

ログファイル出力ディレクトリーには，2世代までのログファイルが格納されます。ログファイルのパスは次のとおりです。

最新のログファイルのパス: <Application Agentのインストール先>\DRM\script\log\drm_script.log

1世代前のログファイルのパス: <Application Agentのインストール先>\DRM\script\log\drm_script.log.old

拡張コマンド用のログファイル「drm_script.log」に，拡張コマンドでエラーが発生したことを示すメッセージが出力された場合の対処方法は，「8.2 拡張コマンドのトラブルシューティング」を参照してください。

ログファイルに記載される情報がホスト環境設定ファイルの「MAX_LOG_LINES」に設定された最大行数を超えると，そのログファイルを1世代前のログファイルとして退避します。その後，新しくログファイルを作成してログの記録を続行します。拡張コマンドの実行時にログファイルへの情報記録に失敗した場合，拡張コマンドのログ情報は，標準出力ログファイル「drm_output.log」に出力されます。

なお，拡張コマンドの中で実行されたApplication Agentのコマンドのログ情報は，Application Agentのコマンドの標準出力ログファイル「drm_output.log」およびトレースログファイル「drm_pp_trace[1-16].log」に出力されます。

ログファイルの出力項目を次の表に示します。

表8-5 ログファイルの出力項目

項目名	内容
タイムスタンプ	ログ出力日時が1ミリ秒単位まで出力されます。出力形式：`YYYY/MM/DD hh:mm:ss.sss`
ログ種別	ログの種別を示す次の文字列が出力されます。 `START`：拡張コマンド開始 `END`：拡張コマンド終了 `INFO`：情報 `WARNING`：警告 `ERROR`：エラー `DEBUG`：デバッグ
オペレーションID	実行された処理のオペレーションIDが出力されます。
ファイルサーバー名またはデータベースサーバー名	ファイルシステムの場合バックアップの対象となったファイルサーバー名が出力されます。 SQL Serverデータベースの場合 SQL Serverインスタンスが副ボリュームへバックアップされたデータベースサーバー名が出力されます。 Exchangeデータベースの場合オペレーション定義ファイルの指定項目「`DB_SERVER_NAME`」に記述されている文字列が出力されます。
インスタンス名	ファイルシステムの場合バックアップの対象となったマウントポイントディレクトリー名またはマウントポイントディレクトリー一括定義ファイル名が出力されます。 SQL Serverデータベースの場合バックアップの対象となったSQL Serverインスタンス名が出力されます。 Exchangeデータベースの場合オペレーション定義ファイルの指定項目「`INSTANCE_NAME`」に記述されている文字列が出力されます。
拡張コマンド名	拡張コマンドを特定する文字列（拡張子を除いた拡張コマンドファイル名）が出力されます。
拡張コマンドオプション	拡張コマンドで指定したオプションが出力されます。
ログメッセージID	ログメッセージを識別するIDが出力されます。
ログメッセージ本文	拡張コマンドが出力したログメッセージの詳細が出力されます。

ログファイルの出力例を次に示します。

2021/07/31 20:15:11.560 |START     |operation1 |FSServer_A |M: |EX_DRM_FS_BACKUP |KAVX0450-I The EX_DRM_FS_BACKUP command will now start.
2021/07/31 20:17:22.060 |END       |operation1 |FSServer_A |M: |EX_DRM_FS_BACKUP |The EX_DRM_FS_BACKUP command will now end.