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。