メインコンテンツまでスキップ

ロギング・監査・モニタリング (Logging & Audit)

ステータス

担当者: Tech lead · ステータス: draft · 正式な情報源: flezi.app.api.backend/app/middleware/logging.py、app/features/governance/

このドキュメントでは、システムが activity log (application logs)、security audit trail、システム状態をどのように記録・追跡するかを説明します。

収集するログの種類​

  1. Request & Access Logs: Backend を通過するすべての HTTP request を response code、処理時間、サービス全体で一意な correlation_id とともに記録します。
  2. Security Audit Logs: 権限変更、メンバーの作成・編集・削除、パスワード変更、policy の割り当て、HITL の承認操作を記録します。
  3. AI Execution Traces: MLflow Server に保存し、LangGraph の実行フロー、tool 呼び出し、消費 token 数を記録します。

Logging におけるセキュリティ原則​

  • 機密データの Masking: card 情報、plain text password、secret key、token を log file に記録することは一切ありません。
  • 完全性: log file は、改ざん禁止ポリシー (WORM - Write Once, Read Many) を持つ集中 storage system に集約して送信します。

現在の対策​

  • app/middleware/logging.py は、構造化 JSON 形式の loguru library を使用します。
  • 各 request に correlation_id を付与し、microservices 全体で incident を容易に追跡できます。

証跡 (file / config)​

  • flezi.app.api.backend/app/middleware/logging.py
  • flezi.app.api.backend/app/docs/CORRELATION_ID_SOLUTION.md

制限事項とロードマップ​

  • 顧客の SIEM (Microsoft Sentinel や Splunk など) へ、すべての security log をリアルタイムで転送する接続を追加します。