链路

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

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

链路浏览器,显示请求耗时随时间的分布,每个请求一行

应用开始发送链路后,链路就会到达:在复制设置提示词时勾选 链路,或使用自动埋点。

阅读图表

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

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

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

查找慢请求和失败请求

像在 日志 页面一样使用搜索框。以下筛选条件专为链路设计:

筛选条件查找
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 的慢调用

在这个例子中,加载一个页面耗时 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 为红色,并有复制修复提示词的按钮

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