// ロギング、メトリクス、分散トレーシングのオブザーバビリティパターン。以下の場合に使用: - 構造化ロギングの実装 - メトリクスとモニタリングのセットアップ - 分散トレーシングの追加 - ヘルスチェック（liveness、readiness）の実装 - アラートや SLO ベースのモニタリングの設計 Trigger phrases: logging, metrics, tracing, monitoring, health check, alerting, SLO, structured logs, observability
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | observability |
| description | ロギング、メトリクス、分散トレーシングのオブザーバビリティパターン。以下の場合に使用: - 構造化ロギングの実装 - メトリクスとモニタリングのセットアップ - 分散トレーシングの追加 - ヘルスチェック（liveness、readiness）の実装 - アラートや SLO ベースのモニタリングの設計 Trigger phrases: logging, metrics, tracing, monitoring, health check, alerting, SLO, structured logs, observability |
| allowed-tools | Read, Glob, Grep, Write, Edit, Bash, WebSearch, WebFetch |
| model | sonnet |
| user-invocable | true |
ロギング、メトリクス、トレーシングを通じてオブザーバブルなシステムを構築するためのスタック非依存パターン。このスキルはコンセプトとパターンを定義するものであり、特定のライブラリ実装を定義するものではない。
デバッグと監査のための構造化されたコンテキスト付きログ。
モニタリングとアラートのための数値測定。
サービス間の分散リクエスト追跡。
適切に構造化されたログエントリは以下を含むべき:
{
"timestamp": "ISO 8601 形式",
"level": "INFO/WARN/ERROR/DEBUG",
"service": "サービス識別子",
"trace_id": "リクエスト追跡用の相関 ID",
"message": "人間が読める説明",
"context": {
"relevant": "コンテキストデータ"
}
}
| レベル | 使用場面 | 例 |
|---|---|---|
| DEBUG | 開発の詳細 | クエリパラメータ、キャッシュヒット |
| INFO | 通常の操作 | ユーザー作成、リクエスト完了 |
| WARN | 潜在的な問題 | リトライが必要、非推奨 API の使用 |
| ERROR | 操作失敗 | データベース接続失敗 |
| FATAL | アプリケーションクラッシュ | 回復不能なエラー |
すべきこと:
すべきでないこと:
ロギングを実装する際:
WebSearch: "[言語] structured logging library [year]"
| タイプ | 使用場面 | 例 |
|---|---|---|
| Counter | 累積値（増加のみ） | リクエスト数、エラー数 |
| Gauge | ポイントインタイム値（増減あり） | アクティブ接続数、キューサイズ |
| Histogram | 値の分布 | リクエストレイテンシー、レスポンスサイズ |
| Summary | 事前計算されたパーセンタイル | p50、p99 レイテンシー |
形式: <namespace>_<name>_<unit>
良い例:
- http_requests_total
- http_request_duration_seconds
- database_connections_active
- queue_messages_waiting
悪い例:
- requests (名前空間なし、単位なし)
- httpRequestDuration (camelCase、不統一)
- request-latency (ハイフン、単位なし)
RED メソッド（リクエスト指向）:
USE メソッド（リソース指向）:
Four Golden Signals:
メトリクスを実装する際:
WebSearch: "[言語] metrics library [year]"
WebSearch: "metrics collection [インフラストラクチャ] [year]"
Trace（リクエスト全体の旅程）
├── Span A: API Gateway（親）
│ ├── Span B: Auth Service
│ └── Span C: User Service
│ └── Span D: Database Query
コンテキスト伝播の標準ヘッダー:
| 標準 | 説明 |
|---|---|
| W3C Trace Context | モダンな標準（traceparent、tracestate） |
| B3 | Zipkin 形式（X-B3-* ヘッダー） |
トレーシングを実装する際:
WebSearch: "distributed tracing [言語] [year]"
WebSearch: "[トレーシングプラットフォーム] integration guide"
// GET /health
{
"status": "healthy|degraded|unhealthy",
"version": "アプリバージョン",
"uptime_seconds": 3600,
"checks": {
"database": {
"status": "healthy",
"latency_ms": 5
},
"cache": {
"status": "healthy",
"latency_ms": 2
},
"external_api": {
"status": "degraded",
"message": "High latency"
}
}
}
| チェック | 目的 | 失敗時のアクション |
|---|---|---|
| Liveness | アプリは動作しているか？ | コンテナを再起動 |
| Readiness | リクエストを処理できるか？ | ロードバランサーから除外 |
| Startup | アプリは起動したか？ | まだ liveness をチェックしない |
良いアラートに含まれるもの:
避けるべきこと:
SLI: 99.9% のリクエストが 200ms 以内に完了
SLO: 30 日間で 99.9% の成功率
エラーバジェット: 0.1% = 約 43 分/月
アラート条件:
- バーンレート > 1x: スローバーン、低重大度
- バーンレート > 10x: ファストバーン、高重大度
セキュリティと運用の安全性に不可欠。
運用品質に重要。適切な理由がある場合はオーバーライド可。
包括的なオブザーバビリティのための推奨事項。