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

# Observe your application

> Discover recurring problems with Patterns, investigate production traces, and turn findings into fixes, evaluations, and ongoing monitoring.

Braintrust helps you understand how your AI application behaves in production and find opportunities to improve it. After you [instrument your application](https://docs.braintrust.dev/tracing-quickstart.md), you can inspect individual traces, ask Loop to investigate questions, and enable Patterns to automatically discover recurring problems with supporting evidence and suggested next steps.

## Why observe in Braintrust

Braintrust connects discovering a problem, understanding its cause, and checking whether a fix works:

* **Discover recurring problems:** Patterns uses Loop to investigate traces and surface failures, unmet user needs, and opportunities for improvement. Compare findings by severity and impact to prioritize your work.
* **Investigate the evidence:** Inspect trace inputs, outputs, and tool calls, or ask Loop to help explain the behavior. With a connected repository, Loop can also examine the code behind a finding.
* **Turn findings into evaluations:** Add examples from production to datasets and use them to test changes. Logs and experiments share a data structure, so you can reuse instrumentation, scorers, and feedback across production and evaluation.
* **Monitor the results:** Use online scoring and dashboards to track quality, latency, cost, and recurring behavior after a change.

## View your logs

The  **Logs** page displays all traces from your application in a searchable, filterable table. Each row represents a complete trace with its root span.

![Logs page](https://mintcdn.com/braintrust/wnKh80ZxpSZ__gif/images/observe/logs.png?fit=max\&auto=format\&n=wnKh80ZxpSZ__gif\&q=85\&s=5f1254cfe0eb121f829e87a25ba750ce)

You can:

* Browse traces and individual spans, in the UI or from the terminal with [`bt view logs`](https://docs.braintrust.dev/reference/cli/view).
* Group related traces by metadata or tags.
* Create custom columns to surface important values.
* Extract prompts to iterate in playgrounds.
* Apply tags to organize traces.
* Download logs as CSV or JSON, or pull them locally with [`bt sync pull`](https://docs.braintrust.dev/reference/cli/sync).

## Find recurring problems with Patterns

[** Patterns**](https://docs.braintrust.dev/observe/patterns/enable.md) uses [Loop](https://docs.braintrust.dev/loop.md) to investigate your traces and find recurring problems and opportunities to improve your application. Each finding includes supporting evidence and suggested next steps.

> [!WARNING]
>
> Patterns is in [public preview](https://docs.braintrust.dev/feature-lifecycle.md) and can change before reaching general availability.

Compare findings by severity, affected traces, and when the behavior last occurred to decide what to investigate first.

![Patterns grouped into Today, Last 7 days, and Last 30 days, with severity, trace counts, categories, and first and last seen times](https://mintcdn.com/braintrust/J_9S66tbXkQwxaO-/images/observe/patterns-list-2026-11-18.png?fit=max\&auto=format\&n=J_9S66tbXkQwxaO-\&q=85\&s=16fb0b68b509ba470775d6e65aa56f42)

[Enable Patterns](https://docs.braintrust.dev/observe/patterns/enable.md) to start discovery, then [review findings](https://docs.braintrust.dev/observe/patterns/review.md) to verify the evidence and decide what to do next.

## Investigate and improve with Loop

[** Loop**](https://docs.braintrust.dev/loop.md) is Braintrust's AI agent. It understands your data structure, so you can investigate your logs through natural language instead of writing queries. Loop is available on the  **Logs** page, on individual trace pages, and on its own full page, and it powers Patterns.

See [What Loop can do](https://docs.braintrust.dev/loop.md) for the full range, including building datasets, writing scorers, and running evaluations from what it finds.

## Discover insights with Topics

[** Topics**](https://docs.braintrust.dev/observe/topics.md) automatically analyze and classify your logs without manual review. Each trace is analyzed by **facets** that extract short labels, then similar labels are clustered into named **topics** like user intents, sentiment, and issues.

Use Topics for:

* **Blind-spot detection**: Surface user request types and system gaps you didn't know to look for.
* **Silent failure detection**: Catch quality issues that don't trip explicit checks.
* **Product roadmap signals**: Cluster real user requests into themes to inform what to build.
* **Targeted evaluation datasets**: Filter classified logs to build datasets for focused evals.

Built-in facets include Task (user intents), Sentiment (emotional tone), and Issues (agent problems). You can also create custom facets for domain-specific analysis.

See [Get started with Topics](https://docs.braintrust.dev/observe/topics.md) for details.

## Monitor with dashboards

[** Dashboards**](https://docs.braintrust.dev/observe/dashboards.md) aggregate metrics across your logs and experiments. Track request counts, latency, token usage, costs, scores, and custom metrics over time.

Dashboards help you:

* Visualize trends and anomalies
* Compare performance across time periods
* Drill into specific data points
* Share insights with your team

## Get notified with alerts

[** Alerts**](https://docs.braintrust.dev/observe/alerts.md) notify you when logs match conditions, metrics cross thresholds, or prompt and dataset environments change. Send notifications to Slack, PagerDuty, or webhooks so your team can respond.

Use log alerts to flag individual errors or low scores, and time window alerts to detect aggregate changes, such as an average score dropping below a target or an error count exceeding a limit.

See [Set up alerts](https://docs.braintrust.dev/observe/alerts.md) for requirements and configuration.

## Next steps

* [View your logs](https://docs.braintrust.dev/observe/view-logs.md) in the Braintrust dashboard
* [Enable Patterns](https://docs.braintrust.dev/observe/patterns/enable.md) to surface recurring problems automatically
* [Discover insights with Topics](https://docs.braintrust.dev/observe/topics.md)
* [Use Loop](https://docs.braintrust.dev/loop.md) to analyze logs with natural language
* [Filter and search](https://docs.braintrust.dev/observe/filter.md) for specific traces
* [Score online](https://docs.braintrust.dev/evaluate/score-online.md) to evaluate production quality


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