vtex-io-observability-and-ops — скилл для Claude Code: как установить

Что делает vtex-io-observability-and-ops

Скилл помогает сделать бэкенд-сервис на VTEX IO понятнее в продакшене. Агент следит, чтобы в маршрутах и обработчиках событий ошибки не глотались молча: сбой уходит в ctx.vtex.logger с уровнем error и контекстом (orderId, account), а потом пробрасывается дальше. Вместо console.log используется штатный логгер платформы, потому что только его записи собираются и ищутся в стеке VTEX.

Для важных вызовов клиентов к внешним API скилл требует поле metric с осмысленным именем, например partner-get-order. По таким именам можно следить за задержками и долей ошибок. Для API с жёсткими лимитами он советует сочетать короткие таймауты, повторы с паузами и кеш частых чтений.

Пустой catch с return скилл считает ошибкой, а токены, заголовки авторизации и сырые тела запросов в логах — утечкой. Фронтенд-аналитику и браузерный мониторинг он не покрывает.