file-watcher-observability
ファイル監視システムの可観測性(Observability)を3本柱(Metrics、Logs、Traces)に基づいて実装するスキル。Prometheus/Grafana統合でSLA遵守測定、パフォーマンス監視、障害根本原因分析を支援。Anchors:• Observability Engineering(Charity Majors) / 適用: 3本柱設計 / 目的: メトリクス・ログ・トレースの統合• Google SRE Book / 適用: ゴールデンシグナル / 目的: SLI/SLO設計• Prometheus Documentation / 適用: メトリクス命名規則 / 目的: 標準準拠の実装Trigger:Use when implementing observability for file watcher systems, setting up Prometheus/Grafana monitoring, designing SLI/SLO metrics, or analyzing production performance issues.
When & Why to Use This Skill
This Claude skill provides a comprehensive framework for implementing observability in file monitoring systems based on the three pillars: Metrics, Logs, and Traces. It leverages Prometheus and Grafana integration to enable SRE-driven performance monitoring, SLA compliance tracking, and efficient root cause analysis using industry standards like Golden Signals and SLI/SLO design.
Use Cases
- Designing and implementing SLI/SLO metrics for file-based data pipelines to ensure system reliability and SLA compliance.
- Setting up automated Prometheus exporters and Grafana dashboards for real-time visualization of file watcher system health.
- Troubleshooting production performance bottlenecks and file system latency using integrated traces and log analysis.
- Standardizing observability infrastructure across DevOps teams using Prometheus naming conventions and SRE best practices.
| name | file-watcher-observability |
|---|---|
| description | | |
| • Observability Engineering(Charity Majors) / 適用 | 3本柱設計 / 目的: メトリクス・ログ・トレースの統合 |
| • Google SRE Book / 適用 | ゴールデンシグナル / 目的: SLI/SLO設計 |
| • Prometheus Documentation / 適用 | メトリクス命名規則 / 目的: 標準準拠の実装 |
ファイル監視システムの可観測性設計
概要
ファイル監視システムに対してMetrics・Logs・Tracesの3本柱を統合し、Prometheus/Grafanaで本番環境のパフォーマンスを定量的に監視・分析するスキル。
ワークフロー
Phase 1: メトリクス設計
目的: SLA要件からメトリクス定義とSLI/SLOを設計
アクション:
- references/basics.md で可観測性の基本概念を確認
- ゴールデンシグナル(Latency、Traffic、Errors、Saturation)を定義
- Prometheus命名規則に準拠したメトリクス名を設計
- SLI/SLO目標値を明文化
Task: agents/metrics-design.md を参照
Phase 2: 可観測性セットアップ
目的: Prometheus/Grafana/Logs/Tracesの統合実装
アクション:
- references/patterns.md で実装パターンを確認
- assets/metrics-collector.ts をカスタマイズ
- assets/grafana-dashboard.json でダッシュボード構築
- アラートルールを定義
Task: agents/observability-setup.md を参照
Phase 3: 検証と運用
目的: 設定の検証と運用開始
アクション:
scripts/validate-observability.mjs --allで設定を検証- 本番環境へのデプロイ
- アラート通知先の設定
scripts/log_usage.mjs --result successで記録
Task仕様ナビ
| Task | 用途 | 入力 | 出力 |
|---|---|---|---|
| agents/metrics-design.md | メトリクス設計 | SLA要件 | メトリクス定義書・SLO仕様 |
| agents/observability-setup.md | セットアップ | メトリクス定義書 | 設定ファイル群 |
ベストプラクティス
すべきこと
- SLA定義を明確にしてからメトリクスを設計する
- ゴールデンシグナル4つを必ずカバーする
- ダッシュボードはオンコール対応者向けに最小限の情報に絞る
- アラート閾値は実運用データに基づいて調整する
避けるべきこと
- 測定設計なしで実装を始める
- すべてのメトリクスを取得しようとする(コスト増大)
- ラベルに高カーディナリティ値(ファイルパス等)を使用する
- ダッシュボードを情報過多にする
リソース参照
references/(詳細知識)
| リソース | パス | 内容 |
|---|---|---|
| 基本概念 | references/basics.md | 3本柱・ゴールデンシグナル・SLI/SLO |
| 実装パターン | references/patterns.md | Prometheus/Grafana設定例 |
assets/(テンプレート)
| テンプレート | 用途 |
|---|---|
| metrics-collector.ts | メトリクス収集コード |
| grafana-dashboard.json | Grafanaダッシュボード設定 |
scripts/(検証・記録)
| スクリプト | 用途 | 使用例 |
|---|---|---|
| validate-observability.mjs | 設定検証 | node scripts/validate-observability.mjs --all |
| log_usage.mjs | 利用記録 | node scripts/log_usage.mjs --result success |
| health-check.sh | ヘルスチェック | ./scripts/health-check.sh |
変更履歴
| Version | Date | Changes |
|---|---|---|
| 2.0.0 | 2026-01-02 | 18-skills.md仕様に完全準拠。agents/を2つに統合、references/を刷新 |
| 1.1.0 | 2025-12-31 | frontmatter改訂、構成再編 |
| 1.0.0 | 2025-12-24 | 初版作成 |