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

# Sentry

> Push workflow run results to Sentry for monitoring and alerting

## **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](https://sentry.io)
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

<Note>
  The token is only shown once. Make sure to copy it before closing the page.
</Note>

<Warning>
  Keep your auth token secure. It provides access to send events to your Sentry project.
</Warning>

### **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](https://app.cloudcruise.com/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](https://app.cloudcruise.com/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](https://app.cloudcruise.com/settings/integrations) page.