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

# Feature availability

> Find the minimum data plane version each feature needs and which features each cloud supports in a self-hosted Braintrust deployment.

> [!NOTE]
>
> These guides support organizations that already operate a self-hosted data plane. For new organizations looking to keep data in your own cloud, see [Bring your own cloud (BYOC)](https://docs.braintrust.dev/admin/deployment/byoc.md).

Features that depend on the data plane are available on a self-hosted deployment only after you upgrade to the version that ships them, and some features depend on your cloud. This page lists the minimum data plane version for each feature and the features each cloud supports. For what each version contains, including the Terraform module and Helm chart versions that ship it, see [Self-hosting releases](https://docs.braintrust.dev/data-plane-changelog). To upgrade, see [Upgrade your deployment](https://docs.braintrust.dev/admin/self-hosting/upgrade/routine).

## Version requirements

Features not listed here work on every supported data plane version.

### Observe

| Feature | Minimum data plane version |
| :- | :- |
| [Slack notifications for alerts](https://docs.braintrust.dev/observe/alerts.md) | v1.1.29 |
| [Trace-level filters in charts](https://docs.braintrust.dev/observe/dashboards/build-charts.md) | v2.0.0 |
| [Log indexing and full-text search](https://docs.braintrust.dev/reference/sql/query-structure.md#full-text-search) | v2.1.0 |
| [SQL charts](https://docs.braintrust.dev/observe/dashboards/sql-charts.md) | v2.1.1 |
| [Metric columnstore](https://docs.braintrust.dev/reference/sql/best-practices.md) and [shingled search optimization](https://docs.braintrust.dev/admin/projects.md#speed-up-log-filtering) | v2.2.1 |
| **Target time interval** for time series charts on [dashboards](https://docs.braintrust.dev/observe/dashboards.md) | v2.2.1 |
| [Time window alerts](https://docs.braintrust.dev/observe/alerts.md) | v2.10.0 |
| [Pause and resume alerts](https://docs.braintrust.dev/observe/alerts.md#pause-an-alert) | v2.11.0 |
| [Faster log search](https://docs.braintrust.dev/observe/filter.md) | v2.13.0 |
| [Dashboard sections](https://docs.braintrust.dev/observe/dashboards/build-charts.md#organize-charts-into-sections) | v2.13.0 |
| [Coding agent insights](https://docs.braintrust.dev/observe/dashboards/coding-agent-insights.md) | v2.13.0 |
| [Dashboard notes](https://docs.braintrust.dev/observe/dashboards/build-charts.md#add-notes) | v2.16.0 |
| [PagerDuty notifications](https://docs.braintrust.dev/observe/alerts.md) for alerts and Loop automations | v2.17.0 |
| [Donut display for SQL chart top lists](https://docs.braintrust.dev/observe/dashboards/sql-charts.md#donut-charts) | v2.18.0 |
| [Y axis controls for time series charts](https://docs.braintrust.dev/observe/dashboards/build-charts.md#chart-editor-options) | v2.22.0 |

### Evaluate

| Feature | Minimum data plane version | Notes |
| :- | :- | :- |
| [Pass/fail thresholds for scorers](https://docs.braintrust.dev/evaluate/custom-code.md#set-pass-thresholds) | v1.1.28 | |
| [MCP servers in prompts](https://docs.braintrust.dev/evaluate/prompts/create.md#add-mcp-servers) | v1.1.28 | |
| [Trace-level scorers](https://docs.braintrust.dev/evaluate/custom-code.md#score-traces) | v2.0.0 | |
| [Trace scope for online scoring](https://docs.braintrust.dev/evaluate/score-online.md#configuration-parameters) | v2.0.0 | On earlier versions, use span scope with the **All root spans** filter to score each trace's root span. |
| [Evaluation parameters](https://docs.braintrust.dev/evaluate/write-parameters.md) | v2.0.0 | |
| [Classifiers](https://docs.braintrust.dev/evaluate/write-scorers.md#classifiers) | v2.0.0 | |
| [Sandboxes for agent evals](https://docs.braintrust.dev/evaluate/remote-evals.md) | v2.0.0 | |
| [UI experiments](https://docs.braintrust.dev/evaluate/run-in-ui.md) without a time limit | v2.0.0 | |
| [Dataset filters for experiments](https://docs.braintrust.dev/evaluate/run-in-ui.md#create-from-scratch) | v2.2.1 | |
| [`{{thread_with_system}}`](https://docs.braintrust.dev/evaluate/llm-as-a-judge#score-traces) variable in trace-level scorers and prompts | v2.3.0 | |
| [Rewind online scoring automations](https://docs.braintrust.dev/evaluate/score-online.md#rewind-an-automation) | v2.3.0 | |
| [Per-scorer retries in online scoring](https://docs.braintrust.dev/evaluate/score-online.md#retries-and-failure-handling) | v2.4.0 | |
| [Batch-level retries in online scoring](https://docs.braintrust.dev/evaluate/score-online.md#retries-and-failure-handling) | v2.5.0 | |
| [Skip non-applicable cases](https://docs.braintrust.dev/evaluate/llm-as-a-judge.md#skip-non-applicable-cases) in LLM-as-a-judge scorers | v2.7.0 | |
| [Group scope for online scoring](https://docs.braintrust.dev/evaluate/score-online.md#configuration-parameters) | v2.8.0 | |
| [Preprocessors](https://docs.braintrust.dev/evaluate/llm-as-a-judge.md#choose-a-preprocessor) for LLM-as-a-judge scorers, and project [preprocessor settings](https://docs.braintrust.dev/admin/projects.md#manage-preprocessors) | v2.10.0 | |
| [Pause and resume online scoring](https://docs.braintrust.dev/evaluate/score-online.md#pause-an-automation) | v2.11.0 | |
| [Apply scorers to experiments](https://docs.braintrust.dev/evaluate/interpret-results.md#apply-scorers-to-all-traces) | v2.16.0 | |
| [Node.js 24 code functions and scorers](https://docs.braintrust.dev/evaluate/remote-evals.md) | v2.16.0 | |
| [Python 3.14 code functions and scorers](https://docs.braintrust.dev/evaluate/remote-evals.md#2-register-your-sandbox) | v2.18.0 | AWS only. On GCP and Azure, scorers run on the API container's Python version. See [Code execution isolation](https://docs.braintrust.dev/admin/self-hosting/configure/security#code-execution-isolation). |
| [Saved project MCP credentials in prompts](https://docs.braintrust.dev/evaluate/prompts/create.md#add-to-a-project) | v2.20.0 | |
| [Online scoring rule activity](https://docs.braintrust.dev/evaluate/score-online.md#monitor-rule-activity) | v2.22.0 | |
| `span_attributes.scorer_id` on [scorer spans](https://docs.braintrust.dev/evaluate/score-online.md#monitor-rule-activity) | v2.22.0 | |
| [Decisions API judges](https://docs.braintrust.dev/evaluate/llm-as-a-judge.md#judge-with-a-decisions-api), including [custom models](https://docs.braintrust.dev/integrations/ai-providers/custom.md#configuration-options) with the `decisions` flavor | v2.22.0 | Requires a [self-hosted Braintrust Gateway](https://docs.braintrust.dev/admin/self-hosting/configure/gateway#deploy-and-enable-the-gateway) that routes API traffic. AWS Terraform module v7.0.0 and later enables it by default. On Helm, set `aiGateway.enabled` and `aiGateway.useGateway` to `true`. |

### Datasets

| Feature | Minimum data plane version |
| :- | :- |
| [Dataset environments](https://docs.braintrust.dev/deploy/environments.md) | v2.1.0 |

### Loop

Loop features also require the [Loop runtime](https://docs.braintrust.dev/admin/self-hosting/configure/loop-runtime). See [Feature support by cloud](#feature-support-by-cloud).

| Feature | Minimum data plane version | Notes |
| :- | :- | :- |
| [Loop across your whole project](https://docs.braintrust.dev/loop.md) | v2.9.0 | |
| [Loop automations](https://docs.braintrust.dev/loop/automations.md) | v2.12.0 | |
| [Debugger](https://docs.braintrust.dev/loop.md#analyze-traces) | v2.12.0 | |
| [Loop thread sharing](https://docs.braintrust.dev/loop/manage.md#share-a-thread) | v2.15.0 | |
| [External MCP servers in Loop](https://docs.braintrust.dev/loop/mcp.md) | v2.17.0 | On AWS, requires Terraform module v6.9.0 or later. On GCP, requires the Loop runtime (GCP Terraform module v2.0.0 or later with Helm chart 6.28.0 or later). |
| [GitHub repositories in Loop](https://docs.braintrust.dev/loop/github.md) (read access) | v2.18.0 | On AWS, requires Terraform module v6.10.0 or later for the [sandbox egress gateway](https://docs.braintrust.dev/admin/self-hosting/configure/loop-runtime#sandbox-egress). On GCP, requires GCP Terraform module v2.0.0 or later with Helm chart 6.28.0 or later. |
| [Curate datasets with Loop](https://docs.braintrust.dev/loop.md#curate-datasets) | v2.18.0 | |
| [Databricks GPT models for Loop](https://docs.braintrust.dev/loop/manage.md#models-and-providers) | v2.19.0 | Also required for Loop to use provider model IDs unchanged, such as Bedrock cross-region IDs. |
| [Continuous Loop automations](https://docs.braintrust.dev/loop/automations.md) | v2.20.0 | |
| [Loop in Slack](https://docs.braintrust.dev/loop/slack) | v2.21.0 | |
| [GitHub write access in Loop](https://docs.braintrust.dev/loop/github.md#give-loop-write-access) | v2.21.0 | On AWS, requires Terraform module v7.1.0 or later. |
| [Organization picker in Loop in Slack](https://docs.braintrust.dev/loop/slack#move-a-thread-to-another-organization) | v2.22.0 | Private preview. Ships with AWS Terraform module v7.2.0. |
| [Approved organization switches in Loop in Slack](https://docs.braintrust.dev/loop/slack#move-a-thread-to-another-organization) | v2.23.0 | Private preview. Ships with Helm chart 6.31.0. AWS Terraform module v7.3.0 is not yet released. |
| [Channel default projects in Loop in Slack](https://docs.braintrust.dev/loop/slack#set-channel-defaults) | v2.23.0 | Private preview. Ships with Helm chart 6.31.0. AWS Terraform module v7.3.0 is not yet released. |
| [Digests](https://docs.braintrust.dev/loop/automations.md#create-a-digest) | v2.23.0 | Ships with Helm chart 6.31.0. |
| [File attachments in Loop in Slack](https://docs.braintrust.dev/loop/slack#attach-files) | v2.24.0 (not yet released) | Private preview. Assumes inclusion in the next data plane release. |

### Topics and Patterns

[Patterns](https://docs.braintrust.dev/observe/patterns.md) also requires the [Loop runtime](https://docs.braintrust.dev/admin/self-hosting/configure/loop-runtime). [Topics](https://docs.braintrust.dev/observe/topics.md) requires [built-in models](https://docs.braintrust.dev/admin/ai-providers.md#manage-built-in-models), which are off by default on self-hosted deployments. See [Enable Topics](https://docs.braintrust.dev/admin/self-hosting/upgrade/v2#enable-topics).

| Feature | Minimum data plane version |
| :- | :- |
| [Topics](https://docs.braintrust.dev/observe/topics.md) | v2.0.0 |
| [Topic trends on dashboards](https://docs.braintrust.dev/observe/topics/review-insights.md#track-trends-over-time) | v2.0.0 |
| [Topics for sessions and multi-turn conversations](https://docs.braintrust.dev/observe/topics/manage.md#group-traces-into-conversations) | v2.2.1 |
| [Pause and resume the Topics automation](https://docs.braintrust.dev/observe/topics/manage.md#pause-resume-automation) | v2.2.1 |
| [Patterns](https://docs.braintrust.dev/observe/patterns/enable.md) | v2.13.0 |
| [Pattern frequency](https://docs.braintrust.dev/observe/patterns/review.md#examine-a-pattern) | v2.15.0 |
| Pattern sorting by day and frequency | v2.16.0 |
| [Pattern severity](https://docs.braintrust.dev/observe/patterns/review.md#severity) and [categories](https://docs.braintrust.dev/observe/patterns/review.md#categories) | v2.18.0 |
| Duplicate pattern consolidation | v2.18.0 |
| [Pattern sources](https://docs.braintrust.dev/observe/patterns/review.md#sources) | v2.19.0 |
| Pattern **Last seen** time | v2.19.0 |
| Background computation of [**Affected traces**](https://docs.braintrust.dev/observe/patterns/review.md#assess-how-widespread-it-is) and **Last seen** | v2.21.0 |
| Loop changes to [corrected severity and categories](https://docs.braintrust.dev/observe/patterns/review.md#correct-severity-and-categories) | v2.21.0 |
| [Pattern discovery](https://docs.braintrust.dev/observe/patterns/review.md#verification) of problems users notice, and rate-jump reports in scheduled runs | v2.22.0 |
| [Project pattern alert destinations](https://docs.braintrust.dev/observe/patterns/enable.md#configure-alert-destinations) | v2.23.0 |
| [**User ID field**](https://docs.braintrust.dev/observe/patterns/configure.md#configure-impact-measurement) in project settings | v2.23.0 |
| [Pattern alert severity](https://docs.braintrust.dev/observe/patterns/enable.md#choose-alert-severities) and **Severity raised** alerts | v2.24.0 |

Project pattern alert destinations ship with Helm chart 6.31.0.

### SQL

| Feature | Minimum data plane version | Notes |
| :- | :- | :- |
| [SQL syntax](https://docs.braintrust.dev/reference/sql.md) | v1.1.29 | |
| [Single span filters with aggregations](https://docs.braintrust.dev/reference/sql/examples.md#analyze-traces-with-span-filters) | v1.1.31 | |
| [`LIMIT` with aggregations](https://docs.braintrust.dev/reference/sql/query-structure#limit) | v2.0.0 | |
| One level of nesting in [`ANY_SPAN()`](https://docs.braintrust.dev/reference/sql/query-structure#matching-spans-filters) | v2.0.0 | |
| [`estimated_cost()`](https://docs.braintrust.dev/reference/sql/functions#sql-functions) | v2.0.0 | |
| [Subqueries](https://docs.braintrust.dev/reference/sql/query-structure.md#subqueries) | v2.1.0 | |
| [`TABLESAMPLE`](https://docs.braintrust.dev/reference/sql/query-structure#sample) | v2.1.0 | |
| [`estimated_cost_breakdown()` and `estimated_cost_component()`](https://docs.braintrust.dev/reference/sql/functions#sql-functions) | v2.1.0 | |
| [`ROLLUP` and `GROUPING SETS`](https://docs.braintrust.dev/reference/sql/query-structure#rollup-and-grouping-sets) | v2.1.1 | |
| [`substring()`](https://docs.braintrust.dev/reference/sql/functions#sql-functions) | v2.1.1 | |
| [`IF` and `COUNT_IF`](https://docs.braintrust.dev/reference/sql/functions#conditional-expressions) | v2.2.1 | |
| [`SETTINGS` clause](https://docs.braintrust.dev/reference/sql/query-structure#settings) | v2.2.1 | |
| Multi-unit intervals in [`date_trunc()`](https://docs.braintrust.dev/reference/sql/functions#sql-functions), such as `'15 minutes'` | v2.2.1 | |
| [Async queries](https://docs.braintrust.dev/api-reference/query.md#async-queries) | v2.3.0 | See [Async query limits](https://docs.braintrust.dev/admin/self-hosting/configure/scaling#async-query-limits) for the Terraform and Helm requirements. |
| [Query data sources by name](https://docs.braintrust.dev/reference/sql/query-structure.md#data-sources) | v2.7.0 | |
| `created_by_user_id` and `created_by_api_key_id` [span attribution](https://docs.braintrust.dev/instrument/advanced-tracing.md#underlying-format) | v2.8.0 | |
| [`SELECT DISTINCT`](https://docs.braintrust.dev/reference/sql/query-structure#select-distinct) | v2.15.0 | |
| Columnar aggregation when grouping by three or more keys | v2.16.0 | |
| [Fetch known traces or spans by ID](https://docs.braintrust.dev/reference/sql/best-practices.md#fetch-known-traces-or-spans-by-id) | v2.18.0 | |
| [`is_uuid()`](https://docs.braintrust.dev/reference/sql/functions#string-functions) | v2.19.0 | |
| `NULLS LAST` in [`ORDER BY`](https://docs.braintrust.dev/reference/sql/query-structure#order-by) | v2.19.0 | |
| [Null checks on JSON fields](https://docs.braintrust.dev/reference/sql/filtering.md#null-checks-on-json-fields) | v2.21.0 | |
| [String](https://docs.braintrust.dev/reference/sql/functions.md#string-functions), [regular expression](https://docs.braintrust.dev/reference/sql/functions.md#regular-expression-functions), [numeric](https://docs.braintrust.dev/reference/sql/functions.md#numeric-functions), and [date part](https://docs.braintrust.dev/reference/sql/functions.md#date-and-time-functions) functions added in v2.22.0, such as `split_part`, `strpos`, and `regexp_replace` | v2.22.0 | |
| [Null checks](https://docs.braintrust.dev/reference/sql/filtering.md#null-checks-on-json-fields) on a path through an array, such as `input.messages.role IS NOT NULL` | v2.22.0 | |
| [Cursor pagination](https://docs.braintrust.dev/reference/sql/query-structure.md#cursors-for-pagination) when sorting by `created` | v2.22.0 | |
| [JSON](https://docs.braintrust.dev/reference/sql/functions.md#json-functions), [string](https://docs.braintrust.dev/reference/sql/functions.md#string-functions), [array](https://docs.braintrust.dev/reference/sql/functions.md#array-functions), [regular expression](https://docs.braintrust.dev/reference/sql/functions.md#regular-expression-functions), [search](https://docs.braintrust.dev/reference/sql/functions.md#search-functions), and [aggregate](https://docs.braintrust.dev/reference/sql/functions.md#aggregate-functions) compatibility functions | v2.24.0 | |

### Admin and security

| Feature | Minimum data plane version | Notes |
| :- | :- | :- |
| [Image rendering controls](https://docs.braintrust.dev/admin/organizations.md#control-image-rendering) | v1.1.31 | |
| [Rewind, start-from date, and Google Cloud Storage destinations](https://docs.braintrust.dev/admin/data-management/export.md#rewind-to-a-specific-date) for data export | v2.1.0 | Export must also be enabled in your deployment. See [Enable export permissions](https://docs.braintrust.dev/admin/self-hosting/deploy#enable-export-permissions) for AWS and [Export to Google Cloud Storage](https://docs.braintrust.dev/admin/self-hosting/deploy#export-to-google-cloud-storage) for GCP. |
| **Create direct ownership grants** toggle for [permission groups](https://docs.braintrust.dev/admin/access-control.md) | v2.2.0 | |
| Server-side enforcement of the **Diff** setting for [git metadata](https://docs.braintrust.dev/admin/organizations.md#set-git-metadata-logging) | v2.2.0 | |
| [Secret previews and rotation tracking](https://docs.braintrust.dev/admin/ai-providers.md) | v2.2.1 | |
| [Audit logging](https://docs.braintrust.dev/admin/audit-logs.md) | v2.6.0 | On earlier versions, administrative events are recorded but aren't queryable. |
| Organization-level [data retention](https://docs.braintrust.dev/admin/data-management/retention.md) | v2.9.0 | |
| [Usage analytics by project](https://docs.braintrust.dev/admin/billing/monitor-usage.md#view-usage) | v2.13.0 | |
| [Redact during ingestion](https://docs.braintrust.dev/admin/data-management/protect-sensitive-data.md#redact-during-ingestion) | v2.17.0 | |
| [Audit logs for async queries and applied scorers](https://docs.braintrust.dev/admin/audit-logs.md#async-queries-and-applied-scorers) | v2.18.0 | |
| [List organization API keys](https://docs.braintrust.dev/admin/organizations.md#list-api-keys) with `GET /v1/organization/api_keys` | v2.18.0 | |
| [Query text in read audit logs](https://docs.braintrust.dev/admin/audit-logs.md#recorded-queries) | v2.20.0 | On earlier versions, SQL queries are recorded as `<Failed to parse query>`, and some string values aren't masked. |
| [Hide fields when read](https://docs.braintrust.dev/admin/data-management/protect-sensitive-data.md#hide-fields-when-read) | v2.21.0 | |
| **Values to never redact**, and custom columns that read hidden fields, in [protected fields](https://docs.braintrust.dev/admin/data-management/protect-sensitive-data.md) | v2.22.0 | On earlier versions, a query with a custom column that reads a hidden field is rejected. |
| [Read audit logs enabled by default](https://docs.braintrust.dev/admin/self-hosting/configure/security#enable-read-auditing) | v2.23.0 | Requires an Enterprise plan. Organization owners can turn read auditing off or on in the audit log settings. |

### Integrations and MCP

| Feature | Minimum data plane version | Notes |
| :- | :- | :- |
| **OpenAI** format for [Bedrock](https://docs.braintrust.dev/integrations/ai-providers/bedrock.md#connect-bedrock-to-braintrust) models | v2.2.1 | |
| [Bedrock](https://docs.braintrust.dev/integrations/ai-providers/bedrock.md#connect-bedrock-to-braintrust) custom models in the OpenAI format | v2.2.1 | |
| Automatic attachment extraction for inline base64 content in [Bedrock](https://docs.braintrust.dev/integrations/ai-providers/bedrock.md) Converse requests | v2.2.1 | |
| Responses endpoint routing for `openai.gpt-5.3` and later on [Bedrock](https://docs.braintrust.dev/integrations/ai-providers/bedrock.md#connect-bedrock-to-braintrust) | v2.7.0 | |
| [OTLP logs endpoint](https://docs.braintrust.dev/instrument/application-logs.md) | v2.12.0 | |
| [Application logs](https://docs.braintrust.dev/instrument/application-logs.md) log-row format and span-event ingestion | v2.14.0 | Ships with AWS Terraform module v6.8.0 and Helm chart 6.18.0. |
| [TypeSafe Jev](https://docs.braintrust.dev/integrations/ai-providers/typesafe.md) with your own TypeSafe key | v2.15.0 | On v2.22.0 and later, requires a [self-hosted Braintrust Gateway](https://docs.braintrust.dev/admin/self-hosting/configure/gateway#deploy-and-enable-the-gateway), like [Decisions API judges](https://docs.braintrust.dev/evaluate/llm-as-a-judge.md#judge-with-a-decisions-api). |
| **Selected models** restriction for project-level [AI providers](https://docs.braintrust.dev/admin/ai-providers.md#restrict-available-models) | v2.15.0 | On earlier versions, project providers support **All models**, **None**, and custom models. |
| Organization provider fallback when a [project provider](https://docs.braintrust.dev/admin/ai-providers.md#project-providers) doesn't support the requested model | v2.15.0 | On earlier versions, a project provider with the same name overrides the organization provider even when it doesn't support the model, so the request fails. |
| Numeric severity mapping and exception-only `error` level for [OpenTelemetry log levels](https://docs.braintrust.dev/integrations/sdk-integrations/opentelemetry/attributes.md#log-levels-and-exceptions) | v2.15.0 | |
| Severity-text fallback and span-event log-level inference for [OpenTelemetry log levels](https://docs.braintrust.dev/integrations/sdk-integrations/opentelemetry/attributes.md#log-levels-and-exceptions) | v2.16.0 | |
| [OpenInference attribute mapping](https://docs.braintrust.dev/integrations/sdk-integrations/opentelemetry/attributes.md#openinference-attributes) | v2.16.0 | |
| [OpenInference score validation](https://docs.braintrust.dev/integrations/sdk-integrations/opentelemetry/attributes.md#scores) | v2.16.0 | |
| [Claude Code OpenTelemetry mapping](https://docs.braintrust.dev/integrations/developer-tools/claude-code.md#trace-with-opentelemetry) | v2.16.0 | |
| [Copy logs into datasets with MCP](https://docs.braintrust.dev/integrations/developer-tools/mcp.md#run-evals-and-edit-datasets) | v2.18.0 | |
| Duplicate pattern management with [MCP](https://docs.braintrust.dev/integrations/developer-tools/mcp.md) | v2.18.0 | |
| [Add rows to human review with MCP](https://docs.braintrust.dev/annotate/human-review/score-traces.md) | v2.19.0 | |
| Save dataset [custom views](https://docs.braintrust.dev/annotate/custom-views.md) with [MCP](https://docs.braintrust.dev/integrations/developer-tools/mcp.md#run-evals-and-edit-datasets) | v2.21.0 | |
| [Automatic attachment conversion](https://docs.braintrust.dev/instrument/attachments.md#automatic-attachment-conversion) of base64 image and file content parts that include a `media_type` | v2.22.0 | |
| Resolve [attachment](https://docs.braintrust.dev/instrument/attachments.md) references with `resolve_attachments` in [MCP](https://docs.braintrust.dev/integrations/developer-tools/mcp.md#explore-your-data) | v2.22.0 | |
| List past runs of a [Loop automation](https://docs.braintrust.dev/loop/automations.md#review-past-runs) with `list_scheduled_loop_job_runs` in [MCP](https://docs.braintrust.dev/integrations/developer-tools/mcp.md#manage-automations-and-alerts) | v2.22.0 | |
| Run a [Loop automation](https://docs.braintrust.dev/loop/automations.md#run-an-automation-now) immediately with `run_scheduled_loop_job` in [MCP](https://docs.braintrust.dev/integrations/developer-tools/mcp.md#manage-automations-and-alerts) | v2.22.0 | |

### Gateway

| Feature | Minimum data plane version | Notes |
| :- | :- | :- |
| [Braintrust Gateway](https://docs.braintrust.dev/deploy/gateway.md) | v2.0.0 | To run the Gateway in your data plane, see [Self-host the Braintrust Gateway](https://docs.braintrust.dev/admin/self-hosting/configure/gateway). |
| [Provider failover](https://docs.braintrust.dev/deploy/gateway.md#enable-provider-failover) | v2.3.0 | |

## Feature support by cloud

Some features depend on infrastructure that only some clouds provide, and some aren't available on self-hosted deployments at all.

| Feature | AWS | GCP | Azure | Notes |
| :- | :-: | :-: | :-: | :- |
| [Loop runtime](https://docs.braintrust.dev/admin/self-hosting/configure/loop-runtime), which runs Loop threads, Loop automations, and Patterns | ✓ | ✓ | ✗ | Requires AWS Terraform module v6.5.2 or later, or GCP Terraform module v2.0.0 or later with Helm chart 6.28.0 or later. On Azure, only the in-app Loop panel is available. Loop threads, the Loop page, Loop automations, Patterns, and GitHub repositories require the runtime. |
| [Self-hosted Braintrust Gateway](https://docs.braintrust.dev/admin/self-hosting/configure/gateway) | ✓ | ✓ | ✓ | GCP and Azure require Helm chart 6.6.0 or later. |
| [Private data plane](https://docs.braintrust.dev/admin/self-hosting/configure/networking#run-a-private-data-plane) | ✓ | ✗ | ✗ | Requires AWS Terraform module v7.2.0 or later. |
| [Isolated code execution](https://docs.braintrust.dev/admin/self-hosting/configure/security#code-execution-isolation) | ✓ | ✗ | ✗ | On GCP and Azure, custom code runs in the same process as the data plane. |
| [Data export](https://docs.braintrust.dev/admin/data-management/export.md) | ✓ | ✓ | ✗ | Exports go only to the cloud that hosts the data plane: Amazon S3 on AWS and Google Cloud Storage on GCP. |
| [Assume role authentication for Amazon Bedrock](https://docs.braintrust.dev/integrations/ai-providers/bedrock.md) | ✓ | ✗ | ✗ | Requires the self-hosted Braintrust Gateway. |
| Workload identity federation for [Anthropic](https://docs.braintrust.dev/integrations/ai-providers/anthropic.md), [Google](https://docs.braintrust.dev/integrations/ai-providers/google.md), and [OpenAI](https://docs.braintrust.dev/integrations/ai-providers/openai.md) providers | ✗ | ✗ | ✗ | Use API key or token authentication. |
| Microsoft Entra Workload Identity for [Azure OpenAI](https://docs.braintrust.dev/integrations/ai-providers/azure.md) providers | ✗ | ✗ | ✗ | Use **API Key** or **Entra API (Azure AD)** authentication. |
| Built-in [Jev](https://docs.braintrust.dev/integrations/ai-providers/typesafe.md#llm-as-a-judge) | ✗ | ✗ | ✗ | Use a key from your own TypeSafe account. |
| [Loop logging](https://docs.braintrust.dev/admin/organizations.md#control-loop-logging) | ✗ | ✗ | ✗ | Loop logging is always off, and the setting doesn't appear. |

## See also

**Releases and availability**

* [Self-hosting releases](https://docs.braintrust.dev/data-plane-changelog): Review release notes and the minimum Terraform or Helm version for each data plane version.
* [Feature availability](https://docs.braintrust.dev/admin/self-hosting/feature-availability): Find the data plane version each feature requires and which features each cloud supports.

**Deploy**

* [Architecture](https://docs.braintrust.dev/admin/deployment/architecture.md): Understand the control plane, data plane, and where data is stored.
* [Deploy Braintrust](https://docs.braintrust.dev/admin/self-hosting/deploy): Deploy the data plane on AWS, GCP, or Azure.
* [CloudFormation](https://docs.braintrust.dev/admin/self-hosting/aws-cloudformation): Manage a legacy AWS CloudFormation deployment.

**Configure**

* [Configure your deployment](https://docs.braintrust.dev/admin/self-hosting/configure): Review the settings available after deployment.
* [Security and access](https://docs.braintrust.dev/admin/self-hosting/configure/security): Restrict organization access, secure customer data, and harden pods.
* [Networking and connectivity](https://docs.braintrust.dev/admin/self-hosting/configure/networking): Configure URLs, rate limits, load balancers, and network access paths.
* [Scaling and storage](https://docs.braintrust.dev/admin/self-hosting/configure/scaling): Size API and Brainstore compute.
* [Self-host the Braintrust Gateway](https://docs.braintrust.dev/admin/self-hosting/configure/gateway): Deploy the Gateway in your data plane.
* [Loop runtime](https://docs.braintrust.dev/admin/self-hosting/configure/loop-runtime): Run Loop threads in isolated sandboxes on AWS or GCP.
* [Telemetry and data retention](https://docs.braintrust.dev/admin/self-hosting/configure/telemetry): Control telemetry and enable data retention.

**Upgrade**

* [Upgrade your deployment](https://docs.braintrust.dev/admin/self-hosting/upgrade/routine): Follow the routine upgrade process.
* [Upgrade to data plane v2.x](https://docs.braintrust.dev/admin/self-hosting/upgrade/v2): Migrate to the data plane v2 series.
* [Upgrade to Terraform module v6](https://docs.braintrust.dev/admin/self-hosting/upgrade/v6): Move AWS API traffic from Lambda to ECS.
* [Upgrade to Terraform module v7](https://docs.braintrust.dev/admin/self-hosting/upgrade/v7): Route AWS API traffic to ECS and deploy the Gateway by default.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.