SlotKeeper 設計と品質

Message catalog: resources/get_resource_schedule

API

項目 値
domain resources
api get_resource_schedule
routes GET /resources/{resourceId}/schedule (getResourceSchedule)
router src/app/apis/resources/get_resource_schedule/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 getResourceSchedule.router_api_function_error Routerで捕捉したApiFunctionErrorにより予約表取得が失敗した。

ログ詳細

M001 getResourceSchedule.router_api_function_error

項目 内容
id M001
message_id getResourceSchedule.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/resources/get_resource_schedule/functions.py
wrapper: src/app/apis/resources/get_resource_schedule/functions.py (ops_logger.error)

出力項目

出力項目 型 説明
traceId string | null リクエストとログを横断して追跡する相関IDです。
actorPrincipalId string | null APIを呼び出した認証主体IDです。
api.statusCode integer | null API responseとして返したHTTP status codeです。
resource ErrorResource ログに出力するAPI固有のErrorResourceです。
resource.resourceId string | null 予約表の対象資源の存在確認、問い合わせに使用する資源IDです。
resource.day CalendarDate | null 予約表を再取得するための日付です。
error.code string | null エラー分類を表す機械処理向けコードです。
error.message string | null エラー内容を運用者が理解するための説明です。
error.exceptionType string | null 捕捉された例外の型名です。

strict検証で要求する項目

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