Skip to main content
TLSExporter 将 span 数据以 OTLP(HTTP)协议上报至火山引擎日志服务 TLS。数据按 TLS 主题组织,适合集中存储、长期留存与跨服务的链路分析。

何时使用

  • 需要将智能体的执行链路集中存储在火山引擎日志服务 TLS;
  • 需要长期留存与合规审计的追踪数据;
  • 需要结合 TLS 的告警与分析能力进行观测。

使用示例

TLS 接入通常分两步:先用 VeTLS 客户端创建日志项目与追踪实例,再用 TLSExporter 上报数据。
不显式传入 config 时,topic_id 会在缺省情况下自动获取追踪主题 ID:

参数

构造参数

TLSExporter 的连接参数由 config 字段承载,类型为 TLSExporterConfig;不传时各字段自动从对应环境变量读取。

TLS 连接配置

config 为 TLSExporterConfig,各字段默认从 TLSConfig 及火山引擎凭证读取,环境变量如下:
topic_id 未通过 OBSERVABILITY_OPENTELEMETRY_TLS_SERVICE_NAME 提供时,导出器会调用 VeTLS 自动获取追踪主题 ID,因此需要配置有效的火山引擎凭证(VOLCENGINE_ACCESS_KEY 与 VOLCENGINE_SECRET_KEY)。

环境变量配置

也可以让 Agent 依据环境变量自动挂载 TLS 导出器,无需显式构造:
设置 ENABLE_TLS=true 后,即便智能体未显式提供 tracers,Agent 也会自动创建 OpentelemetryTracer 并挂载 TLSExporter。
最后修改于 2026年9月19日