跳转至

关联 Web 应用访问


APM 通过 DDTraceZipkinSkywalkingJaegerOpentelemetry 采集器能够跟踪一个 Web 端应用程序完整的前端到后端的请求数据。

使用来自前端的 RUM 数据以及注入到后端的 trace_id,可以快速定位调用堆栈。

前置条件

  • 在对应的 Web 应用目标服务器配置 DDTraceSkywalkingOpentelemetryJaegerZipkin
  • 对于前后的分离的前端应用(有跨域的条件),需要对目标服务器允许跟踪的前端请求响应头设置 Header 白名单。

对应不同 APM 工具,具体 Access-Control-Allow-Headers 的请求头对应的 Key 如下:

  • ddtrace :x-datadog-parent-id,x-datadog-origin,x-datadog-sampling-priority,x-datadog-trace-id
  • skywalking: sw8
  • jaeger: uber-trace-id
  • zipkin: X-B3-TraceIdX-B3-SpanIdX-B3-ParentSpanIdX-B3-SampledX-B3-Flags
  • zipkin_single_header: b3
  • w3c_traceparent: traceparent
  • opentelemetry: 该类型支持 zipkin_single_header, w3c_traceparent, zipkin, jaeger 三种类型的配置方式,根据在 RUM SDK 中配置的 traceType 类添加对应的 header。

Python 示例:

app = Flask(__name__)
api = Api(app)
@app.after_request
def after_request(response):
 ...
 response.headers.add('Access-Control-Allow-Headers', 'x-datadog-parent-id,x-datadog-sampled,x-datadog-sampling-priority,x-datadog-trace-id')
 ....
 return response
 ....

注意:目标服务器需要使用的是 HTTP 服务。

前端 RUM 设置步骤

  1. 在前端应用中引入 RUM SDK
  2. 在初始化配置中添加 allowedTracingOrigins 参数,配置允许跟踪的前端请求 origin 白名单,可以是字符串数组,也可以是正则表达式。(origin 的定义:<scheme> "://" <hostname> [ ":" <port> ]

示例:

import { datafluxRum } from '@cloudcare/browser-rum'

datafluxRum.init({
  applicationId: '<DATAFLUX_APPLICATION_ID>',
  datakitOrigin: '<DATAKIT ORIGIN>',
  traceType: 'ddtrace', // ddtrace、zipkin、skywalking_v3、jaeger、zipkin_single_header、w3c_traceparent
  ... // 其他配置
  allowedTracingOrigins: ["https://api.example.com", /https:\/\/.*\.my-api-domain\.com/]
})

文档评价

文档内容是否对您有帮助? ×