NeMo Relay 可观测性插件
为 NeMo Relay 选择并配置事件与追踪导出。
文档明确建议合成非敏感载荷、先清洗再导出、运行时注入凭据、TLS校验、禁止在配置或诊断中暴露凭据,并说明订阅者注册范围与生命周期,安全边界较清晰。因未要求用户确认外部传输、未提供回滚/隔离方案,且默认可发送到远程sink,扣6分。
共享生命周期、flush/shutdown、常见失败场景、传输限制和排障检查均有说明。静态阅读未执行代码,缺少本技能专属可复现测试、完整绑定示例及异常输入反馈,因此按静态上限保守给9分。
目标用户、五类输出、语言绑定和相邻技能边界较明确,具备较好的语义触发指引。未说明输入输出参数的完整契约、非适用范围、中文使用支持或中国大陆网络可达性,扣5分。
目录层次清楚,按需加载四个参考文档,并包含许可证、作者、版本、评估报告、相关技能和部分风险说明。缺少Instructions与Examples章节,作者格式不符合报告中的校验要求,维护责任和更新路径也不够具体,扣5分。
内容覆盖选择输出、注册运行、导出和验证,能够直接指导核心观测配置;但选定参考文件之外的实际API细节不完整,且静态审查无法确认结果可直接运行,因此受静态上限限制为7分。
有固定修订版本、参考文档、评估报告和20项评估任务/结果,具备一定审计线索。评估材料缺少可独立复核的运行产物,本技能没有提交覆盖关键路径的测试套件或CI证据,因此不超过静态上限5分。
- 将事件发送到远程stream、OTLP或OpenInference后可能包含业务输入输出;生产环境启用前必须确认数据接收方、脱敏范围和保留策略。
- 文档未提供完整的安装、版本兼容矩阵和各语言可运行示例;使用前应核对实际NeMo Relay绑定API及传输支持。
- 评估报告声明通过,但仅凭静态材料无法独立复现其结果,也不能替代真实环境验证。
- 未说明中国大陆网络可达性;依赖远程观测后端时需单独确认网络、TLS和认证链路。
这个 Skill 能做什么,适合哪些场景?
该技能指导用户通过内置 Observability 插件、订阅器或导出器配置 NeMo Relay 可观测性。它覆盖原始 ATOF JSONL 事件、ATIF 轨迹、OpenTelemetry 追踪、OpenInference 导出和自定义事件处理。技能建议先验证一种输出,再增加其他遥测目的地,并强调对生产载荷进行清洗。它适合需要检查、记录、分析或导出 Relay 规范事件流的开发者。
指导创建、注册、刷新、注销和关闭订阅器或导出器;帮助在 ATOF、ATIF、OpenTelemetry、OpenInference 和手动订阅之间选择;说明全局订阅器、作用域本地订阅器和插件安装订阅器的生命周期;解释事件流、LLM 注释、技能加载标记以及 ATOF data 字段和类型化 profile 数据;根据所选输出读取对应的 references/atof.md、references/atif.md、references/opentelemetry.md 或 references/openinference.md。
- NeMo Relay 开发者需要在短生命周期进程中检查控制台事件或自定义事件时,使用手动订阅器。
- 调试人员需要保留未经转换的规范生命周期事件并进行离线检查时,选择 ATOF JSONL。
- 构建跨系统执行轨迹的团队需要便携式轨迹格式时,选择 ATIF。
- 已有 OTLP 追踪基础设施的工程师需要导出通用追踪时,选择 OpenTelemetry。
- 使用 OpenInference 语义追踪后端的团队需要导出相应数据时,选择 OpenInference。
这个 Skill 有哪些优点和局限?
- 覆盖 ATOF、ATIF、OpenTelemetry 和 OpenInference 等多种输出。
- 同时说明插件、全局订阅器和作用域本地订阅器的生命周期。
- 强调先用合成非敏感载荷验证,并在生产导出前完成清洗。
- 提供 Python、Node.js、Rust 和 Go 的绑定名称。
- 源材料没有提供各 reference 文件的具体配置示例或完整代码。
- 没有说明支持的 NeMo Relay 版本、运行环境版本或平台矩阵。
- 提供的材料没有展示该单独技能的测试套件或测试结果。
- 技能只负责可观测性配置;未插桩的调用应使用其他 NeMo Relay 技能。
如何安装这个 Skill?
使用仓库 README 支持的 skills CLI 安装目标技能:npx skills add nvidia/skills --skill nemo-relay-plugin-observability --yes。README 未说明该技能的独立包安装方式,也未要求手动克隆仓库或复制目录。
如何使用这个 Skill?
让兼容 Agent Skills 的代理执行类似“为 NeMo Relay 配置 OpenTelemetry 可观测性,并先验证一个合成的非敏感载荷”的请求。技能会先建议选择一种输出,然后指导在相关作用域工作前注册唯一名称,运行已插桩的 Relay 工作,并在需要确定性交付时刷新,最后注销并关闭组件。具体语言绑定名称包括 Python、Node.js、Rust 和 Go 的相应订阅器或导出器 API。
这个 Skill 与同类方案有什么区别?
技能明确区分内置 Observability 插件与手动订阅器或导出器 API:插件适合可复用、配置驱动的进程配置;手动 API 适合测试、脚本或需要直接控制注册名称、采集窗口和刷新时机的应用。