更新时间:2024-03-08 GMT+08:00

调用链搜索span信息

背景信息

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

操作步骤

  1. 登录APM控制台。
  2. 在左侧导航栏选择“应用监控 > 调用链”,进入调用链界面。
  3. 输入如下查询条件,单击“查找Trace”,页面右侧展示查找结果。

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

    查询条件

    具体含义

    必填/选填

    应用

    调用链所在应用。

    必填

    区域

    调用链所在区域。

    必填

    组件

    调用链所在组件。

    选填

    环境

    调用链所在环境。

    选填

    实例

    调用链所在实例。

    选填

    URL

    调用链的URL,分为Rest URL和Real URL两种搜索条件:Rest URL为restful风格的URL,URL中带有变量名称,如/apm/get/{id};Real URL为实际访问的URL。

    选填

    精确

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

    选填

    调用方法

    调用链的HttpMethod。

    选填

    状态码

    调用链返回的HTTP状态码。

    选填

    响应时间

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

    选填

    是否异常

    调用链是否有异常。

    选填

    Trace ID

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

    选填

  4. 单击“其他查询条件”,展示“自定义参数”、“全局Trace ID”以及“应用码”三个查询条件。

    图2 其他条件
    表2 调用链查询条件

    查询条件

    具体含义

    必填/选填

    自定义参数

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

    选填

    全局Trace ID

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

    选填

    应用码

    已配置url监控项的业务code采集长度限制、解析业务code的key、业务code的正确值参数后,会采集相应的应用码,这里可以根据应用码进行搜索。

    选填

    • 自定义参数
      使用方法
      1. 配置url监控项的拦截header指定key值、拦截url参数指定key值、拦截cookie指定key值参数。具体方法参见配置url监控项
      2. 在“自定义参数”后的框中,填写对应的参数以及参数值。
      3. 单击“查找Trace”,页面右侧展示查找结果。
        图3 自定义参数查询结果
    • 全局Trace ID使用方法
      使用方法
      1. 单击待查看的调用链前的,查看全局Trace ID。
        图4 获取全局Trace ID
      2. 在“全局Trace ID”后的框中,填写全局Trace ID。
      3. 单击“查找Trace”,页面右侧展示查找结果。
        图5 查询全局Trace ID结果
    • 应用码使用方法
      使用方法
      1. 配置url监控项的业务code采集长度限制、解析业务code的key、业务code的正确值参数。具体方法参见配置url监控项
        图6 url监控项
      2. 在左侧导航栏选择“应用监控 > 调用链”,进入调用链界面。
      3. 单击,查看对应的业务code的值。业务code的值即“应用码”。
        图7 查看业务code
      4. 在“应用码”后的框中,填写应用码。
        图8 查找code对应的调用链
      5. 单击“查找Trace”,页面右侧展示查找结果。