本文へ移動
Wagby11
マニュアルのグループを選ぶ

WAGBY11 MANUAL / 28

メール配送の履歴を監査ログで確認する

メールの受付から処理結果・再試行・手動操作までを監査ログで追い、いつ・誰が・どの状態へ変更したかを確認できます。

最終更新日：

運用の小目次へ

1. このページで伝える機能

メールの受付から処理結果・再試行・手動操作までを監査ログで追い、いつ・誰が・どの状態へ変更したかを確認できます。

2. Wagby11で実現できること

システム管理者が「システム > システム運用 > メール送信 > 配送監査ログ」を開きます。Outbox ID、発生日時、操作、遷移後状態、結果、エラー分類、リクエストID、操作者、対象モデル・データIDなどで絞り込みます。

対象データIDで絞り込み、受付・処理開始・失敗・管理者による送信取消の履歴を確認する例。
対象データIDで絞り込み、受付・処理開始・失敗・管理者による送信取消の履歴を確認する例。

この例では、新しい記録からMANUAL_CANCEL、PERMANENT_FAILURE、PROCESSING_STARTED、ENQUEUEDの順に表示されています。同じOutbox IDを時系列に追うと、送信要求の受付後に失敗し、管理者が取り消した経緯を確認できます。現在の状態だけを確認する場合はメール送信管理を使います。

2.2 状態遷移と操作者をたどる

主な記録確認する内容
受付・処理開始・送信成功要求の登録から配送処理の結果までを追います。
再試行予定・恒久失敗・再試行上限自動再試行へ進むか、失敗として終了したかを確認します。
処理中タイムアウトの回収処理を引き継ぐ契機と、その後の状態を確認します。
手動再送・送信取消管理者の操作と状態遷移を確認します。
添付解放・解放失敗添付実体のクリーンアップ結果を追います。

詳細には発生日時、遷移前後の状態、再試行回数、結果、エラー分類、リクエストID、操作者、対象モデル・対象データIDなどを記録します。リクエストIDは関連する処理や操作ログを照合する手掛かりです。非同期処理など、すべての記録に人間の操作者が付くとは限りません。

監査ログは読み取り専用です。記録の状態や結果を編集して、再送や取消を代用しません。実際の操作は送信管理から行い、監査ログで結果を確認します。

2.3 監査ログに含まれない情報を区別する

監査ログには、宛先、件名、本文、添付ファイル名、添付保存パス、例外メッセージを保存しません。メール本文を再現するための保管場所ではありません。添付解放の記録はOutbox IDと内部添付IDで対応付けます。

エラー分類は原因を絞る手掛かりとして使い、必要に応じて送信管理の最終エラーや関連する処理ログと照合します。集計から全体の傾向を調べる場合は配送メトリクスを参照してください。

3. 標準機能のAppSchema（参考）

標準の読み取り専用システムモデルjmail_delivery_auditを使います。監査のための業務モデル追加は不要です。以下は既存メニューの遷移先の抜粋です。

target:
  kind: entity
  entity: jmail_delivery_audit
  screen: search
  definition_id: mail-delivery-audit

共通基盤が管理するmail_delivery_auditを参照します。テーブル作成・状態遷移に伴う記録は共通基盤へ任せ、AppSchemaから監査内容を書き換える構成にはしません。

4. 参考資料

guide：メール送信
designer/docs/appschema/html/guide/13-mail/index.html
Java共通基盤：メール送信
designer/docs/java/html/23_mail_delivery.html