> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modelstack.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics

> Monitor usage, request logs, and model breakdown from the analytics dashboard.

## Overview

The Analytics dashboard provides real-time visibility into your API usage. Track request volume, token consumption, model distribution, and error rates.

## Features

### Request Volume

View your API request count over time with configurable time ranges. Identify usage patterns and peak traffic periods.

### Token Usage

Monitor input and output token consumption across all models. Understand which requests are the most token-intensive.

### Model Breakdown

See a breakdown of requests by model. Understand which models your application uses most and optimize costs accordingly.

### Error Tracking

Track error rates and types (401, 402, 429, 500) to identify authentication issues, credit exhaustion, or rate limiting.

## Analytics Retention

Data retention depends on your plan:

| Plan | Retention Period |
| - | - |
| Starter | 7 days |
| Pro | 30 days |
| Max | 90 days |

## Data Export

<Note>
  Data export is available exclusively on the **Max** plan.
</Note>

Max plan subscribers can export their analytics data for external analysis and reporting.

## Using Analytics

### Optimize Model Selection

Use the model breakdown chart to identify expensive models. Consider switching to more cost-effective alternatives for appropriate use cases:

* Replace `claude-opus-4-1` ($15/$75 per 1M tokens) with `claude-sonnet-4-5` ($3/$15) for tasks that don't require maximum capability
* Use `gemini-2.5-flash` ($0.15/$0.60) or `gpt-4o-mini` ($0.15/$0.60) for simple, high-volume tasks

### Monitor Rate Limits

Watch your request volume against your plan's rate limit to avoid `429` errors:

| Plan | Rate Limit |
| - | - |
| Starter | 15 RPM |
| Pro | 40 RPM |
| Max | 60 RPM |

### Track Credit Consumption

Correlate your token usage with credit consumption to predict when you'll need additional lifetime credits.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.