文档

配置Trace链路追踪

更新时间:

您可以参考本文在API网关控制台配置trace链路追踪日志上传到阿里云链路追踪平台,链路追踪 Tracing Analysis 提供了完整的调用链路还原、调用请求量统计、链路拓扑、应用依赖分析等工具,可以帮助用户提高开发诊断效率。本功能仅支持专享实例。

前提条件

1 链路追踪授权

1.1 登录链路追踪控制台

1.2 在概览页面上,单击立即授权,授权链路追踪读写您的日志服务。

1.3 在云资源访问授权页面上,选择所需的权限,并单击同意授权。

1.4 授权后可在概览——接入流程——查看接入点信息——显示token。即可查看到详细的接入点信息。保存通过HTTP上传数据中的接入点地址。

2 API网关配置Trace链路追踪

2.1 登录API网关控制台

2.2 在左侧栏选择开放API——分组管理。点击进入分组详情。在分组详情页即可配置。

  • Trace字段位置:指定Trace字段的位置,可选位置有Header、Query。

  • Trace字段名称:自定义Trace字段的名称。自定义Trace字段由客户端生成,网关会透传给后端,并记录在用户的 `CustomTraceId` 字段,且网关会以该字段的值作为TraceId向链路追踪平台上报日志信息,前提条件是该字段的值符合标准的TraceId格式,即16位或32位的十六进制数。如果客户端未提供Trace字段,网关会将该字段设置为网关生成的RequestId,并以随机的TraceId向链路追踪平台上报信息。

  • 透传或生成EAGLEEYE相关头(Eagleeye-Rpcid、Eagleeye-Traceid、Eagleeye-Sampled):勾选配置后,若客户端传了EAGLEEYE相关头,网关会将相关头透传给后端服务,若没有传,网关将会生成相关头并传给后端服务。(共享实例和专享实例均可使用)

  • 透传或生成B3相关头(X-B3-traceid、X-B3-Parentspanid、X-B3-Spanid、X-B3-Sampled):勾选配置后,若客户端传了B3相关头,网关会将相关头透传给后端服务,若没有传,网关将会生成相关头并传给后端服务。(共享实例和专享实例均可使用)

  • 将追踪日志上传到阿里云链路追踪平台(仅专享实例使用):

    • 应用名称:自定义链路追踪的应用名称。

    • 接入点:填写1.4中的接入点地址,同region建议使用内网接入点,可以大幅提高效率。

    • 日志采样策略:支持全部上传、按百分比上传、每秒上传固定数,根据需要选择即可。

API网关配置Trace链路追踪后的请求可以在链路追踪控制台查看到请求链路。

关于链路追踪的使用可参考查看接口调用情况

  • 本页导读 (0)
文档反馈