Sentry Integration

I. Prerequisites

Sentry provides two types of alert mechanisms: Issue Alerts and Metric Alerts. While Issue Alerts support notifications through WebHooks in Integrations, Metric Alerts are limited to using Internal Integration for alert notifications. Notably, Internal Integration works with both Metric Alerts and Issue Alerts. Given the versatility of Internal Integration, we've chosen to standardize on this approach rather than relying on WebHooks separately, thus simplifying alert notification configuration.

II. Sentry Alert Push Configuration

Step 1: Add FlashDuty Custom Integrations

1. Log in to the Sentry management console
2. In the left navigation bar, locate Settings => Custom Integrations
3. Click Create New Integration and select Internal Integration
4. On the editing page, enter FlashDuty for Name and paste the integration push URL into WebhookURL
5. Enable Alert Rule Action, configure as shown below:

5. In PERMISSIONS configuration, set Read permission for Issue & Event
6. In WEBHOOKS configuration, check issue, do not check error and comment
7. After configuration, click Save Changes to complete the setup

Special notes about WEBHOOKS configuration:

1. After checking issue, FlashDuty can receive resolved events for issues, meaning when manually triggering resolved for an issue in the issue list, we will automatically recover the associated incident in FlashDuty
2. Other issue events such as create, assigned, archived, and unresolved are not supported
3. If error and comment are also checked, FlashDuty will not receive or process these types of events

Step 2: Use FlashDuty Integration in Alerts

1. In the left navigation bar, locate Alerts => Create Alert
2. Select the type of Alert to create, such as Issue

3. Configure trigger conditions as needed

4. Under THEN perform these actions, Add action and select Send a notification via

5. Select FlashDuty added above as the notification channel

6. Configure other options as needed and click Save Rule to complete

III. Status Mapping