I Built an Exporter and Grafana Dashboard for Claude Code

Xuexue — Thu, 12 Feb 2026 13:34:49 +0000

The Problem

I use Claude Code daily, but I had no idea where my tokens were going. How many tokens per model? Which tools get called the
most? How active are my sessions?

Claude Code stores usage data locally in ~/.claude, but it's raw JSON — not exactly easy to read.

So I built CC Exporter: a Prometheus exporter that reads Claude Code's local data and exposes it as metrics, with a
pre-built Grafana dashboard for visualization.

## Screenshots

## What It Tracks

Token usage by model — input, output, cache read, cache creation
Real-time active sessions — live token counts, session count, message count
Daily trends — messages, sessions, tool calls, tokens over time
Hourly activity — see when you're most active
Tool usage breakdown — which tools (Read, Write, Bash, etc.) you use most
Errors & retries — API errors, retries, context compaction events

## Quick Start

### Full Stack (One Command)

Deploy Exporter + Prometheus + Grafana with a pre-configured dashboard:


bash
  git clone https://github.com/aireet/cc-exporter.git
  cd cc-exporter
  ./start.sh

  Open http://localhost:3000/d/claude-token-monitor — login with admin / admin.
  ┌────────────┬───────────────────────────────┐
  │  Service   │              URL              │
  ├────────────┼───────────────────────────────┤
  │ Grafana    │ http://localhost:3000         │
  ├────────────┼───────────────────────────────┤
  │ Prometheus │ http://localhost:9099         │
  ├────────────┼───────────────────────────────┤
  │ Exporter   │ http://localhost:9101/metrics │
  └────────────┴───────────────────────────────┘
  Exporter Only (Docker Hub)

  Already have Prometheus and Grafana? Just run the exporter:

  docker run -d --name claude-exporter \
    -p 9101:9101 \
    -v ~/.claude:/data/claude:ro \
    -e CLAUDE_STATS_FILE=/data/claude/stats-cache.json \
    -e CLAUDE_DIR=/data/claude \
    xuexuexue1994/cc-exporter:latest

  Then add this to your Prometheus config:

  scrape_configs:
    - job_name: "claude-exporter"
      static_configs:
        - targets: ["localhost:9101"]

  And https://github.com/aireet/cc-exporter/blob/main/grafana/dashboards/claude-tokens.json into Grafana.

  Architecture

  ~/.claude (read-only)
      |
      +-- stats-cache.json ──→ ┌────────────┐   ┌────────────┐   ┌─────────┐
      +-- projects/*/?.jsonl → │  Exporter   │──→│ Prometheus │──→│ Grafana │
                                │ (Go, :9101) │   │  (:9099)   │   │ (:3000) │
                                └────────────┘   └────────────┘   └─────────┘

  - Exporter — Go binary that reads stats-cache.json (historical) + scans active JSONL files (real-time)
  - Prometheus — Scrapes every 30s, retains 90 days
  - Grafana — Pre-provisioned datasource and dashboard

  Data Safety

  - All Claude data is mounted as read-only
  - Everything stays on your machine — nothing is uploaded anywhere

  Links

  - GitHub: https://github.com/aireet/cc-exporter
  - Docker Hub: https://hub.docker.com/r/xuexuexue1994/cc-exporter
  - License: MIT

DEV Community: Xuexue

I Built an Exporter and Grafana Dashboard for Claude Code

The Problem