observability-pillars
オブザーバビリティ三本柱(ログ・メトリクス・トレース)の統合設計スキル。相関IDによる連携と双方向ナビゲーション(メトリクス→ログ→トレース)を実現。Anchors:• Observability Engineering (Charity Majors) / 適用: 三本柱統合パターン / 目的: 高カーディナリティObservability• Google SRE Book / 適用: メトリクス設計とSLI/SLO / 目的: 信頼性エンジニアリング• W3C Trace Context / 適用: 分散トレーシング標準 / 目的: 相互運用可能なトレース伝播Trigger:Use when integrating logs, metrics, and traces with correlation IDs, designing bi-directional navigation between pillars, implementing OpenTelemetry, or setting up high-cardinality observability.observability, three pillars, logs, metrics, traces, correlation ID, OpenTelemetry, tracing, distributed systems
When & Why to Use This Skill
This Claude skill provides a comprehensive framework for integrating the three pillars of observability—logs, metrics, and traces—into a unified system. By leveraging correlation IDs and bi-directional navigation, it helps engineers implement high-cardinality observability and distributed tracing based on OpenTelemetry standards and Google SRE best practices to significantly reduce Mean Time to Resolution (MTTR).
Use Cases
- Designing a unified observability architecture that connects metrics, logs, and traces using consistent correlation IDs (Request ID/Trace ID).
- Implementing distributed tracing with W3C Trace Context to track requests across complex microservices environments.
- Setting up bi-directional navigation to allow seamless transitions from high-level metric spikes to specific error logs and detailed trace spans.
- Optimizing system reliability by designing SLIs/SLOs and implementing high-cardinality data collection for deep-dive debugging.
- Modernizing legacy monitoring setups by migrating to OpenTelemetry-compliant instrumentation and sampling strategies.
| name | observability-pillars |
|---|---|
| description | | |
| • Observability Engineering (Charity Majors) / 適用 | 三本柱統合パターン / 目的: 高カーディナリティObservability |
| • Google SRE Book / 適用 | メトリクス設計とSLI/SLO / 目的: 信頼性エンジニアリング |
| • W3C Trace Context / 適用 | 分散トレーシング標準 / 目的: 相互運用可能なトレース伝播 |
Observability Pillars
概要
オブザーバビリティ三本柱(ログ・メトリクス・トレース)の統合設計スキル。 Charity Majorsの『Observability Engineering』に基づき、相関IDによる連携と双方向ナビゲーションを実現する。
ワークフロー
Phase 1: 現状分析
目的: 既存のObservability成熟度を評価
アクション:
- 現在のログ・メトリクス・トレース実装状況を調査
- 相関IDの有無と一貫性を確認
- ナビゲーション経路(メトリクス→ログ→トレース)を評価
Task: agents/analyze-pillars.md を参照
Phase 2: 統合設計
目的: 三本柱の統合アーキテクチャを設計
アクション:
- 相関ID体系(Request ID、Trace ID)を設計
- コンテキスト伝播方式を選定(同期/非同期)
- 双方向ナビゲーション経路を設計
Task: agents/design-integration.md を参照
Phase 3: 実装
目的: 統合パターンを実装
アクション:
- ミドルウェアで相関ID生成・伝播を実装
- ログ・メトリクス・トレースにID埋め込み
- ダッシュボードでナビゲーションリンクを設定
Task: agents/implement-correlation.md を参照
Task仕様(ナビゲーション)
| Task | 起動タイミング | 入力 | 出力 |
|---|---|---|---|
| analyze-pillars | Phase 1開始時 | 現行システム | 成熟度評価結果 |
| design-integration | Phase 2開始時 | 評価結果 | 統合設計書 |
| implement-correlation | Phase 3開始時 | 設計書 | 実装済みコード |
詳細仕様: 各Taskの詳細は agents/ ディレクトリの対応ファイルを参照
三本柱の役割
| 柱 | 目的 | 強み | 弱み |
|---|---|---|---|
| Logs | イベント詳細記録 | 高カーディナリティ | 検索コスト高 |
| Metrics | 集約数値監視 | 低コスト、長期保持 | 詳細コンテキスト欠 |
| Traces | リクエストフロー | 分散システム可視化 | サンプリング必要 |
相関ID体系
| ID Type | スコープ | フォーマット | 生成タイミング |
|---|---|---|---|
| Request ID | 単一HTTPリクエスト | UUID v4 | リクエスト受信時 |
| Trace ID | 分散システム全体 | W3C Trace Context (16B) | エントリーポイント |
| Span ID | 単一操作 | 8バイトHex | 各スパン開始時 |
ベストプラクティス
すべきこと
- 統一相関ID: すべての柱でrequest_id/trace_idを共有
- 双方向ナビゲーション: メトリクス ⇄ ログ ⇄ トレース
- 自動相関: 異常検知時に関連情報を自動収集
- 一貫性: タイムスタンプ・サービス名・環境を統一
避けるべきこと
- 三本柱が独立: 相関IDなしで各々が孤立
- メトリクスのみ依存: ログとトレースがない
- 過剰な高カーディナリティ: メトリクスに数百万のラベル
- PIIの無防備な記録: 個人情報をマスキングせず記録
リソース参照
references/(詳細知識)
| リソース | パス | 用途 |
|---|---|---|
| 基礎知識 | See references/basics.md | 三本柱の基本概念 |
| 統合パターン | See references/integration-patterns.md | 相関ID・ナビゲーション設計 |
| OpenTelemetryガイド | See references/opentelemetry-guide.md | OTel導入手順 |
| サンプリング戦略 | See references/sampling-strategies.md | トレースサンプリング設計 |
assets/(テンプレート)
| リソース | パス | 用途 |
|---|---|---|
| 統合設定 | assets/integration-config.ts |
OpenTelemetry統合設定テンプレート |
変更履歴
| Version | Date | Changes |
|---|---|---|
| 2.0.0 | 2026-01-02 | 18-skills.md仕様に完全準拠 |
| 1.0.0 | 2025-12-24 | 初期実装 |