APMPlusExporter 将 span 数据以 OTLP（gRPC）协议上报至火山引擎 APMPlus 平台。除追踪链路外，它还会通过内置的指标上报器采集模型调用次数、token 用量、操作耗时、异常次数以及工具耗时等指标，写入 APMPlus 的指标面板。
启用内容追踪时，模型输出中的推理内容以
reasoning 类型标注，与普通文本内容区分，便于在 APMPlus 中单独查看推理过程。何时使用
- 需要在火山引擎 APMPlus 平台上统一观测智能体的调用链路；
- 需要模型级别的指标分析，如 token 消耗、调用延迟与错误率；
- 生产环境中需要成本追踪与性能监控。
使用示例
APMPlusExporterConfig 显式传入连接参数：
参数
构造参数
APMPlusExporter 的连接参数由 config 字段承载，类型为 APMPlusExporterConfig；不传时各字段自动从对应环境变量读取。
APMPlus 连接配置
config 为 APMPlusExporterConfig，各字段默认从 APMPlusConfig 读取，环境变量如下：
app_key 未通过环境变量提供时，导出器会根据云服务商自动获取 APMPlus 令牌：火山引擎模式使用 open.volcengineapi.com，BytePlus 模式使用 open.byteplusapi.com，因此需要配置对应云服务商的有效凭证（火山引擎使用 VOLCENGINE_ACCESS_KEY / VOLCENGINE_SECRET_KEY，BytePlus 使用 BYTEPLUS_ACCESS_KEY / BYTEPLUS_SECRET_KEY；使用临时凭证时还需提供对应的 Session Token）。endpoint 使用 gRPC 协议、以非加密方式连接。endpoint 的默认值根据云服务商与地域动态生成。火山引擎模式下，地域依次取自 REGION 环境变量与默认值 cn-beijing；BytePlus 模式下，地域依次取自 BYTEPLUS_REGION 环境变量与默认值 ap-southeast-1。云服务商由 AGENTKIT_CLOUD_PROVIDER 或 CLOUD_PROVIDER 环境变量决定，默认为火山引擎。环境变量配置
Agent 依据环境变量自动挂载 APMPlus 导出器，无需显式构造：
如果初始化
OpentelemetryTracer 时已存在全局 TracerProvider，VeADK 将复用该 provider 并自动移除 APMPlusExporter，因为已存在的 provider 被视为已负责 APMPlus 的链路数据上报。可通过 apmplus_managed_externally 属性确认此状态，详见可观测概述。