# Usage Analytics

The Usage Analytics dashboard provides aggregated insights into AI operations, helping you understand usage patterns and performance.

## Accessing Analytics

1. Navigate to the **AI** section in the main navigation.
2. Click **Analytics** in the tree.

## Dashboard Overview

![The analytics dashboard showing usage metrics, success rate, and usage over time chart](/files/3cbszz5kai6D5Mo8zUrQ)

### Summary Metrics

The dashboard displays six summary cards at the top:

| Metric         | Description                                    |
| -------------- | ---------------------------------------------- |
| Total Requests | Number of AI operations in the selected period |
| Input Tokens   | Tokens sent to AI providers                    |
| Output Tokens  | Tokens received from AI providers              |
| Total Tokens   | Combined input and output tokens               |
| Success Rate   | Percentage of successful operations            |
| Avg Duration   | Average operation response time                |

### Usage Over Time

A chart showing usage trends across the selected period. The chart displays:

* **Bars** for input tokens and output tokens per time bucket
* **Line** for total request count

### Breakdowns

Tables showing usage distribution across four dimensions:

* **By Provider** — Which providers handle the most requests and tokens
* **By Model** — Which models are used most
* **By Profile** — Which profiles are most active
* **By User** — Which users generate the most AI operations

Each breakdown table shows Name, Requests, Tokens, and Share (percentage).

![Analytics breakdown tables by provider, model, profile, and user](/files/TwVxYI1fmqSqMy4tBVrq)

## Date Range

Select the time period to analyze using the picker in the top-right corner:

| Range         | Description          |
| ------------- | -------------------- |
| Last 24 Hours | Real-time monitoring |
| Last 7 Days   | Weekly trends        |
| Last 30 Days  | Monthly analysis     |

## Programmatic Access

For custom dashboards or integrations, use the [Analytics API](/ai-in-umbraco/management-api/analytics.md).

## Configuration

Configure analytics options in `appsettings.json`:

{% code title="appsettings.json" %}

```json
{
    "Umbraco": {
        "AI": {
            "Analytics": {
                "Enabled": true,
                "UsageHourlyRetentionDays": 30,
                "UsageDailyRetentionDays": 365,
                "IncludeUsageUserDimension": true,
                "IncludeUsageEntityTypeDimension": true,
                "IncludeUsageFeatureTypeDimension": true
            }
        }
    }
}
```

{% endcode %}

| Property                           | Default | Description                                                            |
| ---------------------------------- | ------- | ---------------------------------------------------------------------- |
| `Enabled`                          | `true`  | Whether usage analytics is enabled                                     |
| `UsageHourlyRetentionDays`         | `30`    | Retention period for hourly aggregated statistics (valid: 30-90)       |
| `UsageDailyRetentionDays`          | `365`   | Retention period for daily aggregated statistics                       |
| `IncludeUsageUserDimension`        | `true`  | Include user ID as a dimension in aggregations (privacy consideration) |
| `IncludeUsageEntityTypeDimension`  | `true`  | Include entity type (for example, `content`, `media`) as a dimension   |
| `IncludeUsageFeatureTypeDimension` | `true`  | Include feature type (for example, `prompt`, `agent`) as a dimension   |

## Related

* [Audit Logs](/ai-in-umbraco/backoffice/audit-logs.md) - Individual AI operation records
* [Analytics API](/ai-in-umbraco/management-api/analytics.md) - Programmatic access


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umbraco.com/ai-in-umbraco/backoffice/usage-analytics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.