Monitoring

The Ellemment Stack integrates with Sentry for comprehensive application monitoring, including error tracking, performance monitoring, and session replay capabilities.

Deployment Options

SaaS Solution

• Quick setup
• Managed infrastructure
• Automatic updates
• Flexible pricing plans

Self-Hosted Option

• Complete control
• Data privacy
• Custom infrastructure
• Self-managed updates

Initial Setup

1. Create Sentry Project:

   # Visit Sentry signup page
   https://sentry.io/signup/?project_platform=javascript-remix

2. Configure Environment:

   # Set Sentry DSN in Fly.io
   fly secrets set SENTRY_DSN=<your_dsn>

Authentication Configuration

1. Generate Auth Token:

   • Create internal integration
   • Enable required scopes:
     • Releases:Admin
     • Organization:Read
   • Generate auth token
   • Store securely

2. Collect Organization Details:

   • Organization slug (SENTRY_ORG)
   • Project slug (SENTRY_PROJECT)

Build Configuration

Dockerfile Setup

# Build stage
ARG SENTRY_AUTH_TOKEN
ENV SENTRY_AUTH_TOKEN=$SENTRY_AUTH_TOKEN

GitHub Actions

1. Add Secrets:

   • SENTRY_AUTH_TOKEN
   • SENTRY_ORG
   • SENTRY_PROJECT

2. Configure Workflow:

   env:
     SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
     SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
     SENTRY_PROJECT: ${{ secrets.SENTRY_PROJECT }}
   

Vite Integration

Plugin Configuration

// vite.config.ts
export default defineConfig({
  plugins: [
    sentryVitePlugin({
      org: process.env.SENTRY_ORG,
      project: process.env.SENTRY_PROJECT,
      authToken: process.env.SENTRY_AUTH_TOKEN,
    })
  ]
})

Release Management

• Automatic release creation
• Commit association
• Source maps handling
• Release naming convention

Best Practices

Error Tracking

1. Configure error boundaries
2. Set up breadcrumbs
3. Add custom context
4. Filter sensitive data

Performance Monitoring

1. Set up transactions
2. Configure sampling rates
3. Monitor key metrics
4. Set performance baselines

Session Replay

1. Configure privacy settings
2. Set retention periods
3. Define sampling rates
4. Mask sensitive elements

Security Considerations

Data Privacy

1. Configure PII scrubbing
2. Set up allowlists
3. Configure data scrubbing
4. Review privacy settings

Access Control

1. Set up team permissions
2. Configure access roles
3. Manage API tokens
4. Review audit logs

Troubleshooting

Common Issues

1. Missing source maps
2. Integration errors
3. Release tracking issues
4. Performance overhead

Resolution Steps

1. Verify configuration
2. Check environment variables
3. Review build logs
4. Test error reporting

For more information about deployment configuration, see the deployment documentation. For security considerations, refer to the security documentation.