Dashboard
Grafana Overview
Kostrack ships a pre-provisioned Grafana dashboard. docker compose up -d and it's ready — no manual datasource setup required.
Accessing Grafana
Open http://localhost:3000 and log in with admin / your GRAFANA_PASSWORD. The Kostrack — Overview dashboard loads as the home page.
Dashboard panels
| Panel | What it shows |
|---|---|
| Total Spend — Today | Running USD spend since midnight |
| Total Spend — This Week | Rolling 7-day spend |
| Total Spend — This Month | Month-to-date spend |
| Total API Calls | Call count for the selected date range |
| Avg Cost Per Call | Mean cost per call in the selected range |
| Cache Savings | Estimated savings from prompt cache hits |
| Spend Over Time | Hourly spend trend, split by provider |
| Spend by Provider | Donut chart — Anthropic vs OpenAI vs Gemini share |
| Spend by Model | Horizontal bar — which models cost the most |
| Token Usage by Model | Input / output / cached token breakdown per model |
| Recent Calls | Live table of last 100 calls with all fields |
Template variables
Use the Provider and Project dropdowns at the top of the dashboard to filter all panels simultaneously.
Time range
Use the Grafana time picker (top right) to switch between last 7 days (default), today, this month, or any custom range.
Alerting
Grafana's built-in alerting can fire to Slack, email, or PagerDuty when spend crosses a threshold. To set up a budget alert:
- Go to Alerting → Alert rules → New alert rule
- Query:
SELECT SUM(cost_usd) FROM llm_calls WHERE tags->>'project' = 'openmanagr' AND time > now() - interval '1 month' - Set your threshold (e.g. $50)
- Add a notification channel (Slack webhook, email, etc.)