# Usage Management

**Usage Management** is an Olly Settings screen that shows admins how their team is spending Olly AI units in the current billing cycle and lets them cap individual user consumption with a monthly limit. Use it to prevent any single user from depleting the team's shared quota and to even out usage across the team.

## What you need

- Olly turned on for your team. See [Enable Olly](https://coralogix.com/docs/user-guides/olly/enable/index.md).
- The [`OLLY-USAGE:MANAGE`](https://coralogix.com/docs/user-guides/aaa/access-control/permissions/permissions-list/index.md) permission. This gates both viewing the screen and changing limits — there is no separate read-only role.
- An Olly allocation in [Quota Rules](https://coralogix.com/docs/user-guides/account-management/payment-and-billing/quota-rules/index.md). Until you allocate units to the `olly` entity type, the **Total Usage** card has no allocation to show.

### Allocate units to Olly

In **Quota Rules**, the `olly` entity type starts as **Unallocated**. To give the Usage Management screen a quota to track:

1. Open **Data Flow**, then **Quota Rules**.
1. In **Allocations by entity type**, search for `olly`.
1. On the `olly` row, enter a value in the **Allocation** column (as **Percentages** or **Units**), then select **Allocate** in the **Status** column.
1. Select **Save**.

Once the rule is active, the Usage Management screen reads the allocation and shows progress against it. For the full Quota Rules workflow, see [Quota Rules](https://coralogix.com/docs/user-guides/account-management/payment-and-billing/quota-rules/index.md).

## Open Usage Management

In Coralogix, navigate to **Settings**, then under **Olly AI** select **Usage Management**.

The screen has two parts:

- **Total Usage** and **Team Overview** cards summarize team-wide consumption and what remains in the cycle.
- The **Users** tab lists every team member with their current usage, effective limit, and status.

## View team-wide Olly usage

The **Total Usage** card shows what percentage of the team's monthly Olly AI allocation the team has consumed and the date the allocation resets. Unused units do not roll over to the next cycle. To request a higher allocation, talk to your account manager or Coralogix Support.

The **Team Overview** card breaks down consumption in the current cycle:

- **Total spent**: All Olly AI units consumed by the team combined.
- **Users Usage**: Units consumed by individual users through chat, queries, and manual prompts.

## Set a per-user monthly limit

A per-user limit caps how many Olly AI units a team member can consume in the current billing cycle. When a user reaches their limit, they can't use Olly until the cycle resets.

To set a limit for one user:

1. On the **Users** tab, find the user row.
1. Select **Edit limit**.
1. In **New limit value (units)**, enter a value within the displayed range.
1. Select **Apply**.

The new limit takes effect immediately.

To set the same limit on several users at once:

1. On the **Users** tab, select the check box in each user row you want to update.
1. Select **Set usage limit**.
1. In **New limit value (units)**, enter a value within the displayed range.
1. Select **Apply**.

## Reset a user limit to the team default

Resetting clears a user's per-user override so they fall back to the team default limit. If the team has no default configured, the user is capped by the team's overall Olly allocation instead.

1. On the **Users** tab, open the more actions menu in the user's row.
1. Select **Reset to default limit**.

## Status badges

Each user row carries a status badge that reflects their position against the effective limit — the per-user limit when present, otherwise the team default, otherwise the team's overall Olly allocation.

| Badge         | Meaning                                                                                                                                                                                                                         |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| OK            | Usage is under 70% of the effective limit.                                                                                                                                                                                      |
| Approaching   | Usage has reached 70% of the effective limit but is still under the limit.                                                                                                                                                      |
| Limit reached | Usage has reached or exceeded the limit. The user can't use Olly until the next cycle. A user whose effective limit is **0** is locked out from the start of the cycle — raise their limit in **Edit limit** to restore access. |

Use the status filter in the table header to narrow the list to one or more statuses.

## Next steps

Learn how Olly processes and protects your data in [Data processing, privacy, and compliance](https://coralogix.com/docs/user-guides/olly/data-privacy/index.md).