# sentry-node-sdk

Скилл сканирует проект и ведёт по шагам подключения Sentry к серверному JavaScript и TypeScript: ошибки, трейсинг, логи, кроны.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3300 установок · ★ 272
- Автор: getsentry
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/getsentry/sentry-for-ai/tree/HEAD/skills-legacy/sentry-node-sdk/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/sentry-node-sdk

## Что делает

Скилл работает как мастер: сначала сам смотрит, что у вас за рантайм и стек, потом предлагает конкретный набор функций. Проверяет версии `bun`, `deno`, `node`, ищет в `package.json` пакеты `@sentry/*`, фреймворки вроде Express, Fastify, Koa, Hapi, Elysia, Hono, библиотеки логирования (`winston`, `pino`, `bunyan`), планировщики (`node-cron`, Bull, Agenda) и клиенты LLM. Отдельно выясняет, ESM у вас или CommonJS, и есть ли уже файл `instrument.js` или `instrument.mjs` — если есть, скилл вливает настройки в него, а не перезаписывает.

Дальше идёт рекомендация, а не допрос: базово предлагаются мониторинг ошибок и трейсинг, остальное — по обстоятельствам. Профилирование доступно только на Node.js, на Bun и Deno его нет. Если в проекте уже есть OpenTelemetry-трейсинг, скилл уводит на путь OTLP через `otlpIntegration()` и советует не выставлять `tracesSampleRate` — нативная трассировка и профилирование в этом случае не подключаются. Для NestJS и Next.js он отправляет к другим скиллам: `sentry-nestjs-sdk` и `sentry-nextjs-sdk`.

Перед реализацией стоит сверить версии пакетов с документацией Sentry: в тексте скилла они привязаны к моменту написания. ESM-проектам нужен запуск через `--import ./instrument.mjs`, для Bun — `--preload`, а в Deno пакет подключается как `npm:@sentry/deno`. Это те места, где установка чаще всего ломается.

## Требования
- Работает с: Sentry

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add getsentry/sentry-for-ai --skill sentry-node-sdk -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/sentry-node-sdk/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/sentry-node-sdk/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add getsentry/sentry-for-ai --skill sentry-node-sdk -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/sentry-node-sdk/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add getsentry/sentry-for-ai --skill sentry-node-sdk -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/sentry-node-sdk/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install getsentry/sentry-for-ai sentry-node-sdk
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/sentry-node-sdk/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add getsentry/sentry-for-ai --skill sentry-node-sdk -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/getsentry/sentry-for-ai --path skills-legacy/sentry-node-sdk
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/sentry-node-sdk/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add getsentry/sentry-for-ai --skill sentry-node-sdk -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/getsentry/sentry-for-ai/tree/HEAD/skills-legacy/sentry-node-sdk/SKILL.md

## Когда брать
- подключить Sentry к серверному приложению на Node.js, Bun или Deno
- разобраться, нужен ли OTLP-путь, если в проекте уже есть OpenTelemetry
- добавить мониторинг ошибок в Express, Fastify, Koa или Hapi
- настроить отслеживание пропущенных и упавших задач по расписанию
- включить сбор логов из winston или pino с привязкой к трейсам

## Примеры запросов агенту
- добавь Sentry в моё Node.js-приложение
- настрой @sentry/bun для этого проекта
- подключи мониторинг ошибок и трейсинг к Fastify

## Похожие
- [sentry-go-sdk](https://affpapa.org/nevibecode/skills/getsentry-sentry-go-sdk.md) — скилл · 316 установок
- [sentry](https://affpapa.org/nevibecode/skills/sentry.md) — скилл · 4 установки
- [sentry-cocoa-sdk](https://affpapa.org/nevibecode/skills/getsentry-sentry-cocoa-sdk.md) — скилл · 328 установок
- [fix-sentry-issues](https://affpapa.org/nevibecode/skills/fix-sentry-issues.md) — скилл · 2700 установок
- [Sentry Bug Fixer](https://affpapa.org/nevibecode/prompts/sentry-bug-fixer.md) — промпт · ★ 174597
- [sentry-triage](https://affpapa.org/nevibecode/plugins/sentry-triage.md) — плагин · ★ 40418

Из того же набора: [getsentry/sentry-for-ai](https://affpapa.org/nevibecode/by/getsentry/sentry-for-ai.md) — 31 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md