mcpField
G
grafana-billing

grafana-billing

github.com/nodnarbnitramクラウド・DevOps1667 回インストール27 週間前に更新
リポジトリ

grafana-billing について

GrafanaのデータソースプロキシAPI経由でPrometheusとLokiの課金関連メトリクスを取得するClaudeスキルです。stagingとprodを照会し、コストや利用状況の分析に使えます。

主な機能

  1. 01Prometheusの課金メトリクスを取得
  2. 02Lokiの取り込み・ストレージ指標を取得
  3. 03stagingまたはprodを選択
  4. 04自動処理向けJSON出力
  5. 05環境ごとの利用状況を比較

活用シーン

  1. 01オブザーバビリティの利用量とコストを確認
  2. 02Prometheusの系列カーディナリティを分析
  3. 03Lokiの取り込み量とストレージを確認
  4. 04stagingとprodのメトリクスを比較

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nodnarbnitram/claude-code-extensions --skill grafana-billing

インストール後、Claude Code で/grafana-billingを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
billing-metrics.md
scripts/
billing_metrics.py
formatters.py
grafana_client.py
loki_metrics.py
prometheus_metrics.py

詳細

Grafana の課金メトリクススキル

Grafana のデータソースプロキシ API を通じて、Prometheus と Loki の主要な課金メトリクスをクエリします。

クイックスタート

# Query both staging and prod (default)
uv run .claude/skills/grafana-billing/scripts/billing_metrics.py

# Query specific environment
uv run .claude/skills/grafana-billing/scripts/billing_metrics.py --env staging
uv run .claude/skills/grafana-billing/scripts/billing_metrics.py --env prod

# JSON output for automation
uv run .claude/skills/grafana-billing/scripts/billing_metrics.py --json

# Filter to specific service
uv run .claude/skills/grafana-billing/scripts/billing_metrics.py --service prometheus
uv run .claude/skills/grafana-billing/scripts/billing_metrics.py --service loki

必須の環境変数

  • GRAFANA_STAGING_API_KEY - ステージング用 Grafana ワークスペースの API キー
  • GRAFANA_PROD_API_KEY - 本番用 Grafana ワークスペースの API キー

取得する主なメトリクス

Prometheus
メトリクス説明
アクティブな時系列現在のアクティブな系列数（課金対象の指標）
サンプル数/秒取り込みレート（DPM = サンプル数/秒 * 60）
TSDB ストレージディスク上のストレージ容量（バイト）
カーディナリティ上位系列数の多い上位 10 個のメトリクス
Loki
メトリクス説明
取り込みレート1 日あたりに取り込まれる GB 数
合計バイト数受信した累積バイト数
アクティブなストリームアクティブなログストリーム数
メモリチャンクメモリに保持されているチャンク数

使用する場面

ユーザーから次のような質問があった場合に、このスキルを使用します。

  • オブザーバビリティの課金やコスト
  • アクティブな時系列の数
  • Prometheus のカーディナリティ分析
  • Loki の取り込みレート
  • メトリクスやログのストレージ使用量
  • ステージングと本番の使用状況の比較

Claude への指示

  1. 課金メトリクスのスクリプトを実行して、現在のデータを収集します
  2. 結果を見やすく整形して提示します
  3. 注意が必要なメトリクス（高いカーディナリティ、急速な増加など）を強調します
  4. 両方の環境をクエリする場合は、ステージングと本番を比較します
  5. メトリクスが異常に高い場合は、コストの最適化を提案します

重要なルール

  • 実行する前に、API キーが設定されていることを必ず確認します
  • 出力をプログラムで処理する場合は、--json フラグを使用します
  • 比較のため、デフォルトでは両方の環境にクエリします
  • エラーは適切に処理し、データソースが見つからなくてもスクリプトをクラッシュさせないようにします

コメント

Markdown 対応