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

500 error when iterating over a dataset

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

Bedrock Nova 2 inference-profile IAM and custom provider setup

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

BTQL summary queries fail with signBlob permission error

BTQL rate limits on Starter and Pro plans

Chart not visible after creation on monitoring page

Check data plane version in self-hosted deployments

Claude Code tracing not working after setup

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

Context length error caused by wrong AI provider routing

Controlling Concurrency to Prevent Resource Exhaustion

COUNT(DISTINCT) in GROUP BY returns row count

Creating permalinks to log events via API

Custom view code cannot use package imports

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

Failed to fetch full trace in data plane

GCS Brainstore rate limit errors and retries

GCP checksum mismatch errors after data plane upgrade to v1.1.32

Generate stable experiment permalinks

Grouping logs by field in UI requires SQL sandbox

How prompt version IDs work in Braintrust SDKs

HTTP 421 errors with self-hosted data planes

Human review assignee cannot see assigned experiments

Human review output format: string vs JSON

Internal Server Error: No Secrets Match ORG_NAME in

Kubernetes Readiness Probe Hangs on /status Endpoint

Large experiment downloads timeout in UI

loadPrompt caching behavior in TypeScript SDK

Log filtering with large user ID sets

Logger and experiment span parent type mismatch error

Logs not opening due to checksum instability

Logs stopped after Brainstore platform update

Loop models require Anthropic API key, not just Bedrock

Metadata filtering in custom views shows partial data

Missing classification values from automated scorer

Missing scorers in automation rules editor

Model cost missing when using third-party SDKs

Moderation AutoEval missing from automation rules scorer picker

Nested LLM call counting discrepancy

Null input on spans when using OTEL attributes

Online scorer deduplication with concurrent feedback

Online scorers not finding production traces

Online scoring results not visible in UI

Online scoring rule failing after SDK update

Org-wide API key auditing is UI-only

Playground timeout with long-running model requests

Populate project names in list prompts API

Project Disappeared or Inaccessible: Data Recovery and

Prompt diff feature has 4096 character limit

Prompt shows None in experiment view

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

Recovering deleted experiment rows with versioned BTQL queries

Rows not attached to a dataset or experiment

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:

SpanComponents encoding error when attaching feedback spans

SQL queries timeout when missing timestamp filter

SSO login fails with 'did not grant access' error

Subquery alias conflicts with column names

Tag filter dropdown missing tags from logged data

Temperature parameter error in prompt editor

Temperature parameter included in GPT-5 prompts from SDK

Temperature parameter not supported in GPT-5 models

Trace gaps when exported span context is not persisted across restarts

Tracing Anthropic models via LiteLLM with Braintrust

Transient JSONL.GZ files in S3 export bucket

Trial quota limits and monthly reset cycle

Troubleshooting Organization Changes in Self-Hosted Data

Troubleshooting Traces Stuck in Progress

Understanding Brainstore query optimization warning logs

TypeScript SDK eval process hangs after completion

Understanding traces vs spans in SQL & BTQL queries

wrapAISDK interleaved traces with concurrent calls

​
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.