跳到主要内容
版本:3.7.0

请求染色

请求染色通过前后端应用的Trace关联与Bonree APM采集链路打通,实现第三方集成调用与全链路调用信息的完整追踪。

提示

仅支持与符合Opentelemetry协议的调用链数据关联,因此需要您在接入调用链数据前将数据转为Opentelemetry协议。

如何配置请求染色

前端应用配置

  1. 进入部署配置->规则配置->数据采集->请求染色->前端应用1759132763360

    选择您需要关联的第三方平台,开启后会向调用链中注入第三方平台对应的TraceID信息。

    Bonree:即在Trace中是否插入Bonree的请求头信息。

    格式:version "-" trace-id "-" parent-id "-" trace-flags
    version = 2HEXDIGLC ; this document assumes version 00. Version ff is forbidden
    trace-id = 32HEXDIGLC ; 16 bytes array identifier. All zeroes forbidden
    parent-id = 16HEXDIGLC ; 8 bytes array identifier. All zeroes forbidden
    trace-flags = 2HEXDIGLC ; 8 bit flags. Currently, only one bit is used.

    SkyWalking-生成Sw8协议头:即在Trace中是否插入Sw8协议的请求头信息。

    格式:"Sample"-"trace-id"-"segment-Id"-"Parent span Id"-"Parent service"-"Parent service instance"-"Parent endpoint"-"Peer"

    SkyWalking-获取Sw8协议头:即当SkyWalking的调用链信息传递至Bonree时支持获取Sw8协议头的信息进行映射。

  2. 若您想仅针对全部或部份域名生效,平台也提供了配置规则

    点击启用后,默认对您所有的应用域名生效,若您的场景要求或处于安全角度出发,需要控制到仅对具体域名生效或对具体域名不生效可以点击展开应用,对具体应用及域名进行配置。1759138796087

  3. 若标准协议无法满足您的场景,即您所使用协议是经过二次开发或者完全定制而来时,您可以创建一套自定义的协议方案来解决您的场景。点击创建协议,进入创建页面,目前仅支持创建关联方式为生成的自定义协议,即插入请求头信息,最大可插入10条信息。创建完成后会自动在您的Trace中插入对应的请求头信息。

    提示

    自定义请求头信息支持定值和16位以及32位随机生成的UUID。

    1759139188953

后端服务配置

  1. 进入部署配置->规则配置->数据采集->请求染色->后端服务1759139534401

    选择您需要关联的第三方平台,开启后会向调用链中注入第三方平台对应的TraceID信息。

    Bonree:即在Trace中是否插入Bonree的请求头信息。

    格式:version "-" trace-id "-" parent-id "-" trace-flags
    version = 2HEXDIGLC ; this document assumes version 00. Version ff is forbidden
    trace-id = 32HEXDIGLC ; 16 bytes array identifier. All zeroes forbidden
    parent-id = 16HEXDIGLC ; 8 bytes array identifier. All zeroes forbidden
    trace-flags = 2HEXDIGLC ; 8 bit flags. Currently, only one bit is used.

    SkyWalking-生成Sw8协议头:即在Trace中是否插入Sw8协议的请求头信息。

    格式:"Sample"-"trace-id"-"segment-Id"-"Parent span Id"-"Parent service"-"Parent service instance"-"Parent endpoint"-"Peer"

    SkyWalking-获取Sw8协议头:即当SkyWalking的调用链信息传递至Bonree时支持获取Sw8协议头的信息进行映射。1759139666599

验证方式

提示

无论是预制方案还是自定义方案,当功能配置完成后,需要您联系到Bonree的销售人员配置您协议的跳转地址,配置方可生效。

  1. 在ONE平台 观测洞察->检索中心->调用链 ,即可查看到对应的调用链信息。
  2. 同时支持调用链跳转到第三方平台。