> For the complete documentation index, see [llms.txt](https://docs.umbraco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.umbraco.com/ai-in-umbraco/17.latest/backoffice/usage-analytics.md).

# 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/X5yc7zOmdyMjYOQnEqMi)

### 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/58uO35jNfUqxO4fTQW4w)

## 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/17.latest/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/17.latest/backoffice/audit-logs.md) - Individual AI operation records
* [Analytics API](/ai-in-umbraco/17.latest/management-api/analytics.md) - Programmatic access


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.