Skip to main content
Track your Braintrust usage and costs throughout the billing period. All users can view usage on the Billing page, and Pro/Enterprise customers can access detailed reports in the Orb usage portal.

View usage

  1. Go to Settings.
  2. Under Organization, select Billing.
  3. Review usage charts for the current month or a custom date range (up to 100 days).
    • Daily and cumulative logs usage (GB)
    • Daily and cumulative scores usage
  4. For detailed usage analytics, click View usage. This opens the Orb portal, where you can:
    • View detailed breakdowns of trace spans, processed data, and scores
    • Download usage reports for internal tracking or accounting
    • Monitor costs and billing cycles
    • Compare usage across multiple billing periods

Understanding usage metrics

Your Braintrust usage is measured across two dimensions. Each contributes to your monthly costs if your usage grows beyond your plan’s included limits. See Plans and limits for included limits and on-demand usage rates by plan.

Processed data

Processed data refers to the total bytes of data ingested by Braintrust when you create logs or experiments. This includes:
  • Inputs and outputs
  • Prompts and completions
  • Metadata and tags
  • Traces and spans
  • Datasets
  • Attachments (images, audio, files)
  • Any other related information
How it’s measured: The cumulative size of all data (measured on disk) counts toward your monthly total, calculated from the first day to the last day of each calendar month.

Scores

Scores are used to measure the results of offline or online evaluations run in Braintrust. Each time you record a score, it counts toward your monthly usage. Examples of scored operations:
  • Offline evaluation scores from experiments
  • Online evaluation scores from production logs
  • Human review scores
  • Custom scorer outputs
How it’s counted: Each score recorded (whether automatic or manual) increments your monthly score count by one.

Set up spend alerts

Spend alerts are available for plans with on-demand usage (Starter and Pro).
Receive an email notification when your monthly on-demand charges reach a threshold in the current billing cycle. You can set up to three spending thresholds.
  1. Go to Settings.
  2. Under Organization, select Billing.
  3. Click Spend alerts.
  4. Set your spending thresholds.
  5. Click Save.
Spend alerts are informational-only and do not interrupt or limit your usage. You can update or disable alerts at any time.

Next steps