Alerts watch a workspace and notify you when something needs attention. You set them up on the Alerts page of a workspace. Each alert runs on a schedule, and when it fires you get a notification in the app and an email.
Alert types
Alerts are grouped by category on the Alerts page.
| Alert | Category | What it checks | On by default | Setting |
|---|---|---|---|---|
| Error Rate Spike | Errors & Limits | The share of failed requests in the last 60 minutes. | No | Threshold (default 10%), and optionally only specific status codes |
| Low Balance | Spend | The account balance is below an amount. | Yes | Balance threshold (default $5) |
| Balance Depletion | Spend | At the average spend of the last 7 days, the balance lasts fewer than N days. | No | Days of balance left (default 7) |
| Dormant Key | API Keys | An active key has not been used for N days. Keys that have never been used count once they are older than N days. | No | Unused for (default 30 days) |
| Model Usage Report | Reports | Spend, requests and tokens by provider and model over the last 24 hours. | No | Schedule |
| Dashboard Snapshot | Reports | Spend, requests, error rate, and the top 5 models and keys over the last 24 hours. | No | Schedule |
| Model Deprecation | Models | A model your workspace used in the last 30 days is being retired. | No | Schedule |
| Model Price Change | Models | The input or output price of a model you use rose or fell by at least N%. | No | Minimum drop (default 5%) |
| New Model Release | Models | A model added to the catalog in the last few minutes. Each model is announced once per workspace. | No | Schedule (default every 5 minutes) |
New workspaces start with only Low Balance on. Every other alert is off until you turn it on.
Reports always send on their schedule. Threshold alerts send when their condition is met, and then wait for a cooldown before they can send again. Dormant Key and Model Deprecation send a weekly reminder while the condition holds. Low Balance, Balance Depletion and Model Price Change wait a day between notifications.
The Low Balance and Balance Depletion alerts check the balance of the workspace owner. Balance Depletion uses the spend of the last 7 days to estimate how long the balance will last.
Model Price Change compares each model's price with the price seen on its previous run. The first run only records prices, so the first notification can take one more day.
Schedules
Each alert has a schedule. By default it uses the alert's own default, shown next to Default on the dialog. To change it, pick Custom and set:
- Frequency: every minute up to weekly, for example daily or weekly.
- Day: for weekly alerts.
- Time and timezone: for daily and weekly alerts.
Error Rate Spike has a fixed schedule and cannot be changed.
Turning an alert on or off
Open an alert from the Alerts page. Use the Enabled switch to turn it on or off, then Apply, then Save changes. Changes apply to the next run.
Notifications
When an alert fires, Spro:
- Adds an entry to the notification bell in the app, with the alert's message and a link to the Alerts page.
- Sends an email to the recipients of the workspace. For a personal workspace that is the owner. For an organization workspace that is its admins.
Reports are sent by email titled with the report name and the workspace, with the report table in the body. Email is sent only when the workspace has email notifications turned on.
Every event is kept in the alert history, so you can see when an alert fired and what it reported.
