# AI credit consumption

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/help/air/llms.txt).

The AI credit consumption analytics segment lets you track how AI consumers in your organization are spending AI credits.

> **Note:**
> Viewing this page requires a role with the [View AI analytics](roles.html#permissions_view_ai_analytics) or [Manage organization](roles.html#permissions_manage_org) permission.
>
>
>
> This page isn't available if View AI analytics (self) is the only permission that gives you access to AI analytics. To track your own spending, use the [AI credit consumption](ai-adoption-and-usage.html#ai-credit-consumption) chart on the [Adoption and usage](ai-adoption-and-usage.html) page.
>
>
>
> For information on how permissions impact the data you see in analytics charts and tables, see [Data visibility](ai-analytics.html#data-visibility).

## Sources of credit consumption data

The data in this analytics segment comes from a specific set of products, tools, and AI agents. For details about what the metrics do and don't include, see the following sections.

### Data included in the metrics

This analytics segment tracks spending information for the use of agents and models through the following products and tools:

* [AI Assistant](https://www.jetbrains.com/ai-assistant/) in JetBrains IDEs, either when using a supported agent or in Chat mode.

* [Air Gateway](cli-about.html), when using a supported agent wired through the CLI.

* [JetBrains Air](https://www.jetbrains.com/air), when using a supported agent in Air Teams.

The following AI agents are currently supported for data collection:

* [Junie](https://www.jetbrains.com/help/ai-assistant/junie-agent.html), an AI coding agent developed by JetBrains. Data is also collected when Junie is used through its dedicated tool window.

* [Claude Agent](https://www.jetbrains.com/help/ai-assistant/claude-agent.html), a third-party coding agent by [Anthropic](https://www.anthropic.com).

* [Codex](https://www.jetbrains.com/help/ai-assistant/codex-agent.html), a third-party coding agent by [OpenAI](https://www.openai.com).

* [Pi](https://pi.dev/), a minimal, open-source agent harness.

* [GitHub Copilot](https://www.jetbrains.com/help/ai-assistant/copilot-agent.html), a third-party coding agent by [GitHub](https://github.com).

> **Note:**
> Charts filtered by agent consolidate all usage of an agent across different tools into a single entry. For example, all Codex usage through Air Gateway, AI Assistant, and JetBrains Air is combined under the Codex entry.

The charts may also show data labeled as Uncategorized, which includes consumption of AI credits by new or less common tools that don't have a dedicated categorization.

> **Note:**
> For organizations that previously used the legacy licensing model with built-in and top-up AI credits, historical consumption data is summed up into AI credits, without a breakdown into the legacy AI credit types. For example, daily consumption of 127 built-in AI credits and 24 top-up AI credits for Claude Agent is now shown as 151 AI credits.

### Data excluded from the metrics

The metrics in this analytics segment exclude the following usage of products and tools as they don't consume AI credits:

* Using in-editor features such as [Next edit suggestions](https://www.jetbrains.com/help/ai-assistant/next-edit-suggestions.html) and [Code completion](https://www.jetbrains.com/help/ai-assistant/code-completion.html).

* Using models from a [centrally configured third-party AI provider](ai-providers.html). An organization administrator can configure connections to third-party AI providers and make models from the provider available to users in the organization. The use of such models is charged by the third-party provider directly and is not included in the metrics.

* Using models from [third-party AI providers configured locally in AI Assistant](https://www.jetbrains.com/help/ai-assistant/use-custom-models.html#provide-your-own-api-key). When you provide your own API key from a supported AI provider directly in AI Assistant, the usage is also charged directly by the third-party provider and doesn't consume AI credits. > **Note:** > An administrator can use AI policies to control whether you are allowed to connect models from third-party providers using your own API key in AI Assistant. For more details, see [Configuring policies](ai-policies-configure.html#ai-assistant).

* Using agents in AI Assistant with [provider accounts](https://www.jetbrains.com/help/ai-assistant/activate-agents.html#activate-agent-with-provider-account) or [provider-specific authentication methods](https://www.jetbrains.com/help/ai-assistant/activate-agents.html#activate-agent-with-provider-specific-method).

## AI credit consumption report

The AI credit consumption report table shows the number of AI credits used during the selected period. Use the tabs at the top of the page to switch between the following views:

* Principals: Breaks the data down by individual AI consumer, which is a [user](users.html) or a [service account](service-accounts.html). For details, see [Principals view](#principals-view).

* Groups: Breaks the data down by [group](groups.html), with the option to expand a group and see its subgroups. For details, see [Groups view](#groups-view).

In both views, the table can be filtered by the following criteria:

* In the time range filter, select one of the predefined filters that show the last specified period or select a custom date range. The data includes both the first and the last day of the selected period. > **Note:** > Time-based filtering uses Coordinated Universal Time (UTC), not the time in your local time zone.

* In the tool filter, which displays All tools by default, show only the data that originates from the selected tools. In addition to JetBrains IDEs, the dropdown includes the following tools: * [JetBrains Air](https://www.jetbrains.com/help/air/getting-started.html), the agentic development environment (ADE) by JetBrains. * [Air Gateway](cli-about.html), which is a local command-line proxy rather than a development environment. Select it to show the data that comes from the coding agents that it routes.

* In the agent filter, which displays All agents by default, show consumption data only for the selected AI agents. When no agent is selected, the table shows consumption for all agents, split by agent.

* The last filter depends on the selected view: * In the [Principals view](#principals-view), the principal filter displays All principals by default. Search for and select [users](users.html), [service accounts](service-accounts.html), or [groups](groups.html). Selecting a group includes all of its members and members of its subgroups. * In the [Groups view](#groups-view), the group filter displays All groups by default. Search for and select the [groups](groups.html) whose consumption you want to see.

Filters of different types are combined with a logical `AND`. For example, data will match both the selected date range and the user the data is attributed to.

Multiple selections of the same filter are combined with a logical `OR`. For example, selecting a group along with an individual user shows data for that user and all members of the group.

Filter selections are preserved across analytics segments. The filters that you set in one segment are automatically preselected when you switch to another segment.

To change how data is sorted, click the column header.

For more information on how to download data and the data format, see [Downloading data](ai-analytics.html#downloading-data).

### Principals view

The Principals view breaks the data down by AI consumer. An AI consumer is a [user](users.html) or a [service account](service-accounts.html) in your organization that spends AI credits through the use of AI. The table includes the following columns:

* AI consumer: The name of the user or service account.

* Credits used: The number of AI credits that the consumer used during the selected period.

* Consumption breakdown: A bar that shows how the consumer's spending is split between AI agents and tools. The colors of the bar segments match the legend above the table, and the length of the bar is relative to the highest consumption in the table.

#### Consumption details for a principal

To see more details about the spending of a specific consumer, click their row in the table. This opens a pane with the following information:

* The name of the user or service account. To email the user, for example, to ask about unexpected AI credit consumption, click Contact. For [user-created service accounts](service-accounts.html), the email is addressed to the user who created the service account. For system-created service accounts, the Contact button isn't available.

* Time period: The period that is currently selected in the time range filter.

* Credits: The total number of AI credits that the consumer spent during the selected period.

* Limit hit: The date when the consumer hit their [AI credit limit](ai-credit-limits.html) during the selected period.

* Consumption breakdown: The number of AI credits that the consumer used per AI agent or tool, sorted from the highest to the lowest consumption.

* Sessions with most AI credits used: The sessions that consumed the most AI credits during the selected period, with the start time and the number of AI credits used for each of them. To inspect sessions in more detail, click See more sessions, which takes you to [Session explorer](session-explorer.html).

> **Note:**
> The sum of AI credits used by the listed sessions may exceed the total AI credits consumed in the selected period. This is because each session shows its full cost, even if it started or ended outside the selected period.

![Consumption details of an AI consumer](images/ai-credits-consumption-principal-details.png)

### Groups view

The Groups view breaks the data down by [group](groups.html). This lets you compare AI credit consumption across teams instead of individual consumers. The table includes the following columns:

* Group: The name of the group. Expand a group to see its subgroups as nested rows.

* Credits used: The number of AI credits used during the selected period by the members of the group, including the members of its subgroups.

* Consumption breakdown: A bar that shows how the spending of the group is split between AI agents and tools. The colors of the bar segments match the legend above the table, and the length of the bar is relative to the highest consumption in the table.

#### Consumption details for a group

To see more details about the spending of a specific group, click its row in the table. This opens a pane with the following information:

* The name of the group.

* Time period: The period that is currently selected in the time range filter.

* Credits used: The total number of AI credits that the group used during the selected period.

* Consumption breakdown: The number of AI credits that the group used per AI agent or tool, sorted from the highest to the lowest consumption.

* Users: The users in the group and the number of AI credits that each of them spent during the selected period. To find a specific user in the list, type their name in the Search field.

![Consumption details of a group](images/ai-credits-consumption-group-details.png)

