Logs

Filterable subsets of all ingested data and all generated Metrics

Distributional is now Talaria Scientific. The DBNL product described in these docs has been sunset; this documentation is preserved for reference. Read the announcement.

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 or Metrics (default: no filters)

Typically, the Logs page is visited as part of investigating a specific Insight or by clicking on part of a chart from a Dashboard, in which case the filters and time window will already be applied.

Individual Logs can be viewed in a variety of ways:

• Detailed View: All Columns and Metrics of the log viewed together and optionally expanded.

• Trace View (if spans provided): The waterfall trace view of latency and timing for each individual span.

• Session View (if session_id provided): All associated logs for the given session, along with Metrics.

As part of inspecting the logs the user can

• View the filtered logs as charts and tables in the Explorer

• Save the specific filters as a Segment to publish it on the Segments Dashboard

• Filter logs by Experiment Variants to compare different configurations

Experiment Filters

If your data includes the experiment_variants column (part of the DBNL Semantic Convention), 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.

Anywhere a Filter Builder is available (including Logs, Explorer, and Segment 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.

Experiment filters can be saved as Segments to track experiment cohorts over time on the Segments Dashboard.

Log Detail View

All Columns and Metrics of the log viewed together and optionally expanded.

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.

Log Session View

All associated logs for the given session, along with Metrics. Only available if session_id was provided as part of the DBNL Semantic Convention.