sentry-nestjs-sdk

Sentry NestJS SDK is an opinionated setup wizard for adding Sentry to a NestJS application using the @sentry/nestjs package. The referenced APIs reflect @sentry/nestjs 10.x with NestJS 8 through 11 supported, and it covers both the Express (default) and Fastify adapters as well as GraphQL, microservices, WebSockets, and background jobs. It is the skill to use for requests like adding Sentry to NestJS or configuring error monitoring, tracing, profiling, logging, metrics, crons, or AI monitoring in a NestJS service.

Work proceeds in phases. The Detect phase runs a series of grep and node commands to understand the project before recommending anything: confirming it is a NestJS app and its version, checking for an existing Sentry install and instrument.ts, spotting a Sentry dependency-injection wrapper or a typed config class, seeing whether SentryModule.forRoot is already registered, and detecting the HTTP adapter, GraphQL, microservices, WebSockets, task queues such as Bull, BullMQ, or @nestjs/schedule, databases, AI libraries, and a companion frontend. The Recommend phase leads with a concrete proposal rather than open questions, always recommending error monitoring and tracing, and adding profiling, logging, metrics, crons, or AI monitoring when the corresponding signals are detected.

The Guide phase installs the SDK, optionally with @sentry/profiling-node, and follows a required three-file initialization pattern, needed because Sentry must patch Node.js modules through OpenTelemetry before NestJS loads. It warns against installing @sentry/node alongside @sentry/nestjs, since the latter re-exports it and installing both causes duplicate registration, and it accounts for enterprise patterns by using an injected Sentry proxy where a DI wrapper exists and by adding new options to a config class rather than hardcoding per-environment values. Detected integrations map to reference files for error monitoring, tracing, profiling, logging, metrics, crons, and AI monitoring.