Version: Next 🚧

Grafana dashboard

The repository ships a sample Grafana dashboard at librechat-exporter-dashboard.json. Import it directly to get a comprehensive overview of your LibreChat metrics.

What's inside

User Activity — active users, user-provider distribution.
Key Metrics Overview — counts for users, messages, conversations, transactions.
Message & File Metrics — token usage, plugin usage, file sizes.
Session & Prompt Performance — average session duration, prompt-group generations.
Actions & Tools by Type — bar charts for action and prompt counts, tool-call usage.
Conversation & Transaction Insights — average messages per conversation, transaction-cost breakdown, token sums.

How to import

In Grafana: Dashboards → New → Import.
Upload librechat-exporter-dashboard.json or paste its contents.
Pick your Prometheus data source (the one configured to scrape the exporter — see Prometheus & Grafana setup).
Save.

Balance dashboard

A second, focused dashboard — librechat-balance-dashboard.json — visualizes user credit balances. Import it the same way as above.

It shows:

Balance records — number of users with a balance (librechat_balance_count).
Total outstanding credits and average credits per account — derived from librechat_balance_credits_by_email_domain.
Credits by email domain — outstanding balance grouped by domain (always-on).
Top users by credits — the largest balances, only populated when EMIT_PER_USER_METRICS=true.

All values are raw tokenCredits (1,000,000 tokenCredits = 1 USD).