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

# Observability

> Every run, searched and filtered: all runs, the active ones, those waiting on the outside world, and the failures grouped.

Observability holds the runs of your organization in four views of the same query. Its sidebar holds the view picker,
your saved searches and the filters.

![Observability: the query bar, runs started over time, the list of runs, and the filters](https://mintcdn.com/rewind/WThuBH7lRjVmKt9-/images/dashboard/observability-light.webp?fit=max\&auto=format\&n=WThuBH7lRjVmKt9-\&q=85\&s=9279cab2db1dd8751ff9df67e1ac3cd6)

## The query bar

Type a [query](https://docs.rewind.codes/dashboard/query-language.md): terms separated by spaces, all of which must hold. The bar suggests fields
and the values that exist as you type, and underlines a term the server cannot read.

![The query bar suggesting @agent:support, @agent:triage and @agent:digest](https://mintcdn.com/rewind/WThuBH7lRjVmKt9-/images/dashboard/observability-suggestions-light.webp?fit=max\&auto=format\&n=WThuBH7lRjVmKt9-\&q=85\&s=525e3dc75ee3d9db96b16ddf3feb8d3f)

Suggestions drawn from the values that exist: here, the values of the label agent

**Save** keeps the query as a saved search, in your browser; Find (<kbd>F</kbd>) opens it later.

## Filters

The sidebar lists, for each field, the values found with their counts: the timeline, the status, the namespaces, each
label, the tools, the errors, the scripts. A filter is a term of the query:

* one click asks for the value (`status:failed`);
* a second click excludes it (`-status:failed`);
* a third removes it.

![Observability filtered on the failed runs of the triage agent](https://mintcdn.com/rewind/WThuBH7lRjVmKt9-/images/dashboard/observability-query-light.webp?fit=max\&auto=format\&n=WThuBH7lRjVmKt9-\&q=85\&s=a013489ab367220afe362740e821d9b7)

@agent:triage status:failed: the filters checked in the sidebar are the terms of the query

## The four views

### All runs

The runs started over time, then the list: each run with its status, namespace, the first line of its script, when it
started, its duration, its calls, when it wakes and its error. Sort it by start, by last activity, or by next wake.

### Active

The runs not yet ended.

### Waiting

The active runs waiting on the outside world, grouped by what they wait for, by tab: **signals**, **approvals**,
**timers** and **tools**. Each run shows the line it is paused on and when it wakes, the soonest first. Use it to find
what a person, a tool or your harness has to answer.

![Waiting runs grouped by signal, timer, host tool, approval and tool call](https://mintcdn.com/rewind/WThuBH7lRjVmKt9-/images/dashboard/observability-waiting-light.webp?fit=max\&auto=format\&n=WThuBH7lRjVmKt9-\&q=85\&s=c82b980a3370ea8ee1c98c463809dd7e)

### Failures

The failed, cancelled and aborted runs of a window, grouped by **fingerprint**: the error with its numbers, ids, times
and quoted strings replaced, so the same failure across the many scripts models write is one group. Each group shows its
runs over time, how many scripts hit it, when it was first and last seen, the line most of its runs ended at, the top
labels, and the latest run.

![Failures grouped by fingerprint, with their series, scripts, line and latest run](https://mintcdn.com/rewind/WThuBH7lRjVmKt9-/images/dashboard/observability-failures-light.webp?fit=max\&auto=format\&n=WThuBH7lRjVmKt9-\&q=85\&s=394510b905867bc09307e8ecf49d59e6)

Click a run, anywhere, to open it in the [Run](https://docs.rewind.codes/dashboard/run.md) view.


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