playbooks

home / skills / jeremylongshore / claude-code-plugins-plus-skills / sentry-prod-checklist

sentry-prod-checklist skill

/plugins/saas-packs/sentry-pack/skills/sentry-prod-checklist

This skill guides you through a production Sentry deployment checklist, ensuring proper DSN, source maps, alerts, and rollback readiness.

npx playbooks add skill jeremylongshore/claude-code-plugins-plus-skills --skill sentry-prod-checklist

Review the files below or copy the command above to add this skill to your agents.

Files (6)
SKILL.md
1.8 KB
---
name: sentry-prod-checklist
description: |
  Execute production deployment checklist for Sentry integration.
  Use when preparing for production deployment, reviewing
  Sentry configuration, or verifying production readiness.
  Trigger with phrases like "sentry production", "deploy sentry",
  "sentry checklist", "sentry go-live".
allowed-tools: Read, Grep, Bash(npm:*), Bash(curl:*)
version: 1.0.0
license: MIT
author: Jeremy Longshore <[email protected]>
---

# Sentry Prod Checklist

## Prerequisites

- Sentry account with project created
- Production DSN separate from development/staging
- Build pipeline with source map generation
- sentry-cli installed and configured with auth token

## Instructions

1. Configure production DSN via environment variables (never hardcode)
2. Set environment to "production" and configure release version
3. Generate source maps during build process
4. Upload source maps using sentry-cli releases commands
5. Verify security settings (sendDefaultPii: false, debug: false)
6. Configure appropriate sample rates for production volume
7. Set up alert rules with team notification channels
8. Connect source control and issue tracker integrations
9. Run verification test to confirm error capture and source maps
10. Document rollback procedure for emergency disable

## Output

- Production-ready Sentry configuration
- Verified source map uploads
- Configured alert rules and notifications
- Documented release workflow
- Validated error capture with test events

## Error Handling

See `{baseDir}/references/errors.md` for comprehensive error handling.

## Examples

See `{baseDir}/references/examples.md` for detailed examples.

## Resources
- [Sentry Production Checklist](https://docs.sentry.io/product/releases/setup/)
- [Sentry Release Health](https://docs.sentry.io/product/releases/health/)

Overview

This skill runs a focused production deployment checklist for Sentry integration to ensure error tracking is ready for go-live. It guides configuration, release management, source map handling, alerting, and verification steps so teams can confidently release to production. Use it to validate Sentry settings and to produce a reproducible release workflow.

How this skill works

The skill inspects Sentry configuration and deployment artifacts, verifies environment and DSN usage, checks that source maps are generated and uploaded, and ensures release/version settings are applied. It also reviews security flags, sampling rates, alert rules, and integrations, then walks through a verification test and documents rollback steps.

When to use it

  • Preparing for a production release or deployment
  • Reviewing Sentry configuration before go-live
  • Validating source map generation and upload in CI/CD
  • Setting up or auditing alert rules and notification channels
  • Creating or documenting a release workflow and rollback plan

Best practices

  • Keep production DSN in environment variables; never hardcode secrets
  • Set NODE_ENV or equivalent to production and tag releases with versions
  • Generate and upload source maps during the build pipeline with sentry-cli
  • Disable sending PII and debug logging in production (sendDefaultPii=false, debug=false)
  • Tune sample rates for production traffic to balance cost and visibility
  • Document and test an emergency rollback procedure to disable or revert Sentry releases

Example use cases

  • CI job that builds assets, generates source maps, and runs sentry-cli release upload before deploy
  • Pre-deploy checklist run to confirm production DSN, release version, and sampling settings
  • Audit that verifies alert rules route to on-call channels and linked issue tracker
  • Post-deploy verification that test events appear with correct stack traces and source maps
  • Onboarding runbook item to teach new team members how to perform Sentry go-live checks

FAQ

What minimal checks should I run right before production deploy?

Verify production DSN in env vars, confirm release version, ensure source maps are built and uploaded, check sendDefaultPii and debug are false, and run a test event.

How do I upload source maps reliably?

Generate source maps in your build pipeline and use sentry-cli release files and sentry-cli releases upload-sourcemaps with the release name matching your deployed version.