AIKraft/Skills/OTel: стиль Python

OTel: стиль Python

Python OpenTelemetry style: module-scope tracers/meters, decorators for bounded work, error spans, logs, and no wrappers.

SUSuperlog official Разработка

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

Навык описывает стиль использования OpenTelemetry в Python, предписывая инициализацию трассировщиков и измерителей на уровне модуля. Он регламентирует применение декораторов и контекстных менеджеров для ограничения области видимости операций (bounded work) и обработки ошибок.

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

  • Инициализация глобальных объектов tracer и meter для модуля
  • Создание счетчиков (counters) с указанием единиц измерения
  • Оборачивание функций в spans с использованием декораторов
  • Управление контекстом трассировки через контекстные менеджеры
  • Установка статуса и кода ошибки для spans

Как работает

  1. Импортировать модули opentelemetry.metrics, opentelemetry.trace и классы Status, StatusCode
  2. Получить объекты tracer и meter через функции get_tracer и get_meter на уровне модуля
  3. Создать метрики, например счетчик, с помощью метода create_meter
  4. Использовать метод start_as_current_span как декоратор для всей функции или как контекстный менеджер
  5. Устанавливать статус ошибки через объект Status и StatusCode при необходимости

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

Как правильно инициализировать tracer и meter для модуля voice?
Примени декоратор OpenTelemetry к функции обработки запроса
Как создать счетчик доставленных приветствий с единицей измерения?

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

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

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

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