AIKraft/AI/Войти
AIKraft/Skills/OTel: стиль LiveKit

OTel: стиль LiveKit

LiveKit Agents OpenTelemetry style: entrypoint/session lifecycle spans, shutdown callbacks, session metrics, and LLM turn token counters.

SUSuperlog official Другое

Что делает навык

Набор практик для внедрения OpenTelemetry в LiveKit Agents, обеспечивающий трассировку жизненного цикла сессии и метрику LLM. Skill определяет правила создания спанов, регистрации метрик и атрибутов для мониторинга голосовых агентов.

Когда применять

  • Настройка спана жизненного цикла сессии (voice.session) с завершением в callback shutdown.
  • Регистрация метрик начала сессии (counter) и её длительности (histogram).
  • Создание спанов и счётчиков токенов для каждого вызова LLM.
  • Добавление атрибутов контекста (tenant, provider, model) к метрикам LLM.
  • Проведение smoke-тестов агента через локальный OTLP endpoint.

Как работает

  1. В функции entrypoint инициализировать спан voice.session и запустить метрику voice.sessions.started.
  2. Зарегистрировать функцию on_shutdown через ctx.add_shutdown_callback для завершения спана и записи метрики voice.session.duration_ms.
  3. Оборачивать отдельные операции (например, _deliver_initial_greeting) декоратором start_as_current_span.
  4. Для каждого вызова LLM создавать спан с именем операции (например, llm.voice_response) и фиксировать токены через llm.tokens.input/output.
  5. Заполнять атрибуты метрик LLM: tenant.id, llm.provider, llm.model, llm.use_case, outcome.
  6. Игнорировать метрику llm.cost_usd, так как стоимость рассчитывается централизованно.

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

Настрой трассировку сессии LiveKit агента по стилю OTel: спаны entrypoint/shutdown и метрики длительности.
Добавь instrumentation для вызовов LLM: спаны операций и счётчики токенов с атрибутами провайдера.
Проверь smoke-путь агента, запустив спан или лог через локальный OTLP endpoint.

Что понадобится

  • Библиотека OpenTelemetry (tracer, meter, trace)
  • Среда выполнения LiveKit Agents (JobContext, async entrypoint)
  • Локальный OTLP endpoint для smoke-проверок

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «otel-livekit-style» из репозитория: # https://github.com/superloglabs/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r otel-livekit-style/ ~/.claude/skills/otel-livekit-style/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.