SlotKeeper 設計と品質

Message catalog: reservations/list_reservations

API

項目 値
domain reservations
api list_reservations
routes GET /reservations (listReservations)
router src/app/apis/reservations/list_reservations/router.py
messages 1
logger wrapper calls 1
levels ERROR:1

生成・検証方針

  • WARNING以上のMessage catalogは router.py、functions.py または response_builders.py の ops_logger.warning/error(...) kwargsを一次情報にする。
  • api_error_response(...) のstatus/detailとlogger呼び出しのstatus/detailを照合する。
  • 実装中の app.core.logging ラッパー呼び出しを検出し、WARN以上はAPI operation内のemitとcatalog定義の一致を検証する。
  • logging.getLogger(...)、logger.info(...) などの直接呼び出しは許可しない。
  • WARNING以上は運用上の意味を持つ前提で、必要な確認手順・runbook・contextを検証対象にする。

メッセージ一覧

id message_id ログ概要
M001 listReservations.router_api_function_error Routerで捕捉したApiFunctionErrorにより予約一覧取得が失敗した。

ログ詳細

M001 listReservations.router_api_function_error

項目 内容
id M001
message_id listReservations.router_api_function_error
level ERROR
status
wrapper calls 1
ログ概要 Routerで捕捉したApiFunctionErrorにより予約一覧取得が失敗した。
説明 ROUTER_HANDLED_EXCEPTIONSを捕捉した場合。
対応すべきこと 同一routeの5xx率、直近deploy、DB状態を確認する。
runbook RUNBOOK-unexpected-api-failure
実装参照 src/app/apis/reservations/list_reservations/functions.py
wrapper: src/app/apis/reservations/list_reservations/functions.py (ops_logger.error)

出力項目

出力項目 型 説明
traceId string | null リクエストとログを横断して追跡する相関IDです。
actorPrincipalId string | null APIを呼び出した認証主体IDです。
api.statusCode integer | null API responseとして返したHTTP status codeです。
error.code string | null エラー分類を表す機械処理向けコードです。
error.message string | null エラー内容を運用者が理解するための説明です。
error.exceptionType string | null 捕捉された例外の型名です。
resource ErrorResource ログに出力するAPI固有のErrorResourceです。
resource.day CalendarDate | null 一覧復帰時に同じ絞り込みを再現するための日付です。
resource.status ReservationStatus | null 一覧復帰時に同じ絞り込みを再現するための予約状態です。

strict検証で要求する項目

Level 必須項目
WARNING why_production
ERROR check_procedure, context_model, runbook
CRITICAL remediation_procedure, context_model, runbook, escalation