WorkestraDocs
Integrations

Sentry Integration

Connect Sentry for error tracking and application monitoring.

Sentry Integration

Connect Sentry to track application errors, monitor performance, and improve reliability.

Sentry connection modal

Screenshot needed � add an annotated image showing this UI

What It Does

  • Error tracking — Capture and analyze application errors
  • Performance monitoring — Track app performance metrics
  • Issue correlation — Link errors to support tickets
  • Alert management — Route Sentry alerts to Workestra

Connecting Sentry

Step 1: Get Auth Token

From Sentry:

  1. Go to Settings > Account > API
  2. Create New Token
  3. Scopes needed:
    • org:read
    • project:read
    • event:read
  4. Copy token (starts with sntryu_)

Step 2: Connect in Workestra

  1. Go to Settings > Connected Accounts
  2. Click Connect Sentry
  3. Paste auth token
  4. System auto-detects organization
  5. Select projects to monitor
  6. Save

Features

Error Dashboard

View Sentry errors in Workestra:

ColumnDescription
ErrorException type and message
CountNumber of occurrences
Users AffectedUnique users impacted
Last SeenMost recent occurrence
StatusUnresolved, resolved, ignored

Creating Tickets from Errors

Convert errors to support tickets:

  1. Find error in Sentry panel
  2. Click Create Ticket
  3. Pre-filled with:
    • Error details
    • Stack trace
    • Affected users
  4. Add priority and assignee
  5. Create

Error Context

View rich context:

  • Stack trace
  • User information
  • Browser/OS
  • URL where error occurred
  • Breadcrumbs

Alert Integration

Sentry alerts in Workestra:

  • New error types
  • Spike in errors
  • Performance degradation
  • Deploy-related issues

Configuration

Project Selection

Choose which Sentry projects to monitor:

  1. Edit Sentry connection
  2. Select/deselect projects
  3. Save changes

Alert Rules

Configure when to notify:

RuleDescription
New errorFirst occurrence of error type
Error spike10x normal error rate
PerformanceP95 latency > threshold
DeployErrors after release

Severity Mapping

Map Sentry levels to Workestra:

SentryWorkestra
FatalUrgent
ErrorHigh
WarningNormal
InfoLow

Troubleshooting

"Invalid Token"

  • Verify token format (sntryu_)
  • Check token hasn't expired
  • Ensure correct scopes
  • Regenerate if needed

Missing Projects

  • Check token has org:read scope
  • Verify user has project access
  • Re-authenticate

No Errors Appearing

  • Check selected projects
  • Verify Sentry is receiving errors
  • Check rate limits
  • Review connection status

Next Steps