logging-observability
面向生产系统的结构化日志和可观测性设计技能。实施日志、指标和追踪的三个支柱,实现完整的系统可观测性。锚点:• 《可观测性工程》(查理·梅杰斯) / 适用:高基数调试 / 目标:根本原因分析• 《监控的艺术》(詹姆斯·特布尔) / 适用:指标战略 / 目标:有效的警报• 十二要素应用(要素XI) / 适用:作为事件流的日志 / 目标:云原生日志记录• OpenTelemetry规范 / 适用:测量 / 目标:供应商中立的可观测性触发:在实施日志、设置可观测性、设计指标/警报、集成分布式追踪或解决生产系统问题时使用。
name: logging-observability description: | 本番システム向け構造化ログとオブザーバビリティ設計スキル。Logs、Metrics、Tracesの3本柱を実装し、完全なシステム可視性を実現。
Anchors: • 『Observability Engineering』(Charity Majors) / 適用: 高カーディナリティデバッグ / 目的: 根本原因分析 • 『The Art of Monitoring』(James Turnbull) / 適用: メトリクス戦略 / 目的: 効果的アラート • Twelve-Factor App (Factor XI) / 適用: イベントストリームとしてのログ / 目的: クラウドネイティブロギング • OpenTelemetry Specification / 適用: 計装 / 目的: ベンダー中立オブザーバビリティ
Trigger: Use when implementing logging, setting up observability, designing metrics/alerting, integrating distributed tracing, or troubleshooting production systems. allowed-tools: - Read - Write - Edit - Bash - Glob - Grep - Task
Logging & Observability
相対パス:
SKILL.md読込条件: スキル使用時(自動)
概要
構造化ログとオブザーバビリティの設計・実装スキル。
オブザーバビリティの3本柱:
| 柱 | 用途 | ツール例 |
|---|---|---|
| Logs | イベント・エラー詳細記録 | Winston, Pino, Bunyan |
| Metrics | 集計データ・トレンド監視 | Prometheus, Datadog, CloudWatch |
| Traces | 分散リクエストフロー追跡 | Jaeger, Zipkin, OpenTelemetry |
ワークフロー
Phase 1: ログ戦略設計
Task: agents/design-logging-strategy.md
| 入力 | 出力 |
|---|---|
| システム要件、アーキテクチャ図 | ログ戦略ドキュメント |
参照: references/basics.md
Phase 2: 構造化ログ実装
Task: agents/implement-structured-logging.md
| 入力 | 出力 |
|---|---|
| ログ戦略ドキュメント | 実装済みログコード |
参照: references/patterns.md, assets/structured-log.json
Phase 3: オブザーバビリティ設定
Task: agents/setup-observability.md
| 入力 | 出力 |
|---|---|
| 実装済みログコード | オブザーバビリティ設定 |
参照: references/patterns.md, assets/observability-config.yaml
Phase 4: 検証
Task: agents/validate-logging.md
| 入力 | 出力 |
|---|---|
| オブザーバビリティ設定 | 検証結果レポート |
ベストプラクティス
| すべきこと | 避けるべきこと |
|---|---|
| 構造化ログ (JSON) を使用 | プレーンテキストログ |
| コンテキストID (trace_id) を含める | ログレベルの誤用 |
| 機密情報をマスキング | 個人情報の平文出力 |
| ログローテーション設定 | 無制限のログ出力 |
| メトリクスとログを相関付け | ローカルファイルのみへ出力 |
| サンプリング戦略を検討 | 高頻度ログの無制限保持 |
Task ナビゲーション
| Task | 目的 | 参照リソース |
|---|---|---|
design-logging-strategy.md |
ログレベル・構造・保持期間設計 | basics.md |
implement-structured-logging.md |
構造化ログ実装 | patterns.md, assets |
setup-observability.md |
メトリクス・アラート・ダッシュボード | patterns.md |
validate-logging.md |
ログ構造検証・クエリテスト | scripts |
リソース参照
References
| ファイル | 内容 | 読込条件 |
|---|---|---|
basics.md |
ログレベル・構造化ログ基礎・用語 | 初回使用時 |
patterns.md |
実装パターン・メトリクス設計・アラート | 実装時 |
Assets
| ファイル | 内容 |
|---|---|
structured-log.json |
構造化ログ JSON スキーマ |
observability-config.yaml |
Prometheus/Grafana 設定テンプレート |
ログレベルガイド
| レベル | 使用基準 | 例 |
|---|---|---|
| ERROR | 即座の対応が必要 | 未処理例外、サービス障害 |
| WARN | 注意が必要だが動作継続 | 遅延警告、リトライ発生 |
| INFO | 重要なビジネスイベント | リクエスト開始/完了、処理成功 |
| DEBUG | 開発時の詳細情報 | パラメータ値、中間状態 |
関連スキル
log-rotation-strategies- ログローテーション設定error-handling-patterns- エラーハンドリング戦略metrics-tracking- メトリクス収集