メトリクスアグリゲーター は何をしますか?
アプリケーション、データベース、キャッシュ、インフラストラクチャからのパフォーマンスメトリクスを、統一された命名規則でPrometheus、StatsD、CloudWatchに集約・一元化します。
概要
このスキルは、Claudeが多様なシステムからのメトリクスを統合ビューに集約することで、パフォーマンス監視を効率化できるようにします。パフォーマンスデータの収集、一元化、分析のプロセスを簡素化し、より良い洞察と迅速な問題解決を実現します。
しくみ
- メトリクスタクソノミの設計: Claudeは、全システムにわたる明確で一貫性のあるメトリクス命名規則の定義を支援します。
- 集約ツールの選択: Claudeは、ユーザーの環境と要件に基づいて適切なメトリクス集約ツール(例:Prometheus、StatsD、CloudWatch)の選択を支援します。
- 設定と統合: Claudeは、選択された集約ツールの設定と、さまざまなデータソースとの統合をガイドします。
- ダッシュボードとアラートの設定: Claudeは、メトリクスを可視化するダッシュボードの設定と、重要なパフォーマンス指標に対するアラートの定義を支援します。
このスキルを使用するタイミング
このスキルは、以下のような場合に有効です。
- 複数のアプリケーションやシステムからのパフォーマンスメトリクスを一元化したい場合。
- 一貫性のあるメトリクス命名規則を設計したい場合。
- ニーズに合った適切なメトリクス集約ツールを選択したい場合。
- パフォーマンス監視用のダッシュボードとアラートを設定したい場合。
例
例1: アプリケーションとシステムメトリクスの一元化
ユーザーリクエスト:「アプリケーションとシステムのメトリクスをPrometheusに集約してください。」
スキルの動作:
- アプリケーション(例:リクエストレイテンシ、エラーレート)とシステム(例:CPU使用率、メモリ使用率)のメトリクスを定義するようユーザーをガイドします。
- Prometheusがアプリケーションとシステムのエンドポイントからメトリクスをスクレイピングするように設定を支援します。
例2: データベースパフォーマンスのアラート設定
ユーザーリクエスト:「データベースメトリクスを一元化し、スロークエリに対するアラートを設定してください。」
スキルの動作:
- データベースパフォーマンスのメトリクス(例:クエリ実行時間、コネクションプール使用率)を定義するようユーザーを支援します。
- 集約ツールがデータベースからこれらのメトリクスを収集するように設定をガイドします。
- クエリ実行時間が定義されたしきい値を超えた場合に通知するアラートを集約ツールに設定するのを支援します。
ベストプラクティス
- 命名規則: すべてのメトリクスに一貫性があり明確に定義された命名規則を使用して、明確さと分析の容易さを確保します。
- 粒度: 詳細さとストレージ要件のバランスを取るために、適切な粒度のメトリクスを選択します。
- 保持ポリシー: ストレージスペースを管理し、履歴分析にデータを利用できるようにするために、メトリクスの保持ポリシーを定義します。
統合
このスキルは、インフラストラクチャを管理し、アプリケーションをデプロイし、システムの健全性を監視する他のプラグインと統合します。例えば、新しいアプリケーションデプロイ後に自動的にメトリクス収集を設定するために、デプロイプラグインと組み合わせて使用できます。
前提条件
- メトリクス収集ツール(Prometheus、StatsD、CloudWatch)へのアクセス
- メトリクスソースへのネットワーク接続
- ${CLAUDE_SKILL_DIR}/metrics/ へのメトリクスストレージ設定
- メトリクスタクソノミの理解
手順
- 一貫性のあるメトリクス命名規則を設計する
- 環境に適した集約ツールを選択する
- すべてのソースからのメトリクス収集を設定する
- 一元化されたストレージと保持ポリシーを設定する
- 可視化のためのダッシュボードを作成する
- 重要なメトリクスに対するアラートを定義する
出力
- メトリクス集約設定ファイル
- 統一命名規則のドキュメント
- 主要メトリクスのダッシュボード定義
- パフォーマンスしきい値のアラートルール
- メトリクスソースの統合ガイド
エラーハンドリング
メトリクス集約が失敗した場合:
- ソースへのネットワーク接続を確認する
- 認証資格情報を確認する
- メトリクス形式の互換性を検証する
- ストレージ容量と保持設定を確認する
- 集約ツールの設定を確認する
リソース
- Prometheus集約ドキュメント
- StatsDプロトコル仕様
- CloudWatchメトリクスAPIリファレンス
- メトリクス命名のベストプラクティス