应用性能监控全链路版
应用性能监控全链路版
文档指南
请输入
- 文档首页
应用性能监控全链路版用户指南应用性能监控最佳实践APMPlus 端到端全链路追踪
复制全文
下载 pdfAPMPlus 端到端全链路追踪
文档反馈
问问助手应用性能监控全链路版面向企业级用户提供覆盖 App、Web、小程序等客户端与 Java、Go、Python 等服务端的端到端全链路追踪解决方案，通过分布式链路追踪技术实现用户行为、网络请求、服务调用、数据库/消息队列等依赖组件的全流程可视化与性能分析，帮助企业快速定位异常根因、优化系统性能、提升用户体验，并支持数据驱动的业务决策。
背景信息
应用性能监控全链路版已经完整支持从用户终端到 AI&中间件的端到端全链路打通，完整链路包括：用户终端（例如：Android/iOS/Web/小程序） -> 接入网关（例如：API 网关/Ingress/Nginx 等） -> 后端服务（例如：Java/Go/Python 等） -> AI&中间件（例如：大模型、数据库、缓存、消息队列等）。
前提条件
使用端到端全链路追踪解决方案前，确保客户端 SDK 版本满足以下要求。
操作步骤
步骤一：接入客户端应用
根据实际情况，选择合适的客户端类型并通过 SDK 方式将应用接入 APMPlus 客户端监控。以下提供 4 种客户端应用的接入方式：
- 参考 应用接入 Android SDK 中的说明，获取合适的 SDK 包并初始化 SDK。
- 添加以下示例代码，启动 SDK 并开启数据采集和全链路监控。
ApmInsightInitConfig.Builder builder = ApmInsightInitConfig.builder();
//控制是否打开网络监控，开启需要同时配置 apm-plugin 插件。
builder.netMonitor(true);
//控制开启全链路监控，需要同步接入 APMPlus 服务端 server 监控。
builder.enableNetTrace(true);
ApmInsight.getInstance().start(builder.build());
- 应用接入 Android SDK 后，可参考 验证数据上报 中的说明验证数据上报。
- 参考 应用接入 iOS SDK 中的说明，获取合适的 SDK 包并初始化 SDK。
- 添加以下示例代码，启动 SDK 并开启数据采集和全链路监控。
//需要引入如下头文件
<RangersAPMConfig+NetworkPro.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
RangersAPMConfig *apmConfig = [RangersAPMConfig configWithAppID:@"{{app_id}}" appToken:@"{{app_token}}"];
apmConfig.channel = @"App Store";
//配置 enableTracing 为 YES 以开启全链路监控功能
apmConfig.enableTracing = YES;
[RangersAPM startWithConfig:apmConfig];
return YES;
}
- 应用接入 iOS 后，可参考 验证数据上报 中的说明验证数据上报。
- 参考 Web SDK 接入 中的说明，接入 SDK。
- 添加以下示例代码，启动 SDK 并开启数据采集和全链路监控。
说明
- 若请求由 fetch API 发出，则需要在 fetch 插件上配置；若请求由 xhr API 发出，则需要在 ajax 插件上配置。
- 开启 Trace 打通将为请求添加请求头，因此，默认不开启 Trace。
- 必须同时配置 sampleRate 和 origins。
import client from '@apmplus/web'
client('init', {
...
plugins: {
...
fetch: {
// 如果请求由 fetch API 发出，则需要在 fetch 插件上配置。
trace: {
sampleRate: 1, // trace 采样率，采样规则为会话采样，即一次会话中符合要求的请求要么全部开启 trace，要么全部关闭 trace。
origins: ['xxx'], // origins 用作请求地址匹配，只有匹配上 origins 的请求才会开启 trace。
}
},
ajax: {
// 如果请求由 xhr API 发出，则需要在 ajax 插件上配置。
trace: {
sampleRate: 1, // trace 采样率，采样规则为会话采样，即一次会话中符合要求的请求要么全部开启 trace，要么全部关闭 trace。
origins: ['xxx'] // origins 用作请求地址匹配，只有匹配上 origins 的请求才会开启 trace。
}
}
},
...
})
- 应用接入 Web SDK 后，可参考 Web SDK 接入 中的说明验证数据上报。
- 参考 小程序 Pro SDK 接入 中的说明，接入 SDK。
- 添加以下示例代码，启动 SDK 并开启数据采集。
说明
- 开启 Trace 打通将为请求添加请求头，因此，默认不开启 Trace。
- 必须同时配置 sampleRate 和 origins。
const apm = require('@apmplus/mini-program')
const client = apm.createMiniProgramClient([apm.WxAdapter])
client('init', {
...
plugins: {
...
http:{
...
trace: {
sampleRate: 1 // trace 采样率，采样规则为会话采样，即一次会话中符合要求的请求要么全部开启 trace，要么全部关闭 trace。
origins: ['xxx'], // origins 用作请求地址匹配，只有匹配上 origins 的请求才会开启 trace。
}
}
},
...
})
- 应用接入小程序 Pro SDK 后，可参考 小程序 Pro SDK 接入 中的说明验证数据上报。
步骤二：接入服务端应用
端到端全链路追踪依赖服务端应用正确接入OpenTelemetry SDK，从而识别 App、Web 或小程序端的 HTTP 请求，并将相关 Header 字段转换为链路属性上报到 APMPlus 服务端。不同语言的接入方式不同，以下提供 4 种语言的接入方式，可根据服务端应用使用的语言选择合适的接入方式。
- 通过 OpenTelemetry 接入 Java 应用，详细说明参见：Java 应用接入。
- 根据不同接入方式进行自动注入配置。
- 若通过 VKE 集群组件中心白屏安装 apmplus-opentelemetry-collector 组件方式，默认支持自动注入，无需修改配置。
- 若通过社区提供的 SDK 接入或者 Agent 自主接入，需要增加如下环境变量：
OTEL_JAVA_EXPERIMENTAL_SPAN_ATTRIBUTES_COPY_FROM_BAGGAGE_INCLUDE:apmplus.app_id,apmplus.origin,apmplus.client_domain
- 通过 OpenTelemetry 接入 Go 应用，详细说明参见：Go 应用接入。
- 参考如下步骤，配置自动注入。
- 获取官方提供的 baggagecopy 包。
- go get "go.opentelemetry.io/contrib/processors/baggagecopy"
- 初始化 TracerProvider 时，增加 bagggagecopy 的 SpanProcessor。
- tp := trace.NewTracerProvider(trace.WithSpanProcessor(baggagecopy.NewSpanProcessor(nil)),...)
- 通过 OpenTelemetry 接入 Python 应用，详细说明参见：Python 应用接入。
- 参考如下步骤，配置自动注入，更多详细也可参考：opentelemetry-processor-baggage。
- 安装 opentelemetry-processor-baggage。
- pip install opentelemetry-processor-baggage
- 配置 Tracer Provider。
- from opentelemetry.processor.baggage import BaggageSpanProcessor, ALLOW_ALL_BAGGAGE_KEYSfrom opentelemetry import trace# 获取全局TracerProvidertrace.get_tracer_provider().add_span_processor(BaggageSpanProcessor(ALLOW_ALL_BAGGAGE_KEYS))
- 通过 OpenTelemetry 接入 Nodejs 应用，详细说明参见：Nodejs 应用接入。
- 参考如下步骤，配置自动注入，更多详细也可参考：baggage-span-processor。
- 安装 opentelemetry/baggage-span-processor。
- npm install --save @opentelemetry/baggage-span-processor
- 配置 BaggageSpanProcessor。
- import { NodeSDK, tracing } from '@opentelemetry/sdk-node';import { ALLOW_ALL_BAGGAGE_KEYS, BaggageSpanProcessor } from '@opentelemetry/baggage-span-processor';const spanProcessors = [new tracing.SimpleSpanProcessor(new tracing.ConsoleSpanExporter()),new BaggageSpanProcessor(ALLOW_ALL_BAGGAGE_KEYS)];const sdk = new NodeSDK({serviceName: "example-service",spanProcessors});sdk.start();
步骤三：端到端全链路追踪
App 端应用（例如：Android、iOS）和服务端应用正确接入后，从 App 端发起的请求将发送到服务端应用，可前往应用性能监控 Trace 详情页查看 App 请求的 Span，而且，支持跳转到客户端监控的 App 监控页面查看更多信息。
- 登录 应用性能监控控制台。
- 搜索目标服务，单击服务名称，前往目标服务的管理页面。
- 在左侧导航栏选择 Trace 分析，前往 Trace 分析页面。
- 根据实际情况，通过时间、标签、Span 属性、Trace ID、Span 类型、服务名等条件筛选目标 Trace，单击目标 TraceID，前往 单链路详情 页面。
- 单击目标 App 请求中的 跳转到移动端查看 按钮，支持跳转到客户端监控的 App 页面查看更多信息。
同时，前往客户端监控的 App 页面，支持跳转到应用性能监控的 Trace 详情页。
- 登录 客户端监控控制台。
- 单击目标应用服务名称，并在应用管理页面单击 App 端监控 中的 使用服务，前往 App 端监控管理页面。
- 在左侧导航栏选择 全部功能 > 网络分析 > HTTP，前往网络概览页面。
- 在左侧选择分析指标，右侧选择分析维度，单击 网络详情，前往 日志检索 页面，查看更多详细信息。
- 在日志检索页面的详细信息栏，单击全链路 Trace 下方的链接，可跳转到服务端的 单链路查询 页面，查看更多信息。
Web 应用和服务端应用正确接入后，从 Web 端发起的请求将发送到服务端应用，可前往应用性能监控 Trace 详情页查看 Web 请求的 Span，而且，支持跳转到客户端监控的 WebPro 页面查看更多信息。
- 登录 应用性能监控控制台。
- 搜索目标服务，单击服务名称，前往目标服务的管理页面。
- 在左侧导航栏选择 Trace 分析，前往 Trace 分析页面。
- 根据实际情况，通过时间、标签、Span 属性、Trace ID、Span 类型、服务名等条件筛选目标 Trace，单击目标 TraceID，前往 单链路详情 页面。
- 单击目标 Web 请求中的 跳转到 WebPro 查看 按钮，支持跳转到客户端监控的 WebPro 页面查看更多信息。
同时，前往客户端监控的 Webpro 页面，支持跳转到应用性能监控的 Trace 详情页。
- 登录 客户端监控控制台。
- 单击目标应用服务名称，并在应用管理页面单击 WebPro 端监控 中的 使用服务，前往 WebPro 端监控管理页面。
- 在左侧导航栏选择 全部功能 > 数据探索，前往数据探索页面。
- 选择维度并切换到 Requests 页签，单击目标请求名称，查看请求相关详细信息。
- 单击 Trace 中的 rum_trace_id，可跳转到应用性能监控的 Trace 详情页，查看更多信息。
小程序 Pro 应用和服务端应用正确接入后，从小程序 Pro 端发起的请求将发送到服务端应用，可前往应用性能监控 Trace 详情页查看 Web 请求的 Span，而且，支持跳转到客户端监控的小程序 Pro 页面查看更多信息。
- 登录 应用性能监控控制台。
- 搜索目标服务，单击服务名称，前往目标服务的管理页面。
- 在左侧导航栏选择 Trace 分析，前往 Trace 分析页面。
- 根据实际情况，通过时间、标签、Span 属性、Trace ID、Span 类型、服务名等条件筛选目标 Trace，单击目标 TraceID，前往 单链路详情 页面。
- 单击目标小程序请求中的 跳转到小程序 Pro 查看 按钮，支持跳转到客户端监控的小程序 Pro 页面查看更多信息。
同时，前往客户端监控的小程序 Pro 页面，支持跳转到应用性能监控的 Trace 详情页。
- 登录 客户端监控控制台。
- 单击目标应用服务名称，并在应用管理页面单击 小程序 Pro 监控 中的 使用服务，前往 WebPro 端监控管理页面。
- 在左侧导航栏选择 全部功能 > 数据探索，前往数据探索页面。
- 选择维度并切换到 Http 页签，单击目标请求名称，查看请求相关详细信息。
- 单击 Trace 中的 TraceID，可跳转到应用性能监控的 Trace 详情页，查看更多信息。
最近更新时间：2026.02.10 19:56:32
这个页面对您有帮助吗？
有用
有用
无用
无用