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

# 追踪列表与追踪树

> 列出 Trace 摘要，并按 trace_id 拉取完整 Span 树。

列出 Trace 摘要：

```http theme={null}
GET /api/v1/web/traces
```

| 参数            | 必填 | 说明                  |
| ------------- | -- | ------------------- |
| `from` / `to` | 否  | Unix 微秒；默认最近 24 小时。 |
| `q`           | 否  | Trace 自由文本过滤。       |
| `filters`     | 否  | JSON 编码的结构化过滤条件。    |
| `limit`       | 否  | 默认 50，限制在 1–200。    |

每条结果包含 `trace_id`、服务、操作、开始时间、时长、Span 数与错误数。

拉取一棵 Trace 树：

```http theme={null}
GET /api/v1/web/trace/{trace_id}
```

追踪树最多包含 100,000 个 Span，响应硬上限为 32 MiB；达到限制时返回
`truncated=true`。两个端点都需要 `streams.query`，系统范围则可使用
`sys.telemetry.read`。