Skip to main content
Braintrust home page
Search...
⌘K
Ask AI
Request demo
Start building
Start building
Search...
Navigation
Troubleshooting guides
Docs
Integrations
Reference
Cookbook
Troubleshooting
Changelog
Overview
Troubleshooting guides
Config guides
Process & systems
Accessing log attachments in Python scorers
Add custom measures to monitoring charts
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
Attaching debuggers to Braintrust eval CLI
AWS Bedrock IAM permissions for Braintrust integration
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
BTQL POST endpoint payload and response schema
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
Configure custom model costs for estimation
Configure dataset schemas via API
Configure default groups for Google SSO users
Configure human review visibility in dataset views
Configure MCP server with self-hosted data plane
Configure root span filter for online scoring
Configure scorer pass threshold via API
Controlling Concurrency to Prevent Resource Exhaustion
COUNT(DISTINCT) in GROUP BY returns row count
Create monitoring dashboards with organization permissions
Creating permalinks to log events via API
Customizing Monitoring Views: Removing Charts and Managing View Layouts
Dashboard logs missing due to span name schema error
Dataset format for system and user prompts
Dataset search limited to 1000 records
Debug hanging eval processes with external dependencies
Defining response schema in prompts.create()
Detect CLI vs remote eval execution context
Detecting Remote Eval and CLI Execution Context: SDK Hooks and Environment Variables
EMFILE Error (Too Many Open Files) During Evaluations: Controlling Concurrency to Prevent Resource Exhaustion
Emit traces to multiple projects simultaneously
Empty traces with flush race conditions
Eval timeout errors for initial scorers
Experiment Fetch Limited to 1000 Events - Export All
Export all experiment events using BTQL pagination
Fetching human review comments via API and BTQL
Filter logs by tags and scores with ANY_SPAN
Flagging logs and users for review via API
Flagging users for review via API
GCS Brainstore rate limit errors and retries
Generate stable experiment permalinks
Grouping logs by field in UI requires SQL sandbox
How to duplicate views across projects
How to Save Custom Instructions for Loop Using Project
HTTP 421 errors with self-hosted data planes
Human review visibility in experiment row view
Human review with multiple scores in expected field
Internal Server Error: No Secrets Match ORG_NAME in
Java SDK proxy configuration with authentication
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
Loop security model and user permissions
Managing Prompt Updates in Production: Environment Tags
Managing your organization's support requests
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
Optimize large trace logging with attachments
Override custom providers at project level
Permission group not working: Project-level scorer access
Playground timeout with long-running model requests
Populate project names in list prompts API
Project Disappeared or Inaccessible: Data Recovery and
Project permission levels and user access control
Project-scoped access with service tokens
PydanticAI integration counts wrapper spans as LLM calls
Python SDK Docker containerization setup
Query multiple projects for combined metrics
Query timeout requires timestamp filter
Rate limit error during dataset iteration
Re-running scorers without re-running tasks
Removing charts from the default "All Data" view
Resolving import.meta.url undefined errors in Braintrust
Restrict AI provider access using project permissions
Restrict user access to specific projects only
Route requests to specific AI providers
Running Evaluations Per Git Commit: SHA-Based Experiment
S3 export missing child spans
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
Slack alert permissions in project settings
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
Thread view span extraction and filtering
Tracing OpenAI Realtime API with WebSockets
Trial quota limits and monthly reset cycle
Troubleshooting 500 errors in self-hosted data planes
Troubleshooting Organization Changes in Self-Hosted Data
Troubleshooting Traces Stuck in Progress
Understanding Experiment Score Aggregation: Simple vs
Understanding traces vs spans in SQL & BTQL queries
Understanding Update Project ACLs
Update AWS Bedrock credentials using API
User Engagement Tracking
On this page
All troubleshooting guides
Need more help?
Troubleshooting guides
Copy page
Resolve errors, debug issues, and fix common problems
Copy page
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
.
Was this page helpful?
Yes
No
Knowledge Base
Previous
Config guides
Next
⌘I
Assistant
Responses are generated using AI and may contain mistakes.
Contact support