К основному содержанию
скилл CX Codex

nemo-relay-plugin-observability — скилл для Claude Code

Скилл nemo-relay-plugin-observability для Claude Code помогает выбрать и настроить экспортеры и подписчики для телеметрии NeMo Relay версий 0.6 и 0.7.

Apache-2.0 140 установок ★ 4 106 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add NVIDIA/skills --skill nemo-relay-plugin-observability -a claude-code
Открыть на GitHub

Что делает nemo-relay-plugin-observability

Скилл задаёт конфигурацию мониторинга через встроенные плагины, подписчики и экспортеры, поддерживая сырые события ATOF, траектории ATIF, OpenTelemetry и OpenInference. Выбор зависит от целевой версии Relay, так как в версии 0.6 используются раздельные конфигурации для OpenTelemetry и OpenInference, а в версии 0.7 применяется единый типизированный экспортер с проекциями full, gen_ai и openinference.

Перед началом работы требуется определить версию пакета в манифесте или файле блокировки зависимостей. Поддерживается работа с Python, Node.js, Rust и Go с вызовом соответствующих API регистрации и экспорта. По умолчанию для локальной отладки рекомендуется использовать ATOF, а перед передачей данных на продакшен-экспортеры следует настроить санитайзеры полезной нагрузки.

Запускайте скилл при выборе или настройке наблюдения в NeMo Relay, а также для подключения OpenTelemetry и обработки событий.

Какие задачи решает

  • настроить экспортеры телеметрии для NeMo Relay
  • выбрать конфигурацию под версию 0.6 или 0.7
  • подключить трассировку через OpenTelemetry
  • собрать сырые события ATOF или траектории ATIF

Примеры запросов агенту

  • Настрой телеметрию NeMo Relay 0.7 через OpenTelemetry
  • Помоги выбрать экспортер для сырых событий ATOF в NeMo Relay 0.6
  • Зарегистрируй подписчик OpenInference для проекта на NeMo Relay

Как установить nemo-relay-plugin-observability

1Через Skills CLI (Vercel)

npx skills add NVIDIA/skills --skill nemo-relay-plugin-observability -a claude-code

2Вручную: положить файлы

~/.claude/skills/nemo-relay-plugin-observability/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/nemo-relay-plugin-observability/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о nemo-relay-plugin-observability

Как установить nemo-relay-plugin-observability в Claude Code?

Выполните в терминале npx skills add NVIDIA/skills --skill nemo-relay-plugin-observability -a claude-code, а затем обратитесь к файлу ~/.claude/skills/nemo-relay-plugin-observability/SKILL.md.

Что делает nemo-relay-plugin-observability?

Скилл помогает настраивать мониторинг, экспортеры и подписчики для платформ NeMo Relay версий 0.6 и 0.7, включая сбор логов, трассировок OpenTelemetry и данных OpenInference.

Что нужно для работы nemo-relay-plugin-observability?

Требуется установленный проект на NeMo Relay версии 0.6 или 0.7 на Python, Node.js, Rust или Go.

Исходный текст

SKILL.md · Apache-2.0
---
name: nemo-relay-plugin-observability
description: Use this skill when choosing or configuring NeMo Relay 0.6 or 0.7 observability through the built-in plugin, subscribers, or exporters, including raw ATOF events, ATIF trajectories, OpenTelemetry, OpenInference, or custom event handling.
license: Apache-2.0
metadata:
  author: NVIDIA Corporation and Affiliates
---

# Configure Observability Plugins

Start with one exporter managed by the built-in Observability plugin. This is
the default for reusable process configuration and the best first plugin for
most users because it makes Relay's captured activity visible.
Choose one proof output before layering additional telemetry destinations.

Use manual subscriber or exporter APIs only when a test, script, or application
needs direct control over registration names, collection windows, or flush
timing. Both paths consume the same canonical event stream.

## Select The Relay Version

Determine whether the application uses NeMo Relay 0.6 or 0.7 before proposing
configuration or binding APIs. Prefer the installed package version, lockfile,
or manifest. Ask the user when the version cannot be established; do not mix
the two surfaces in one example.

- **0.6** uses observability configuration version 2. OpenTelemetry and
  OpenInference are separate exporters with `OpenTelemetryConfig` /
  `OpenTelemetrySubscriber` and `OpenInferenceConfig` /
  `OpenInferenceSubscriber`.
- **0.7** uses observability configuration version 3. One typed OpenTelemetry
  exporter provides `full`, `gen_ai`, and `openinference` projections.

## Choose The Output

Select the output that best matches the user's immediate inspection target:

- **Console or custom event handling**
  Use a manual subscriber for short-lived in-process inspection.
- **Raw canonical lifecycle events**
  Use ATOF JSONL; read `references/atof.md`.
- **Portable execution trajectories**
  Use ATIF; read `references/atif.md`.
- **OTLP tracing**
  For 0.6, choose the separate OpenTelemetry or OpenInference exporter. For
  0.7, choose a typed OpenTelemetry endpoint (`full`, `gen_ai`, or
  `openinference`). Read `references/opentelemetry.md` and, for an
  OpenInference-aware backend, `references/openinference.md`.

Choose one output first and verify it before adding another. ATOF is the
default local proof because it preserves the raw event stream with the least
translation. Use synthetic, non-sensitive payloads for the first proof. Add and
verify sanitization before exporters receive production payloads, and never
display complete event records while validating an exporter.

## Embedded Event And Subscriber Model

Use this model when explaining how capture and export relate:

- NeMo Relay emits one canonical event stream from scopes, marks, managed tool
  calls, managed LLM calls, middleware, and manual lifecycle APIs.
- Subscribers consume events without defining the event model. Multiple
  subscribers can observe the same stream for logging, export, analytics, or
  diagnostics.
- Global subscribers remain active process-wide until removed.
- Scope-local subscribers are owned by one active scope and disappear when that
  scope closes.
- Plugin-installed subscribers are reusable, configuration-driven runtime
  components.
- Exporter-oriented subscribers preserve raw ATOF or translate the event stream
  into ATIF or the version-appropriate OpenTelemetry/OpenInference form.
- Event payloads reflect sanitized post-guardrail input and output when calls
  use managed helpers or manual lifecycle params provide those fields.
- LLM annotations follow the freshness rules:
  - Each owning agent scope starts fresh, and a `compaction` mark refreshes it.
  - The first subsequent LLM start retains complete annotation history. Later
    starts retain system instructions, the latest user message, and every
    following assistant or tool message.
  - When a request codec supplies an annotation, Relay applies the same
    event-only projection to provider-shaped event input without changing
    provider execution.
- Event fields include semantic input/output through the ATOF `data` field,
  typed profile data such as `model_name` and `tool_call_id`, and codec-provided
  annotated LLM request/response data for in-process subscribers and exporters.
- First-class skill tools and the requests to read a complete `SKILL.md`
  automatically emit `skill.load` marks under the tool span. The payload
  contains only `skill_name`; metadata records the load source and tool name.
  Partial reads do not count, and ambiguous slash-command expansions use the
  separate `skill.load.inferred` name. The eager mark remains present if tool
  execution later fails.

## Shared Lifecycle

1. Create the exporter or subscriber.
2. Register it with a unique name before the relevant scoped work.
3. Run NeMo Relay-instrumented work inside scopes.
4. Flush and deregister in the exporter-specific reference's documented order.
5. Shut it down when the process or subsystem is done.

## Binding Names

Use the names exported by the selected language binding and Relay version:

- Python 0.6: `nemo_relay.subscribers.register(...)`, `AtofExporter`,
  `AtifExporter`, `OpenTelemetrySubscriber`, and `OpenInferenceSubscriber`
- Python 0.7: the same registration and file exporters, plus
  `OpenTelemetrySubscriber` for all three typed projections
- Node.js follows the same 0.6/0.7 split through its root exports
- Rust: `nemo_relay::api::subscriber` and `nemo_relay::observability::*`
- Go: source-first wrappers expose equivalent register, exporter, and subscriber
  lifecycle methods

## Load A Reference When

Load only the reference required by the selected output:

- Load `references/atof.md` for raw JSONL events used in local debugging or
  offline inspection.
- Load `references/atif.md` for ATIF trajectories.
- Load `references/opentelemetry.md` for OTLP/OpenTelemetry traces.
- Load `references/openinference.md` for the standalone 0.6 OpenInference
  exporter or the 0.7 `openinference` OpenTelemetry projection.

## Use Another Skill When

Choose another skill when the task belongs to an adjacent workflow:

- Use `nemo-relay-plugin-build` to package subscriber-based export behavior as
  a reusable plugin.
- Use `nemo-relay-get-started` or `nemo-relay-instrument-calls` when no scope,
  tool call, or LLM call has been instrumented.
- Use `nemo-relay-debug-runtime-integration` to diagnose missing telemetry.

## Related Skills

Use these skills for adjacent workflows:

- Instrument application calls with `nemo-relay-instrument-calls`.
- Add typed wrappers with `nemo-relay-instrument-typed-wrappers`.
- Package reusable behavior with `nemo-relay-plugin-build`.
- Diagnose missing events with `nemo-relay-debug-runtime-integration`.

© NVIDIA Corporation and Affiliates · Apache-2.0 · NVIDIA/skills

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
rag-observability-evals devops-skills Скилл rag-observability-evals для мониторинга и оценки RAG-систем: метрики качества поиска, проверка обоснованности ответов, детекция галлюцинаций и регрессионное тестирование. CX Codex +1 353установок observability-and-instrumentation addyosmani Скилл observability-and-instrumentation для Claude Code учит ИИ добавлять в код логи, метрики, трейсинг и корреляционные ID. Включается при добавлении фич в продакшн для наблюдения за поведением системы. CX Codex +1 70 700установок golang-observability samber Скилл golang-observability для Claude Code: инструментирует Go-сервисы логами, метриками, трейсами, профилированием и RUM. Накрывает прод наблюдаемостью по пяти сигналам. CX Codex +1 42 300установок app-observability grafana Скилл app-observability ведёт агента по настройке Grafana Cloud: RED-метрики из OTel-трейсов, карты сервисов, браузерный RUM через Faro и наблюдение за вызовами LLM. CX Codex +1 4 800установок monitoring-observability akillness Скилл monitoring-observability превращает заметки о сервисе, данных или live-ops в план мониторинга: выбирает режим, сигналы и первый небольшой шаг внедрения. CX Codex +1 371установок agent-observability devops-skills Скилл agent-observability для Claude Code, Codex, Cursor и других платформ: добавляет трейсинг, счётчики токенов, измерение задержек и отслеживание стоимости LLM-вызовов. Подключается к агентам, RAG-пайплайнам и мультиагентным оркестрациям. CX Codex +1 373установок

Из того же набора312

Весь набор →
doca-container-deployment Скилл doca-container-deployment для Claude Code развёртывает DOCA-сервисы в контейнерах на BlueField через kubelet standalone. Запускает Argus, DMS, Firefly и UROM в pod-спеках и диагностирует сбои. CX Codex +1 145установок doca-gpunetio Скилл помогает писать и отлаживать DOCA GPUNetIO: связывать CUDA-ядро с сетевой очередью и проверять поддержку GPU. CX Codex +1 144установок doca-dma Скилл помогает писать и отлаживать код для копирования данных через DOCA DMA. Он пригодится при настройке memcpy между памятью хоста и DPU. CX Codex +1 143установок doca-comch Скилл doca-comch для Claude Code помогает настраивать обмен сообщениями между хостом и BlueField через DOCA Comch. Он подключается при работе с ролями клиента и сервера, режимами передачи и ошибками API. CX Codex +1 142установок doca-compress Скилл doca-compress для Claude Code помогает переносить сжатие DEFLATE и распаковку DEFLATE или LZ4 на DOCA Compress. Он подключается при настройке задач сжатия и разборе ошибок аппаратного ускорителя. CX Codex +1 140установок doca-dms Скилл doca-dms для Claude Code управляет NVIDIA DOCA Management Service на BlueField, хосте или в Kubernetes. Выполняет локальные операции через dms-cli и удалённые gNMI/gNOI-операции. CX Codex +1 138установок doca-eth Помогает настроить очереди пакетов DOCA Ethernet на сетевых картах ConnectX и DPU BlueField, выбрать тип RX-очереди и разобрать ошибки передачи. CX Codex +1 137установок doca-sha Скилл doca-sha для Claude Code помогает работать с аппаратным ускорением SHA на BlueField-2 через DOCA. Выбирает режим хеширования и разбирает ошибки. CX Codex +1 131установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой