---
name: check-releases
description: Check release health and compare error rates across deployments
---
# Check Release Health
## Name
sentry:check-releases - Check release health and compare error rates across deployments
## Synopsis
```
/check-releases [arguments]
```
## Description
Check the health of recent releases in Sentry to identify problematic deployments, track adoption rates, and compare error rates.
## Implementation
This command helps you monitor release quality and quickly identify if a new deployment introduced regressions.
## Usage
```
/check-releases [project-name] [release-version]
```
## What This Command Does
1. Lists recent releases for the specified project
2. Fetches release health metrics using Sentry MCP tools
3. Analyzes release data including:
- Crash-free session rate
- Crash-free user rate
- Total sessions/users
- New error issues introduced
- Adoption rate over time
4. Compares current release with previous releases
5. Identifies problematic releases
6. Provides recommendations for rollback or monitoring
## Prerequisites
- Sentry MCP server must be installed and configured
- OAuth authentication with Sentry must be completed
- Release tracking configured in Sentry
- Access to the target Sentry project
## Example Interaction
```
User: /check-releases frontend-app v2.4.0
Claude: Checking release health for frontend-app v2.4.0...
## Release Health Report
### Release: v2.4.0
- **Deployed**: 2 days ago
- **Total Sessions**: 45,320
- **Unique Users**: 12,450
- **Adoption**: 78% of active users
### Health Metrics
**Current Release (v2.4.0):**
- Crash-Free Sessions: 97.2%
- Crash-Free Users: 98.1%
- New Issues: 5
- Total Events: 1,247
**Previous Release (v2.3.9):**
- Crash-Free Sessions: 99.1%
- Crash-Free Users: 99.4%
- New Issues: 1
- Total Events: 423
**Change:** 🔴 -1.9% crash-free sessions, -1.3% crash-free users
### New Issues Introduced in v2.4.0
1. **TypeError: Cannot access 'setState' before initialization**
- Events: 478
- Users: 234
- Severity: High
- Component: UserProfile
2. **NetworkError: Request timeout on /api/analytics**
- Events: 356
- Users: 178
- Severity: Medium
3. **Warning: Each child should have unique 'key' prop**
- Events: 289
- Users: 145
- Severity: Low
4. **Error: Failed to parse JSON response**
- Events: 89
- Users: 45
- Severity: Medium
5. **Unhandled Promise Rejection in data loader**
- Events: 35
- Users: 12
- Severity: Low
### Release Comparison
| Metric | v2.4.0 | v2.3.9 | v2.3.8 | Trend |
|--------|--------|--------|--------|-------|
| Crash-Free Sessions | 97.2% | 99.1% | 99.0% | 🔴 Down |
| Error Events | 1,247 | 423 | 456 | 🔴 Up |
| Performance (P95) | 2.1s | 1.8s | 1.9s | 🔴 Slower |
### Assessment
🔴 **Release Quality: Poor**
This release has significantly higher error rates compared to previous versions.
The TypeError affecting UserProfile is the primary contributor to degraded health.
### Recommendations
1. **Immediate**: Investigate TypeError in UserProfile component
2. **Consider**: Rollback to v2.3.9 if issue persists
3. **Monitor**: NetworkError timeout - may be infrastructure-related
4. **Track**: Performance regression (300ms slower P95)
Would you like me to:
- Investigate the UserProfile TypeError in detail?
- Compare performance metrics across releases?
- Check if any users are reporting issues?
```
## Arguments
- `project-name` (optional): Sentry project slug
- `release-version` (optional): Specific release to check (defaults to latest)
## Tips
- Monitor crash-free rates closely after deployments
- Compare new releases with previous stable versions
- Track new issues introduced per release
- Set up release health alerts
- Use release tags consistently in your deployment pipeline
- Roll back quickly if crash-free rate drops significantly
## Related Commands
- `/investigate-errors`: Dive deeper into release-specific errors
- `/analyze-performance`: Check performance changes across releases
- `/query-events`: Custom queries filtered by release