> For the complete documentation index, see [llms.txt](https://docs.dbnl.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dbnl.com/workflow/logs.md).

# Logs

{% hint style="info" %}
**Distributional is now** [**Talaria Scientific**](https://talariasci.com)**.** The DBNL product described in these docs has been sunset; this documentation is preserved for reference. Read [the announcement](https://distributional.com/blog/distributional-is-now-talaria).
{% endhint %}

The Logs page allows the user to inspect specific logs with certain properties defined by

* A specific time window (default: last 7 full days of data)
* Specific filters on [Columns](/configuration/data-pipeline.md#columns) or [Metrics](/workflow/metrics.md) (default: no filters)

{% hint style="info" %}
Typically, the Logs page is visited as part of investigating a specific [Insight](/workflow/insights.md) or by clicking on part of a chart from a [Dashboard](/workflow/dashboards.md), in which case the filters and time window will already be applied.
{% endhint %}

Individual Logs can be viewed in a variety of ways:

* [**Detailed View**](#log-detail-view): All [Columns](/configuration/data-pipeline.md#columns) and [Metrics](/workflow/metrics.md) of the log viewed together and optionally expanded.
* [**Trace View**](#log-trace-view) (if `spans` provided): The waterfall trace view of latency and timing for each individual span.
* [**Session View**](#log-session-view) (if `session_id` provided): All associated logs for the given session, along with [Metrics](/workflow/metrics.md).

As part of inspecting the logs the user can

* View the filtered logs as charts and tables in the [Explorer](/workflow/explorer.md)
* Save the specific filters as a [Segment](/workflow/segments.md) to publish it on the [Segments Dashboard](/workflow/dashboards.md#segments-dashboard)
* Filter logs by [Experiment Variants](#experiment-filters) to compare different configurations

<figure><img src="/files/nuuPoxnjhUiUZBw49Jmu" alt=""><figcaption></figcaption></figure>

### Experiment Filters

If your data includes the `experiment_variants` column (part of the [DBNL Semantic Convention](/configuration/dbnl-semantic-convention.md)), you can filter logs by experiment name and variant. The `experiment_variants` column is a map in the form `{ [experiment_name]: experiment_variant }`, for example `{"model": "gpt-4o"}` or `{"model": "gpt-4o-mini", "prompt_version": "v2"}`. To produce this column from the dbnl SDK, see [App Versioning & Experiments](/configuration/app-versioning-and-experiments.md).

Anywhere a Filter Builder is available (including [Logs](/workflow/logs.md), [Explorer](/workflow/explorer.md), and [Segment](/workflow/segments.md) creation), click **"Add experiment filter"** to add an experiment filter row. Each row allows you to specify:

* **Experiment name**: The name of the experiment (e.g., `model`)
* **Operator**: One of `is`, `is not`, `contains`, or `does not contain`
* **Experiment variant**: The variant value to filter on (e.g., `gpt-4o`)

You can add multiple experiment filters. Like other filters, all rows are ANDed together.

{% hint style="info" %}
Experiment filters can be saved as [Segments](/workflow/segments.md) to track experiment cohorts over time on the [Segments Dashboard](/workflow/dashboards.md#segments-dashboard).
{% endhint %}

### Log Detail View

All [Columns](/configuration/data-pipeline.md#columns) and [Metrics](/workflow/metrics.md) of the log viewed together and optionally expanded.

<figure><img src="/files/GjJ4LYcXFTP6JNeca7nV" alt=""><figcaption></figcaption></figure>

### Log Trace View

The waterfall trace view of latency and timing for each individual span. Only available if `spans` was provided as part of the [DBNL Semantic Convention](/configuration/dbnl-semantic-convention.md).

<figure><img src="/files/CYH8W2GerOHA4RJ2wlQu" alt=""><figcaption></figcaption></figure>

### Log Session View

All associated logs for the given session, along with [Metrics](/workflow/metrics.md). Only available if `session_id` was provided as part of the [DBNL Semantic Convention](/configuration/dbnl-semantic-convention.md).

<figure><img src="/files/2SkQxpz8UCof3o43upPm" alt=""><figcaption></figcaption></figure>