Documentation Index
Fetch the complete documentation index at: https://docs.getcalmo.com/llms.txt
Use this file to discover all available pages before exploring further.
Sentry Integration
Connect Calmo to your Sentry account to enable comprehensive error monitoring, issue tracking, and performance analysis through AI assistance. This integration provides access to 11 specialized tools across 4 categories for complete error management workflows.Overview & Value Proposition
The Sentry integration transforms how your team handles error monitoring and issue resolution by providing:- Intelligent Error Analysis - AI-powered investigation of errors, stack traces, and performance issues
- Automated Issue Tracking - Comprehensive issue management with context-aware categorization
- Session Replay Integration - Visual debugging with user session recordings
- Performance Monitoring - Detailed performance insights and bottleneck identification
- Proactive Error Management - Automated error detection and intelligent resolution suggestions
- Safe Operations - Read-only tools enabled by default with controlled project creation access
Key Capabilities
When connected, Calmo gains access to 11 Sentry tools across 4 categories:| Category | Tools | Capability |
|---|---|---|
| Project Management | 2 tools | List projects and create new ones |
| Issue Tracking | 4 tools | Comprehensive issue investigation and management |
| Error Monitoring | 3 tools | Event analysis and error searching |
| Session Replay | 1 tool | Visual debugging with user session recordings |
| Configuration | 1 tool | Advanced Sentry setup and configuration |
Prerequisites
- Sentry account with appropriate access permissions
- Admin or member access to target organizations and projects
- Calmo account with team or personal workspace
Setup Process
Step 1: Generate Sentry Auth Token
Create Organization Token:- Log in to your Sentry account
- Navigate to Settings → Auth Tokens (under Organization)
- Click Create New Token
- Configure token settings:
- Name: “Calmo Integration”
- Scopes: Select based on desired capabilities
| Tool Category | Required Scopes |
|---|---|
| Project Management | project:read, project:write (for creation) |
| Issue Tracking | event:read, event:write (for updates) |
| Error Monitoring | event:read, org:read |
| Session Replay | org:read, project:read |
| Configuration | org:read, project:write |
project:read- Essential for project accessevent:read- Core for error and issue investigationorg:read- Required for organization-level operationsmember:read- Helpful for team contextteam:read- Useful for team assignment features
- Click Create Token
- Copy the generated token immediately
Step 2: Configure Organization and Project
Identify Target Configuration:- Organization: Your Sentry organization slug
- Project: Primary project slug for initial connection
- Additional Projects: Can be configured after initial setup
Step 3: Connect to Calmo
- Navigate to Integrations in your Calmo dashboard
- Click Sentry integration
- Enter your Auth Token
- Specify Organization name/slug
- Enter primary Project name/slug
- Configure tool permissions:
- ✅ Read-only operations enabled by default
- ❌ Write operations disabled for safety
- Complete the connection
Tool Categories & Configuration
🏗️ Project Management (Mixed Safety)
Default: Read-only enabled - Project visibility and creation Read Operations (✅ Enabled by default):- list_projects - List all projects with metadata and configuration details
- create_project - Create new Sentry projects with custom configurations
🐛 Issue Tracking (Mixed Safety)
Default: Read operations enabled - Comprehensive issue investigation Read Operations (✅ Enabled by default):- list_project_issues - List issues with filtering, sorting, and pagination
- get_sentry_issue - Get detailed issue information including stack traces
- list_issue_events - List all events associated with specific issues
- resolve_short_id - Convert Sentry short IDs to full issue references
🔍 Error Monitoring (Safe)
Default: Enabled - Event analysis and error investigation- get_sentry_event - Retrieve detailed event information and context
- list_error_events_in_project - List error events with advanced filtering
- search_errors_in_file - Search for errors in specific files or code paths
🎬 Session Replay (Safe)
Default: Enabled - Visual debugging and user experience analysis- list_organization_replays - List available session replay recordings
⚙️ Setup & Configuration (Write Operations)
Default: Disabled - Advanced Sentry configuration- setup_sentry - Configure Sentry projects and advanced settings
Team vs Personal Configuration
Team/Organization Setup
- Shared access to organization projects and issues
- Team-level error assignment and escalation workflows
- Centralized error monitoring policies and alerting
- Organization administrators control project creation permissions
Personal Setup
- Individual developer error tracking and investigation
- Personal project access and issue assignment
- Private error analysis and debugging sessions
- Full control over enabled tool capabilities
Security & Best Practices
⚠️ Safety Recommendations
- Read-First Approach - Begin with read-only operations, add write access as needed
- Scope Limitation - Use minimal required scopes for auth tokens
- Token Rotation - Regularly rotate auth tokens according to security policies
- Project Isolation - Connect only necessary projects initially
- Team Permissions - Leverage Sentry’s built-in team and permission system
🔒 Permission Levels
| Risk Level | Operations | Recommendation |
|---|---|---|
| Low | List projects, read issues/events, view replays | ✅ Safe to enable |
| Medium | Search errors, resolve short IDs | ✅ Generally safe |
| High | Create projects, setup configuration | ⚠️ Enable with caution |
Configuration Management
Updating Sentry Connection
- Navigate to Integrations → Sentry
- Click Edit Configuration
- Update auth token, organization, or project settings
- Modify tool permissions based on team requirements
- Test connection with read-only operations
- Save configuration changes
Managing Multiple Projects
- Configure access to multiple Sentry projects
- Set up project-specific tool permissions
- Maintain separate error tracking workflows per project
- Cross-project error correlation and analysis
Advanced Features
Multi-Project Support
- Project Discovery - Automatically discover available projects
- Cross-Project Analysis - Correlate errors across multiple projects
- Project-Specific Configuration - Different tool permissions per project
- Unified Error Management - Centralized view of errors across projects
Issue Intelligence
- Error Pattern Recognition - AI-powered identification of error patterns
- Stack Trace Analysis - Automated analysis of complex stack traces
- Issue Correlation - Link related issues across different events
- Performance Impact Assessment - Understand error impact on application performance
Session Replay Integration
- Visual Error Reproduction - See exactly what users experienced
- User Journey Analysis - Understand error context within user workflows
- Performance Debugging - Visual identification of performance bottlenecks
- Error Context Enhancement - Rich context for error investigation
Error Analysis Workflows
Automated Error Investigation
- Error Categorization - Automatic classification of error types
- Root Cause Analysis - AI-powered investigation of error sources
- Fix Suggestions - Intelligent recommendations for error resolution
- Impact Assessment - Understanding of error severity and user impact
Performance Monitoring
- Transaction Analysis - Detailed performance trace investigation
- Performance Regression Detection - Identification of performance degradations
- Database Query Analysis - SQL query performance and optimization insights
- Frontend Performance - Browser-specific performance issue identification
Troubleshooting
Common Issues
Authentication Failed- Verify auth token is correct and hasn’t expired
- Check token scopes match enabled tool requirements
- Ensure organization and project names are accurate
- Verify project slug is correct (case-sensitive)
- Check project exists and is accessible with current token
- Ensure proper team membership for private projects
- Review auth token scopes in Sentry organization settings
- Check team permissions for target projects
- Verify organization-level access rights
- Sentry enforces API rate limits (varies by plan)
- Monitor API usage in Sentry organization settings
- Consider upgrading Sentry plan for higher limits
Getting Help
- Test Connection - Use connection test feature in integration settings
- Update Token - Regenerate auth token with appropriate scopes
- Contact Support - Reach out to support@getcalmo.com for assistance
Data Types & Analysis
Error Data
- Exception Details - Complete stack traces and error messages
- User Context - User information associated with errors
- Request Context - HTTP request details and parameters
- Environment Data - Runtime environment and configuration information
Performance Data
- Transaction Traces - Detailed performance traces across services
- Database Queries - SQL query performance and execution details
- External Service Calls - API call performance and failure tracking
- Frontend Metrics - Browser performance and user experience metrics
User Experience Data
- Session Replays - Visual recordings of user sessions
- User Interactions - Click patterns and navigation behavior
- Error User Impact - Understanding which users are affected by errors
- Conversion Funnel Analysis - Impact of errors on business metrics
For additional help with Sentry integration, contact our support team at support@getcalmo.com.