majiayu000 Monitoring & Alerting
概要
システム可観測性を実現するためのスキル。ゴールデンシグナルに基づくメトリクス戦略、 構造化ログ設計、SLI/SLO定義、アラート閾値設定を統合的に提供する。
ワークフロー
Phase 1: 監視戦略の立案
目的: ビジネス要件からSLI/SLOを定義し、監視対象を決定
参照エージェント: agents/define-sli-slo.md
アクション:
- ビジネス目標からSLI（Service Level Indicator）を特定
- ゴールデンシグナルの4軸を適用範囲内で選択
- SLO（Service Level Objective）の目標値を設定
references/golden-signals.mdでメトリクス設計パターンを確認
Phase 2: 監視実装
目的: SLI/SLOに基づいてメトリクス、ログ、アラートを実装
参照エージェント: agents/implement-monitoring.md
アクション:
- ログ設計：
references/logging-design.mdで構造化ログ仕様を確認 - メトリクス収集：
scripts/check-metrics.mjsで死活監視を実装 - アラートルール定義：
references/alerting-rules.mdで閾値設定 - 通知連携：
references/discord-notifications.mdでWebhook統合
Phase 3: ダッシュボードと検証
目的: 可観測性の可視化と動作確認
参照エージェント: agents/validate-observability.md
アクション:
assets/dashboard-template.jsonでGrafanaダッシュボード構成scripts/check-metrics.mjsでメトリクス出力を検証scripts/log_usage.mjsで実行記録と成功/失敗を記録
リソース参照
参照ドキュメント
| ドキュメント | 内容 |
|---|---|
| references/basics.md | 監視基本概念、メトリクス/ログ分類 |
| references/patterns.md | 実装パターン、設計原則 |
| references/golden-signals.md | ゴールデンシグナル4指標詳細 |
| references/logging-design.md | 構造化ログ仕様、相関ID設計 |
| references/alerting-rules.md | 閾値決定、エスカレーション |
| references/discord-notifications.md | Discord Webhook連携 |
スクリプト
| スクリプト | 用途 |
|---|---|
scripts/check-metrics.mjs |
メトリクスエンドポイント確認、死活監視 |
scripts/log_usage.mjs |
使用記録・評価スクリプト |
scripts/validate-skill.mjs |
スキル構造検証 |
テンプレート
| テンプレート | 用途 |
|---|---|
assets/alert-rules-template.yml |
Prometheus/Alertmanagerルール定義 |
assets/dashboard-template.json |
Grafanaダッシュボード設定 |
assets/incident-report-template.md |
インシデント記録 |
assets/structured-logger-template.ts |
構造化ロガー実装例 |
ベストプラクティス
すべきこと
- ゴールデンシグナル優先でメトリクス選定
- 構造化ログ（JSON形式）で相関ID付与
- SLI/SLO駆動でアラート閾値決定
- 段階的監視実装（最初は3〜5メトリクス）
- アラート抑制ルールでノイズ防止
避けるべきこと
- 無差別なメトリクス収集（コスト増・ノイズ増）
- 固定閾値のみ（ビジネス目標との乖離）
- ログレベルの不統一（解析困難）
- アラート疲れを招く過剰通知