Menu
[What] KeepOn の DB エラー診断・デバッグナレッジベース。エラー分類、リトライ挙動、ログ解析パターンをカバー。 [When] Use when: DB エラーの調査、クエリタイムアウト、接続障害、ログ解析、リトライ挙動の理解が必要な時。 [Keywords] database, db, error, timeout, retry, connection, D1, SQLite, PostgreSQL, log, debug, query
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Reviews and authors Cloudflare Workers code against production best practices. Load when writing new Workers, reviewing Worker code, configuring wrangler.jsonc, or checking for common Workers anti-patterns (streaming, floating promises, global state, secrets, bindings, observability). Biases towards retrieval from Cloudflare docs over pre-trained knowledge.
Cloudflare Workers CLI for deploying, developing, and managing Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines, and Secrets Store. Load before running wrangler commands to ensure correct syntax and best practices. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.
| name | db-debug |
| description | [What] KeepOn の DB エラー診断・デバッグナレッジベース。エラー分類、リトライ挙動、ログ解析パターンをカバー。 [When] Use when: DB エラーの調査、クエリタイムアウト、接続障害、ログ解析、リトライ挙動の理解が必要な時。 [Keywords] database, db, error, timeout, retry, connection, D1, SQLite, PostgreSQL, log, debug, query |
KeepOn の DB エラー診断ナレッジベース。 D1(SQLite) / PostgreSQL エラーの分類、リトライ挙動、ログパターンの読み方をカバーする。
classifyConnectionError() (src/schemas/db.ts) による5分類:
| 分類 | トリガー | リトライ |
|---|---|---|
timeout | ETIMEDOUT, ESOCKETTIMEDOUT, "timeout", "timed out" | Yes |
network | ECONNREFUSED, ENOTFOUND, EHOSTUNREACH, "host","dns" | Yes |
connection | ECONNRESET, EPIPE, ECONNABORTED, "terminated" | Yes |
auth | "authentication", "password", "login" | No |
unknown | 上記以外 | No |
isDatabaseError() は timeout / network / connection を true と判定しリトライ対象とする。
logSpan が出力するサフィックス:
| サフィックス | 意味 |
|---|---|
:start | 処理開始 |
:end | 正常完了（ms フィールド付き） |
:error | エラー発生 |
:timeout | タイムアウト発火 |
:late-error | タイムアウト後の遅延エラー |
:retry | リトライ実行 |
:final-failure | 全リトライ失敗 |
:slow | 100ms 超のクエリ警告 |
エラーログの error フィールドには formatErrorObject() の出力が入る。
DB エラーの場合、code, severity, constraint_name, table_name, cause 等が追加される。
1. withDbRetry → DB エラー時に resetDb() + リトライ (最大2回)
2. Stale cache → リトライ失敗時にキャッシュ済みデータで応答
3. logSpanOptional → タイムアウト時に null を返し、非必須データをスキップ
:timeout なら タイムアウト階層を確認references/error-codes.md を参照:retry / :final-failure の有無 → リトライが走ったか確認:late-error の有無 → タイムアウト後に本来のエラーが出ていないか確認pnpm cf:logs で Workers ログを監視references/error-codes.md - PostgreSQL/D1 エラーコード表と対処法references/architecture.md - DB 接続・リトライ・タイムアウトのアーキテクチャ詳細references/log-patterns.md - ログフォーマット・Cloudflare/Supabase ログ解析手順