Skip to Content
Launching the open-source gateway

Schedule usage reports

Send a recurring digest of usage, cost, and performance.

A usage report sends your team a digest of spans, errors, users, and cost by email or Slack on the days you choose. Each project has one report. For an alert the moment a metric crosses a threshold, use Monitors instead.

Turn the report on

Go to Settings › Reports and turn on Usage report is active. The schedule, metrics, and delivery settings appear below it.

The Reports settings page: the report is active on Mon to Fri at 09:00 AM, includes Spans, Errors, Users, Cost, and Pulse grouped by API key, Model, and Customer, and goes to an email address and a Slack channel

If your project has no report yet, opening this page turns one on for the project’s owners and admins, sent weekdays at 9:00 AM.

Set the schedule

Under Repeat on, select the days to send it, and set the Time. The label next to Time shows your time zone.

Each report covers the time since the previous one, up to 7 days, and compares it with the period before.

Choose the metrics

  • Include: pick Spans, Errors, Users, Cost, Tokens, or Latency. Pulse adds a short AI summary of the period’s top error issues, plus behavior counts if behaviors are on.
  • Group by: add a table of the top API key, Model, Customer, or Prompt values.
  • Show top: set how many rows each table shows, from 1 to 10.

Choose the recipients

Under Delivery, pick Email or Slack on the Send row, then an address or channel. Click + to add another recipient.

The preview below shows the digest with sample data. Click Send test message to send it now.

Changes save and take effect on their own, so there’s nothing to deploy. Click Activity to see who changed the report or turned it on or off.