mcpField
G
grafana-billing

grafana-billing

github.com/nodnarbnitramCloud & DevOps1667 installsUpdated 27w ago
Repository

About grafana-billing

A Claude skill that runs a script to retrieve billing-related metrics for Prometheus and Loki through Grafana's data source proxy API. It can query staging and production and present the results for cost and usage analysis.

Key features

  1. 01Queries Prometheus billing metrics
  2. 02Queries Loki ingestion and storage metrics
  3. 03Selects staging or production
  4. 04Supports JSON output for automation
  5. 05Compares environment usage

Use cases

  1. 01Reviewing observability usage and costs
  2. 02Analyzing Prometheus series cardinality
  3. 03Checking Loki ingestion and storage
  4. 04Comparing staging and production metrics

Install

Copy the command and run it in a terminal.

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

After installing, type/grafana-billingin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

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

Details

From the project README

Grafana Billing Metrics Skill

Query key billing metrics from Prometheus and Loki through Grafana's data source proxy API.

Quick Start

# 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

Environment Variables Required

  • GRAFANA_STAGING_API_KEY - API key for staging Grafana workspace
  • GRAFANA_PROD_API_KEY - API key for prod Grafana workspace

Key Metrics Captured

Prometheus
MetricDescription
Active Time SeriesCurrent count of active series (billing dimension)
Samples/secIngestion rate (DPM = samples/sec * 60)
TSDB StorageOn-disk storage bytes
Top CardinalityTop 10 metrics by series count
Loki
MetricDescription
Ingestion RateGB/day being ingested
Total BytesCumulative bytes received
Active StreamsNumber of active log streams
Memory ChunksChunks held in memory

When to Use

Use this skill when the user asks about:

  • Observability billing or costs
  • Active time series counts
  • Prometheus cardinality analysis
  • Loki ingestion rates
  • Storage usage for metrics or logs
  • Comparing staging vs production usage

Instructions for Claude

  1. Run the billing metrics script to gather current data
  2. Present the results in a clear, formatted way
  3. Highlight any concerning metrics (high cardinality, rapid growth)
  4. Compare staging vs prod if both are queried
  5. Suggest cost optimization if metrics are unusually high

Critical Rules

  • Always check that API keys are set before running
  • Use --json flag when you need to process the output programmatically
  • Default to querying both environments for comparison
  • Handle errors gracefully - missing data sources should not crash the script

Comments

Markdown supported