Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cloudcruise.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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 Settings → Developer Settings (under your organization)
  3. Click Create New Integration → Internal 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 Settings → General Settings under “Organization Slug”.

​
Step 4: Find Your Project Slug

Your project slug is visible in Project Settings → General 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 reaches a terminal status (success, failure, or stopped), CloudCruise sends an event to Sentry containing:
  • Run status (execution.success, execution.failed, execution.stopped)
  • 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

​
Filtering events

By default CloudCruise forwards all three terminal statuses. You can opt out of any of them from the Integrations page:
  1. Navigate to Workspace Settings → Integrations
  2. Next to the connected Sentry integration, click Manage
  3. Toggle which statuses to forward:
    • Successful runs — disable to reduce noise and Sentry quota usage
    • Failed runs — errors from runs that ended in failure
    • Stopped runs — runs terminated before completion
  4. Click Save
The same toggles are available during the initial connect flow.

​
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.