TAG

Observability

17 記事

Claude API のセマンティックキャッシュを本番投入する — 類似プロンプト判定としきい値設計、汚染防止

類似プロンプトへの応答を再利用するセマンティックキャッシュをClaude APIの本番に組み込む設計を一気通貫で解説します。embeddingと類似度しきい値の決め方、マルチテナント分離、キャッシュ汚染を防ぐガード層、フォールバックと劣化モード、効果を測る観測性の指標まで踏んだ地雷とともに紹介します。

⬡ API & SDK/2026-04-27中級

Claude API を本番にのせる前に揃えるインフラ — 「動く」と「本番で持つ」の間にある8つの実装

ローカルで動く Claude API のコードを本番に移すと、レート制限・タイムアウト・課金事故・無音障害が一気に襲ってきます。月数万リクエスト規模を運用して見えた、必要最小限のインフラ8項目を整理しました。

⟐ Claude Code/2026-04-24上級

Claude Code Hooks の本番デバッグ術 — ログが足りない時、どこから切り分けるか

ローカルでは動くのに本番で沈黙するClaude Code Hooksの切り分け方を体系化しました。まず疑うべきは出力先という視点、ログ不足を補う3層の可観測性、最小再現環境を60秒で作るテクニック、JSON入出力とexit codeのプロトコル把握、マルチユーザー環境の権限診断まで扱います。

⬡ API & SDK/2026-04-24上級

Claude Agent SDK でシャドウモードを実装する — 本番影響ゼロでエージェント精度を測る段階的ロールアウト設計

AIエージェントを本番に出す前に精度を測りたい。でもユーザーに触れさせるしかない。この矛盾を解くのがシャドウモードです。Claude Agent SDK で既存フローに影響を与えずエージェントを並走させ、差分を記録し、段階的に昇格するまでの実装を解説します。

⬡ API & SDK/2026-03-27上級

Claude API × OpenTelemetry でAIアプリケーションのオブザーバビリティを構築する

Claude APIを使ったAIアプリケーションにOpenTelemetryを統合し、トレーシング・メトリクス・ログを一元管理する本番実装パターンを解説します。トークン使用量、レイテンシ、エラー率の可視化からコストアラートまで網羅。