Monitoring & Alerting

概要

システム可観測性を実現するためのスキル。ゴールデンシグナルに基づくメトリクス戦略、 構造化ログ設計、SLI/SLO定義、アラート閾値設定を統合的に提供する。

ワークフロー

Phase 1: 監視戦略の立案

目的: ビジネス要件からSLI/SLOを定義し、監視対象を決定

参照エージェント: agents/define-sli-slo.md

アクション:

1. ビジネス目標からSLI（Service Level Indicator）を特定
2. ゴールデンシグナルの4軸を適用範囲内で選択
3. SLO（Service Level Objective）の目標値を設定
4. references/golden-signals.md でメトリクス設計パターンを確認

Phase 2: 監視実装

目的: SLI/SLOに基づいてメトリクス、ログ、アラートを実装

参照エージェント: agents/implement-monitoring.md

アクション:

1. ログ設計：references/logging-design.md で構造化ログ仕様を確認
2. メトリクス収集：scripts/check-metrics.mjs で死活監視を実装
3. アラートルール定義：references/alerting-rules.md で閾値設定
4. 通知連携：references/discord-notifications.md でWebhook統合

Phase 3: ダッシュボードと検証

目的: 可観測性の可視化と動作確認

参照エージェント: agents/validate-observability.md

アクション:

1. assets/dashboard-template.json でGrafanaダッシュボード構成
2. scripts/check-metrics.mjs でメトリクス出力を検証
3. scripts/log_usage.mjs で実行記録と成功/失敗を記録

リソース参照

参照ドキュメント

スクリプト

テンプレート

ベストプラクティス

すべきこと

• ゴールデンシグナル優先でメトリクス選定
• 構造化ログ（JSON形式）で相関ID付与
• SLI/SLO駆動でアラート閾値決定
• 段階的監視実装（最初は3〜5メトリクス）
• アラート抑制ルールでノイズ防止

避けるべきこと

• 無差別なメトリクス収集（コスト増・ノイズ増）
• 固定閾値のみ（ビジネス目標との乖離）
• ログレベルの不統一（解析困難）
• アラート疲れを招く過剰通知