PART 02 — ログ設計書
ログレベル・フォーマット・保持期間の完全定義

■ 採用フォーマット: JSON（構造化ログ）
  理由: CloudWatch Logs / Datadog / Elasticsearch で自動パースが可能

■ フィールド定義
{
  "timestamp":  "2026-06-18T12:00:00.123Z",    // ISO8601 UTC
  "level":      "ERROR",                         // ERROR/WARN/INFO/DEBUG
  "logger":     "com.example.order.OrderService",// クラス名
  "traceId":    "abc123def456",                  // リクエスト単位の一意ID
  "userId":     12345,                           // 操作ユーザーID（null可）
  "errorCode":  "BIZ_001",                       // エラーコード（エラー時のみ）
  "message":    "在庫引当失敗 product_id=456",   // ログメッセージ
  "context": {                                   // 追加コンテキスト
    "product_id": 456,
    "requested": 10,
    "available": 3
  },
  "elapsed_ms": 23                               // 処理時間（ms）
}

■ 禁止事項
- パスワード・APIキーの出力
- クレジットカード番号・銀行口座番号
- マイナンバー・パスポート番号
- メールアドレス（アクセスログを除く）
  ※ ユーザーIDのみで追跡可能にする設計とする

"""
Python での JSON 構造化ログ実装
pip install python-json-logger
"""
import logging, json
from datetime import datetime, timezone
from pythonjsonlogger import jsonlogger

class AppJsonFormatter(jsonlogger.JsonFormatter):
    def add_fields(self, log_record, record, message_dict):
        super().add_fields(log_record, record, message_dict)
        log_record["timestamp"] = datetime.now(timezone.utc).isoformat()
        log_record["level"] = record.levelname
        log_record["logger"] = record.name
        # traceId はリクエストスコープから取得（例: contextvars）
        import contextvars
        trace_id = contextvars.copy_context().get(
            contextvars.ContextVar("trace_id"), None)
        if trace_id:
            log_record["traceId"] = trace_id.get(None)

def setup_logging(level=logging.INFO):
    handler = logging.StreamHandler()
    handler.setFormatter(AppJsonFormatter(
        "%(timestamp)s %(level)s %(logger)s %(message)s"
    ))
    logging.basicConfig(level=level, handlers=[handler])

setup_logging()
logger = logging.getLogger("com.example.order.OrderService")

# 使い方
logger.info("注文確定", extra={"userId": 12345, "orderId": 67890, "totalAmount": 11000})
logger.warning("在庫残少", extra={"product_id": 456, "remaining": 5})
logger.error("在庫引当失敗",
             extra={"errorCode": "BIZ_001",
                    "context": {"product_id": 456, "requested": 10, "available": 3}})

# 出力例
# {"timestamp": "2026-06-18T03:00:00.123Z", "level": "INFO",
#  "logger": "com.example.order.OrderService",
#  "message": "注文確定", "userId": 12345, "orderId": 67890, "totalAmount": 11000}