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

# Analyze log spans

> Inspect model calls, tool calls, functions, retrieval, and custom steps inside a trace

Spans are the steps inside a trace. A span can represent a model call, tool call, function, retrieval step, orchestration step, guardrail, or custom operation. Inspect spans when the trace-level summary is not enough.

<img src="https://mintcdn.com/adaline/o8h3k4eQQbaIV193/images/platform-v2/traces/span-details-current.png?fit=max&auto=format&n=o8h3k4eQQbaIV193&q=85&s=29aa2523a50482e9c34b8c6b919654e4" alt="Trace side sheet with span tree, selected final response span, actions, metrics, metadata, completion, variables, evaluations, and raw tabs" title="Span details in the trace side sheet" style={{ width: "100%" }} width="1804" height="1123" data-path="images/platform-v2/traces/span-details-current.png" />

## Where spans live

Span review now happens inside the trace side sheet:

1. Open [Traces](/docs/monitor/analyze-log-traces) from the sidebar or from a Monitor chart.
2. Select a trace row.
3. Choose **Tree** or **Waterfall** mode.
4. Select the span you want to inspect.

The selected span drives the details panel on the right.

## What to inspect

Depending on the span type, the detail panel can include:

| Detail          | Why it matters                                                       |
| --------------- | -------------------------------------------------------------------- |
| **Metrics**     | Duration, status, token usage, and cost.                             |
| **Completion**  | Model input and output content for model spans.                      |
| **Variables**   | Runtime variable values used by the prompt.                          |
| **Evaluations** | Continuous evaluation results attached to the span.                  |
| **Metadata**    | Tags, attributes, IDs, provider/model details, and app context.      |
| **Raw**         | The structured payload Adaline stored for exact debugging or export. |

Use span details to decide whether the issue is in the prompt, model, tool, retrieval layer, evaluator, instrumentation, or application code.

<img src="https://mintcdn.com/adaline/o8h3k4eQQbaIV193/images/platform-v2/traces/span-raw-payload-current.png?fit=max&auto=format&n=o8h3k4eQQbaIV193&q=85&s=310ba32eddb7b2dc4e0b7708434c925a" alt="Trace side sheet with selected span raw JSON payload" title="Span raw payload" style={{ width: "100%" }} width="1804" height="1123" data-path="images/platform-v2/traces/span-raw-payload-current.png" />

## Tree and waterfall

Tree view is best for structure. It shows parent-child relationships between orchestration, model calls, tools, functions, retrieval, and custom spans.

Waterfall view is best for timing. It shows where latency is spent and whether operations ran sequentially or in parallel.

<img src="https://mintcdn.com/adaline/o8h3k4eQQbaIV193/images/platform-v2/traces/waterfall-current.png?fit=max&auto=format&n=o8h3k4eQQbaIV193&q=85&s=cedd99e36cc27c7e927ffee874b8a903" alt="Trace side sheet in waterfall mode showing span timing and nested operations" title="Trace waterfall view" style={{ width: "100%" }} width="1804" height="1123" data-path="images/platform-v2/traces/waterfall-current.png" />

## Actions from a span

For supported spans, the details panel can provide actions such as:

* **Open in Playground** to reproduce a model call with production inputs.
* **Add to Dataset** to preserve the case as regression or golden coverage.
* **Copy raw JSON** when a teammate or external system needs exact evidence.

Do not treat every span as a dataset row. Add spans when they teach the team something future releases should remember.

<CardGroup cols={2}>
  <Card title="Inspect a trace" icon="panel-right-open" href="/docs/monitor/analyze-log-spans">
    See the full trace viewer workflow.
  </Card>

  <Card title="Build datasets from logs" icon="database" href="/docs/monitor/build-logs-from-dataset">
    Convert useful model spans into dataset rows.
  </Card>

  <Card title="Use logs to improve prompts" icon="wand-sparkles" href="/docs/monitor/use-logs-to-improve-prompts">
    Use span evidence to guide prompt improvement.
  </Card>

  <Card title="Setup continuous evaluations" icon="infinity" href="/docs/monitor/setup-continuous-evaluations">
    Attach evaluator results to production spans.
  </Card>
</CardGroup>
