Skip to main content

How to Set Up Sentry Integration

Monitor your CloudCruise workflow runs in Sentry to track failures, set up alerts, and gain visibility into your automation performance.

Step 1: Create a Sentry Internal Integration

  1. Log into your Sentry dashboard
  2. Go to SettingsDeveloper Settings (under your organization)
  3. Click Create New IntegrationInternal Integration
  4. Give it a name like “CloudCruise”
  5. Under Permissions, grant the following:
    • Project: Read
    • Issue & Event: Write
  6. Click Save Changes

Step 2: Generate an Auth Token

  1. After saving your integration, scroll down to the Tokens section
  2. Click + New Token
  3. Copy the generated token — this is your Auth Token for CloudCruise
The token is only shown once. Make sure to copy it before closing the page.
Keep your auth token secure. It provides access to send events to your Sentry project.

Step 3: Find Your Organization Slug

Your organization slug is visible in SettingsGeneral Settings under “Organization Slug”.

Step 4: Find Your Project Slug

Your project slug is visible in Project SettingsGeneral Settings under “Project Slug”.

Step 5: Connect CloudCruise to Sentry

  1. Navigate to Workspace Settings → Integrations
  2. Click Connect to Sentry
  3. Enter your:
    • Auth Token (from Step 2)
    • Organization Slug (from Step 3)
    • Project Slug (from Step 4)
  4. Click Test Connection to verify your credentials
  5. Click Connect to save

What Gets Sent to Sentry?

When a workflow run completes (success or failure), CloudCruise sends an event to Sentry containing:
  • Run status (execution.success, execution.failed)
  • Workflow name and ID
  • Session ID
  • Input variables
  • Vault entry identifiers (user aliases, user ids, not credentials)
  • Full run context (in the event details)
  • Direct link to the run in CloudCruise

Creating Alerts in Sentry

You can create Sentry alerts based on any of the tags sent with events:
  1. Go to Alerts in Sentry
  2. Create a new Issue Alert or Metric Alert
  3. Use tag filters like:
    • status:failed — Alert on failed runs
    • workflow_name:My Workflow — Alert for a specific workflow
    • input.customer_id:12345 — Alert when a specific input value fails
    • vault.production.user_alias:admin — Alert for runs using specific credentials

Troubleshooting

Test Connection fails

  1. Verify your auth token has the correct permissions (Project: Read, Issue & Event: Write)
  2. Double-check your organization and project slugs match exactly (they’re case-sensitive)
  3. Ensure the token hasn’t expired or been revoked

Events not appearing in Sentry

  1. Run a workflow and wait for it to complete
  2. Check the correct project in Sentry
  3. Verify your integration is still connected in CloudCruise settings

Need to disconnect?

You can disconnect your Sentry integration at any time from the Integrations page.