SuperAPI AI 工具集

nemo-relay-export-otel

编程与开发

查看项目

更新于 10-16 02:34

技能介绍

用途:当追踪目的地是 OTLP/OpenTelemetry 后端时使用本技能,将 NeMo Relay 运行时事件导出为 OTLP 追踪数据。

必要用法:构建绑定专属的 OpenTelemetryConfig,设置 endpoint、服务名与所需 headers;构造 subscriber,并在运行作用域工作前注册;进程或子系统结束时注销、flush 并关闭。

主要配置项:传输方式、endpoint、service_name、可选的 namespace 与 version、instrumentation scope、headers、资源属性与超时。默认建议从 http_binary 传输和 OTLP traces endpoint(如本地 collector 的 4318 端口)开始,除非部署要求不同;grpc 传输需 Tokio 运行时处于活动状态。

实践要点:在应用代码中使用显式配置对象,环境变量可被底层 exporter 采用但不应作为应用行为的唯一来源;在首个被插桩的请求前注册,使用稳定的服务标识,不把认证与端点写入源码,优雅关闭时 flush,生产导出前对敏感载荷脱敏。

验证方式:检查 subscriber 构造、collector 请求、后端中 scopes/tools/LLMs 的 span,以及按根 scope 的 span 分组。

需确认事项:传输选 http_binary 还是 grpc、endpoint 与认证 headers、服务命名与资源属性、是否需要退出前确定性 flush、所选绑定与目标是否支持所需传输。

常见问题:看不到 span、endpoint 或认证 headers 错误、事件在非活动作用域外发出、无 Tokio 运行时却选择 grpc、遗漏注册/注销或 flush/关闭步骤。

限制:资料未提供具体代码示例、支持的绑定清单、版本要求或收费信息。