---

name: sentry-server description: Enforces project server-side Sentry monitoring conventions when implementing error tracking, performance monitoring, and breadcrumb logging in server actions, facades, middleware, and API routes. This skill ensures consistent patterns for context setting, breadcrumb categories, error capture, and performance spans.

Sentry Server Monitoring Skill

Purpose

This skill enforces the project server-side Sentry monitoring conventions automatically during error tracking implementation. It ensures consistent patterns for context setting, breadcrumb categories, error capture, performance spans, and middleware integration.

Note: For client-side/front-end Sentry patterns, use the sentry-client skill instead.

Activation

This skill activates when working on server-side code:

• Creating or modifying server actions in src/lib/actions/
• Implementing error handling in facades (src/lib/facades/)
• Setting up performance monitoring spans in server code
• Adding breadcrumbs in server-side operations
• Working with middleware (src/middleware.ts, src/lib/middleware/)
• API routes (src/app/api/)
• Instrumentation files (src/instrumentation.ts)

Workflow

1. Detect server-side Sentry work (imports from @sentry/nextjs in server files)
2. Load references/Sentry-Server-Conventions.md
3. Generate/modify code following all conventions
4. Scan for violations of Sentry patterns
5. Auto-fix all violations (no permission needed)
6. Report fixes applied

Key Patterns

Server Actions

• Set context at the start with Sentry.setContext(SENTRY_CONTEXTS.*, {...})
• Add breadcrumbs for successful operations
• Log non-critical failures (e.g., cache invalidation) with level: 'warning'

Facades

• Add breadcrumbs for non-blocking operations (Cloudinary cleanup)
• Capture non-critical exceptions without failing the operation

Middleware

• Use Sentry.withScope and Sentry.startSpan for performance tracking
• Set tags and context within the scope

Instrumentation

• Export onRequestError = Sentry.captureRequestError for RSC error capture

Constants (Always Use)

Helper Utilities (Recommended)

Import from @/lib/utils/sentry-server/breadcrumbs.server:

For Server Actions

For Facades

See references/Sentry-Server-Conventions.md for complete documentation with examples.

Usage Pattern Reference

File Patterns

This skill applies to:

• src/lib/actions/**/*.ts
• src/lib/facades/**/*.ts
• src/lib/middleware/**/*.ts
• src/middleware.ts
• src/app/api/**/*.ts
• src/instrumentation.ts
• sentry.server.config.ts
• sentry.edge.config.ts

References

• references/Sentry-Server-Conventions.md - Complete server-side Sentry monitoring conventions