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

# Topics automation can exhaust your monthly Topics credit quickly

export const plans_0 = "Starter"

export const deployments_0 = "Braintrust-hosted"

export const data_plane_version_0 = undefined

export const use_case_0 = "Use case - Evaluating Topics automation on a Starter plan when the monthly Topics credit is exhausted unexpectedly"

<Note>
  **Applies to:**

  * Plan - {plans_0}
  * Deployment - {deployments_0}
  * {data_plane_version_0}
  * {use_case_0}
</Note>

**Issue:** Enabling [Topics](/observe/topics) with default settings can consume the [monthly Topics credit](/plans-and-limits#topics-usage) quickly on high-volume projects, especially when using 100% sampling or applying Topics to existing traces.

**Cause:** Topics runs background analysis over matching traces. By default, the [automation uses 100% sampling](/observe/topics/manage#adjust-automation), so broad project traffic or historical backfills can use a large amount of Topics credit.

**Resolution:** Lower the Topics sampling rate, narrow the automation with filters, avoid unnecessary historical backfills, and [monitor Topics usage](/admin/billing/monitor-usage) separately from processed data usage.

## Resolution steps

### If Topics credit has not been exhausted

1. Lower the sampling rate
   Start with a low sampling rate, such as 1-5%, for high-volume projects. See [Adjust automation](/observe/topics/manage#adjust-automation).

2. Add filters
   Limit Topics to the workflows, environments, or trace patterns you actually want to evaluate. See [Adjust automation](/observe/topics/manage#adjust-automation) and [Match traces across spans](/observe/filter#match-traces-across-spans).

3. Avoid broad backfills
   When first testing Topics, consider applying it only to new traces instead of existing traces. See [Enable Topics](/observe/topics/enable).

4. Monitor usage
   Check [billing usage](/admin/billing/monitor-usage) for both Topics credit and processed data. These are separate limits.

### If Topics credit has already been exhausted

1. Pause Topics
   Stop the automation so new traces are not processed by Topics. See [Pause/resume automation](/observe/topics/manage#pause-resume-automation).

2. Reduce scope before resuming
   Lower sampling and add filters before turning Topics back on. See [Adjust automation](/observe/topics/manage#adjust-automation).

3. Wait for the next monthly cycle, add a card, or upgrade
   On Starter without on-demand usage, Topics pauses after the monthly credit is exhausted. [Add a card](/admin/billing/change-plan#enable-on-demand-usage) to resume at the overage rates, or see [What happens when I run out of Topics credit?](/admin/billing/faq#what-happens-when-i-run-out-of-topics-credit).

## Key limits to monitor

| Limit                                            | Notes                                      |
| ------------------------------------------------ | ------------------------------------------ |
| [Topics credit](/plans-and-limits#topics-usage)  | Used by Topics token processing            |
| [Processed data](/plans-and-limits#usage-limits) | Used by logged data, independent of Topics |

Pausing Topics prevents future Topics credit usage but does not restore credit already consumed.