文档首页/ 应用性能管理 APM/ 最佳实践(2.0)/ 通过调用链的Trace ID精确查询调用链路Span信息
更新时间:2026-11-03 GMT+08:00
分享

通过调用链的Trace ID精确查询调用链路Span信息

背景信息

在分布式架构下,微服务之间的调用情况日趋复杂。当外部请求响应变慢或部分请求异常时,想要快速定位哪个环节存在异常,您可以在调用链查询页面,通过Trace ID精确查询调用链路详细情况,或结合多种条件筛选查询调用链路。

通过调用链查询Span信息

  1. 登录APM控制台。
  2. 在左侧导航栏选择“应用监控 > 调用链”,进入调用链界面。
  3. 输入查询条件。

    图1 调用链查询结果
    表1 调用链查询条件

    查询条件

    具体含义

    必填/选填

    应用

    调用链所在应用。

    必填

    区域

    调用链所在区域。

    必填

    组件

    调用链所在组件。

    选填

    环境

    调用链所在环境。

    选填

    实例

    调用链所在实例。

    选填

    URL

    调用链的URL分为Rest URL 和Real URL 两种。

    Rest URL为RESTful 风格,URL中带有变量名称(如 /apm/get/{id});Real URL为实际访问的URL。

    选填

    精确

    对URL是否精确匹配,开启状态下为精确查询URL,不开启则进行模糊查询。

    选填

    调用方法

    调用链的HttpMethod。

    选填

    状态码

    调用链返回的HTTP状态码。

    选填

    响应时间

    调用链的响应时间范围,可以填写最小响应时间和最大响应时间搜索调用链,两个值都可以为空。

    选填

    是否异常

    调用链是否有异常。

    选填

    Trace ID

    调用链的Trace ID,填写该搜索条件后,系统将忽略其他搜索条件,仅按该条件检索。

    选填

    自定义参数

    已配置URL监控项,拦截header指定key值、拦截url参数指定key值、拦截cookie指定key值参数后,在这里可以设置key=value进行搜索。具体配置URL监控项方法请参见配置URL监控项。

    选填

    全局Trace ID

    调用链的全局Trace ID,填写该搜索条件后,其他搜索条件全部失效,只根据该全局Trace ID搜索。

    说明:

    单击待查看的调用链前的图标,获取全局Trace ID。

    选填

    应用码

    已配置URL监控项的业务code采集长度限制、解析业务code的key、业务code的正确值参数后,会采集相应的应用码。具体配置URL监控项方法请参见配置URL监控项。

    说明:

    单击待查看的调用链后的,查看对应的业务code的值。业务code的值即“应用码”。

    选填

  4. 单击“查找 Trace”,页面右侧展示查找结果。

相关文档