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

# Alerts

> Get notified when your AI usage crosses defined thresholds.

Alerts send you an email notification when a metric — cost, error rate, latency, or request volume — crosses a threshold you define. You configure each rule once, and Metrion checks it automatically after every proxied request.

## Notification levels

Each alert rule triggers at two levels:

* **Warning** — sent when your current value reaches **90%** of the threshold. This is an early signal to act before the limit is hit.
* **Alert** — sent when your current value reaches or exceeds **100%** of the threshold.

Notifications go to the email address associated with your Metrion account.

<Note>
  Metrion enforces a **24-hour cooldown** per rule. If a warning or alert email has already been sent for a rule, the same level will not send again until 24 hours have passed. This prevents repeated notifications during a sustained overrun.
</Note>

## Create an alert rule

<Steps>
  <Step title="Go to Alerts">
    Navigate to [metrion.dev/alerts](https://www.metrion.dev/alerts) in your dashboard.
  </Step>

  <Step title="Click 'New Alert'">
    Click the **New Alert** button in the top-right corner of the rules panel.
  </Step>

  <Step title="Choose a type">
    Select one of the four alert types: **Budget**, **Error Rate**, **Latency p95**, or **Request Volume**. See [Alert Types](/alerts/alert-types) for details on each.
  </Step>

  <Step title="Configure the rule">
    Fill in the rule fields:

    * **Name** (optional) — a label to identify the rule, such as "Prod API" or "Marketing bot".
    * **Threshold** — the value at which the alert fires, along with its unit (e.g. `50` in `USD`, or `5` in `%`).
    * **Providers** — scope the rule to all providers or to specific ones (Anthropic, OpenAI, Gemini, Mistral, Grok).
    * **Period** — the date range over which usage is measured. Budget alerts let you choose between the start of the current month, the moment the rule was created, or a custom date.
  </Step>

  <Step title="Save the rule">
    Click **Create alert**. The rule becomes active immediately.
  </Step>
</Steps>

## Test an alert rule

Click **Test** on any rule to send a real email to your account address immediately, regardless of current usage. Use this to confirm your email is receiving notifications before relying on the rule in production.

A test cooldown of 12 hours applies per rule after a test email is sent.

## Delete an alert rule

Click **Delete** next to a rule to remove it permanently. Deletion is immediate and cannot be undone.

## Plan limits

<Warning>
  The Free plan is limited to **1 alert rule**. Upgrade to Pro for unlimited rules.
</Warning>

| Plan | Alert rules |
| ---- | ----------- |
| Free | 1           |
| Pro  | Unlimited   |

On the Free plan, you can see the alerts section but it is locked behind an upgrade prompt. To create more than one rule, [upgrade to Pro](https://www.metrion.dev/pricing).