---
title: "Schedule usage reports"
subtitle: "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](/docs/documentation/features/monitoring/monitors) instead.

<Steps>
<Step title="Turn the report on">

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

<img src={"/docs/images/monitors/reports-light.png"} className="block dark:hidden" alt="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" />
<img src={"/docs/images/monitors/reports-dark.png"} className="hidden dark:block" alt="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.

</Step>
<Step title="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.

</Step>
<span data-docs-fragment-alias={"choose-the-contents"} aria-hidden="true" data-pagefind-ignore="" style={{ display: "block", height: 0, scrollMarginTop: "5rem" }} />

<Step title="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](/docs/documentation/features/pulse/behaviors) 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.

</Step>
<Step title="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.

</Step>
</Steps>

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.