# 链路

Source: https://instatus.com/help/zh/observability/traces

一条链路就是一个请求，跟踪它经过的每个服务。每一步都是一个 span：一次 HTTP 调用、一次数据库查询、一次对其他服务的调用。链路告诉你慢请求把时间花在哪里，失败的请求在哪里出错。

在你的状态页上打开 **Observability** → **链路**。每一行是一个请求。

![链路浏览器，显示请求耗时随时间的分布，每个请求一行](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [查找](https://instatus.com/help/zh/observability/traces#查找慢请求和失败请求) | status:error, duration:>1s, service: |
| [打开](https://instatus.com/help/zh/observability/traces#打开链路) | 点击一行查看瀑布图 |
| [修复](https://instatus.com/help/zh/observability/traces#修复失败的请求) | 为编程助手复制修复提示词 |
| [日志](https://instatus.com/help/zh/observability/traces#打开链路) | 跳转到请求的日志 |

应用开始发送链路后，链路就会到达：在[复制设置提示词](https://instatus.com/help/zh/observability/send-logs#方式-1复制提示词)时勾选 **链路**，或使用自动埋点。

## 阅读图表

每个点代表一个请求，位置由发生时间和耗时决定。红点表示失败。图表上方有：

- **链路数**：搜索找到的请求数量。
- **错误**：失败的数量及其占比。
- **p50**、**p95**、**p99**：一半、95% 和 99% 的请求比这个值更快。

在图表上拖动可放大某个时间窗口。

## 查找慢请求和失败请求

像在 [日志](https://instatus.com/help/zh/observability/logs#筛选) 页面一样使用搜索框。以下筛选条件专为链路设计：

| 筛选条件          | 查找                                               |
| --------------- | --------------------------------------------------- |
| `status:error`  | 失败的请求                                |
| `duration:>1s`  | 耗时超过一秒的请求。也可用 `>500ms`、`<100ms` |
| `service:api`   | 由某个服务处理的请求                     |
| `span.name:`    | 具有特定名称的 span，比如 `GET /v1/users`    |
| 任意属性   | 比如 `http.route:` 或 `http.response.status_code:` |

自由文本会搜索 span 名称。**根 span** 默认开启，因此每个请求只显示一次。关闭后会单独列出每个 span。

下载按钮可将列表导出为 CSV。

## 打开链路

点击一行。链路会打开，每个 span 都显示在时间线上，并嵌套在调用它的 span 下方。长条就是耗时所在。

![一条经过三个服务的链路，瀑布图底部有一次对 Okta 的慢调用](https://instatus.com/help/observability/trace-waterfall.png)

在这个例子中，加载一个页面耗时 842 ms。瀑布图说明了原因：`web` 调用 `api`，`api` 调用 `sso`，而 `sso` 等待 Okta 用了 468 ms。

- 点击某个 span 可查看它的属性，比如路由、状态码或数据库查询。
- **此 span 的 N 条日志** 会打开在该 span 期间写入的日志。
- 顶部的 **N 条日志** 会打开该请求在所有服务中的每条日志。
- **复制链路 ID** 复制 ID，便于分享或用 `trace_id:` 搜索。
- 用 **↑** **↓** 或 **J** **K** 切换到上一条或下一条链路，按 **Esc** 关闭。

## 修复失败的请求

失败的 span 显示为红色。**仅看错误** 会隐藏成功的 span，让失败在长链路中更醒目。

![一个失败的请求，出错的 span 为红色，并有复制修复提示词的按钮](https://instatus.com/help/observability/trace-error.png)

**复制修复提示词** 会复制失败请求的描述：包括 span、错误和属性。在应用的项目中把它粘贴给编程助手，它就有足够信息找到原因。

- [指标](https://instatus.com/help/zh/observability/metrics): 发现变化，变化最大的排在最前
- [日志](https://instatus.com/help/zh/observability/logs): 搜索、筛选并实时查看日志
