Skip to main content
Find solutions to common errors, debug system issues, and resolve technical problems. Each guide includes step-by-step resolution steps based on real support cases.

​
All troubleshooting guides

Add tags to scorers using API instead of SDK

Add to dataset captures root span only

AI Proxy audio compression with x-bt-compress-audio

Alert aggregation not supported for error rates

API rate limits during backfill operations

API URL configuration conflicts in self-hosted deployments

Bedrock authorization errors with regional access

Bedrock model variations for on-demand throughput

Blank comparison rows due to mismatched inputs

Blank iframe requires console log inspection

Brainstore OOM errors and retry-induced rate limits

BTQL Filter Not Applied to All Results: Understanding traces vs spans in project_logs Queries

Check data plane version in self-hosted deployments

Claude Desktop MCP OAuth Failures

Claude Desktop MCP streaming connection failures

CloudFront 403 errors during evaluator invocation

Code scorer fails with pagination key error

Code scorer function must be named handler

Controlling Concurrency to Prevent Resource Exhaustion

COUNT(DISTINCT) in GROUP BY returns row count

Creating permalinks to log events via API

Dashboard logs missing due to span name schema error

Dataset search limited to 1000 records

Debug hanging eval processes with external dependencies

EMFILE Error (Too Many Open Files) During Evaluations: Controlling Concurrency to Prevent Resource Exhaustion

Empty traces with flush race conditions

Eval timeout errors for initial scorers

GCS Brainstore rate limit errors and retries

Generate stable experiment permalinks

Grouping logs by field in UI requires SQL sandbox

HTTP 421 errors with self-hosted data planes

Internal Server Error: No Secrets Match ORG_NAME in

Kubernetes Readiness Probe Hangs on /status Endpoint

Large experiment downloads timeout in UI

Log filtering with large user ID sets

Logs not opening due to checksum instability

Metadata filtering in custom views shows partial data

Missing scorers in automation rules editor

Nested LLM call counting discrepancy

Online scorer deduplication with concurrent feedback

Online scoring rule failing after SDK update

Playground timeout with long-running model requests

Populate project names in list prompts API

Project Disappeared or Inaccessible: Data Recovery and

PydanticAI integration counts wrapper spans as LLM calls

Query timeout requires timestamp filter

Rate limit error during dataset iteration

Re-running scorers without re-running tasks

Resolving import.meta.url undefined errors in Braintrust

Scorer overwriting human review data with identical names

Scores added via API not displaying in UI

SDK rate limits during dataset iteration

Search Timeout on Log Queries: CAST Operations in Custom

Securing remote eval endpoints: authentication and

Span Name Filtering Not Working on Monitoring Page:

SQL queries timeout when missing timestamp filter

Temperature parameter error in prompt editor

Temperature parameter included in GPT-5 prompts from SDK

Temperature parameter not supported in GPT-5 models

Trial quota limits and monthly reset cycle

Troubleshooting Organization Changes in Self-Hosted Data

Troubleshooting Traces Stuck in Progress

Understanding traces vs spans in SQL & BTQL queries

​
Need more help?

Can’t find what you’re looking for? Search across all documentation using the search bar above, or contact support at support@braintrust.dev.