Skip to content

Commit 69432fc

Browse files
authored
ref(integrations): Mention metric alert actions (#5035)
* ref(integrations): Mention metric alert actions
1 parent 5f967fb commit 69432fc

File tree

8 files changed

+32
-65
lines changed

8 files changed

+32
-65
lines changed

src/docs/product/integrations/notification-incidents/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ description: "Learn more about Sentry's notification and incidents integrations.
77
Learn more about Sentry's notification and incidents integrations:
88

99
- [Amixr](/product/integrations/notification-incidents/amixr/)
10-
- Data Dog
10+
- Datadog
1111
- [Microsoft Teams](/product/integrations/notification-incidents/msteams/)
1212
- OpsGenie
1313
- [PagerDuty](/product/integrations/notification-incidents/pagerduty/)

src/docs/product/integrations/notification-incidents/msteams/index.mdx

Lines changed: 11 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -28,50 +28,33 @@ Sentry owner, manager, or admin permissions are required to install this integra
2828
If you click "Add" instead of "Add to Team", you won't get the welcome message to finish installation.
2929
</Alert>
3030

31-
3. You should see a welcome message in the "General" channel within a few seconds and click "Complete Setup".
31+
3. You should see a welcome message in the "General" channel within a few seconds. Click "Complete Setup".
3232

3333
![](msteams-welcome-message.png)
3434

3535
The integration should be installed at this point.
3636

37-
In the next section, we'll walk you through configuring your notification settings.
3837

3938
## Configure
4039

41-
Use Microsoft Teams for [alerts](#alert-rules) regarding issues, environments, deployment, etc.
40+
Use Microsoft Teams for [alerts](/product/alerts/) regarding issues, environments, deployment, etc.
4241

4342
### Alert Rules
4443

45-
1. Confirm your Teams installation is configured globally for your Sentry organization by navigating to **Organization Settings > Integrations**. Click "Configuration(s)" to go to the configuration details page.
44+
Set up an alert rule by going to **Alerts** and clicking "Create Alert*". From here, you can configure alerts to route notifications to your Microsoft Team's channels.
4645

47-
![](msteams-directory-installed.png)
46+
In [issue alerts](/product/alerts/alert-types/#issue-alerts), select "Send a Microsoft Teams notification" in the actions dropdown and then select your team and channel:
4847

49-
2. Select the Teams installation to configure from the list, then click "Configure".
48+
![](msteams-add-action.png)
5049

51-
![](msteams-integration-detail.png)
50+
In [metric alerts](/product/alerts/alert-types/#metric-alerts), select the Microsoft Teams option in the dropdown that corresponds to your team and then enter the username or channel:
5251

53-
3. To navigate to Alert Rule settings, click "Add Alert Rule" for this project.
52+
![](msteams_metric_alert_rule.png)
5453

55-
![](msteams-project-configuration.png)
54+
Once you receive a Microsoft Teams notification, you can use the "Resolve", "Ignore", or "Assign" buttons to update the Issue in Sentry.
5655

57-
You can also access **Alerts** from your **Project Settings**. From Project Settings, configure when notifications are sent to your Microsoft Team(s).
56+
![](msteams-alert-message.png)
5857

59-
You can route notifications in a few ways: to a specific channel in your Team, to multiple channels in your Team, or to multiple Teams.
58+
The first time you try to interact with a notification, you will get a message from the Sentry bot asking you to link your identity. Click "Link Identities" to complete this step. Until you do this, you can't interact with messages.
6059

61-
4. Add your Team's channel as an action under **Perform these actions**:
62-
63-
![](msteams-new-alert-rule.png)
64-
65-
After selecting **Send a Teams notification**, specify the team, channel(s).
66-
67-
![](msteams-add-action.png)
68-
69-
You can add Alert Rules routing to as many Microsoft Teams channels as you’d like.
70-
71-
5. Once you receive a Teams notification, you can use the Resolve, Ignore, or Assign buttons to update the Issue in Sentry.
72-
73-
![](msteams-alert-message.png)
74-
75-
6. The first time you try to interact with a message, you will get a message from the Sentry bot asking you to link your identity. Click "Link Identities" to complete. Until you do this step, you cannot interact with messages!
76-
77-
![](msteams-link-identity.png)
60+
![](msteams-link-identity.png)
Loading

src/docs/product/integrations/notification-incidents/pagerduty/index.mdx

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,10 +47,18 @@ If you re-generate an integration key for one of your services in PagerDuty you
4747

4848
### Alert Rules
4949

50-
Click "Add Alert Rule" in the integration configuration page or go to the **Project Settings > Alerts** to set up a New Alert Rule for the PagerDuty Integration.
50+
Click "Add Alert Rule" in the integration configuration page or go to **Alerts** and click "Create Alert" to set up a new alert rule for the PagerDuty integration.
51+
52+
In [issue alerts](/product/alerts/alert-types/#issue-alerts), select "Send a PagerDuty notification" in the actions dropdown and then select your account and service:
5153

5254
![](pd_alert_rule.png)
5355

54-
## Deleting the legacy PagerDuty integration
56+
In [metric alerts](/product/alerts/alert-types/#metric-alerts), select the PagerDuty option in the dropdown that corresponds to your account and the select your service:
57+
58+
![](pd_metric_alert_rule.png)
59+
60+
If a PagerDuty incident is created from the critical trigger of a metric alert, it will resolve itself when the Sentry metric alert is resolved.
61+
62+
## Deleting the Legacy PagerDuty Integration
5563

5664
Once you configure the global PagerDuty integration and Alert Rules, you can disable the old PagerDuty integration. You’ll need to go to each project that has it enabled and disable it. We recommend disabling the legacy integration after setting up the global integration.
Loading

src/docs/product/integrations/notification-incidents/slack/index.mdx

Lines changed: 10 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -22,22 +22,17 @@ Sentry owner, manager, or admin permissions are required to install this integra
2222

2323
Slack defaults to let any workspace member authorize apps, but they may have to request access. See this [Slack help article](https://get.slack.help/hc/en-us/articles/202035138-Add-an-app-to-your-workspace) for more details.
2424

25-
1. In Sentry, navigate to **Settings > Integrations**.
25+
1. In [sentry.io](https://sentry.io), navigate to **Settings > Integrations > Slack**.
2626

27-
1. When you enter the page, the integrations list displays, which includes Slack. Use the search bar to filter quickly for the Slack integration.
28-
Click "Slack" to navigate to the details page for this integration.
29-
30-
![](slack-integration-directory.png)
31-
32-
1. Click "Add Workspace".
27+
2. Click "Add Workspace".
3328

3429
![](slack-overview-details-page.png)
3530

36-
1. Toggle to the Slack workspace to which you want to connect using the dropdown menu in the upper right corner of the authentication window, then select **Allow**. Repeat this process if you are connecting to multiple workspaces.
31+
3. Toggle to the Slack workspace to which you want to connect using the dropdown menu in the upper right corner of the authentication window. Then select "Allow". Repeat this process if you are connecting to multiple workspaces.
3732

3833
![](slack-allow-install.png)
3934

40-
1. Your integration details page will refresh and show the Slack workspace you just added.
35+
Your integration details page will refresh and show the Slack workspace you just added.
4136

4237
![](slack-install-success.png)
4338

@@ -63,37 +58,18 @@ You can receive [team alert notifications](/product/alerts/create-alerts/issue-a
6358

6459
### Alert Rules
6560

66-
1. Confirm your Slack workspace is configured globally for your Sentry organization by navigating to Organization Settings > **Integrations**. Click on "Configuration(s)" to go to the configuration details page.
67-
68-
![](slack-directory-installed.png)
69-
70-
1. Select the Slack workspace to configure from the list, then click "Configure".
71-
72-
![](slack-install-success.png)
73-
74-
1. Click "Add Alert Rule" for this project to navigate to Alert Rule settings.
75-
76-
![](slack-project-configuration.png)
77-
78-
You can also access **Alerts** from your **Project Settings**. From here, you can configure when notifications are sent to your Slack workspace(s).
79-
80-
You can route notifications in a few ways: to a specific channel in your Slack workspace, to multiple channels in your Slack workspace, or to multiple Slack workspaces.
81-
82-
1. Click "New Alert Rule" to configure a new Alert.
83-
84-
![](slack-alert-rules.png)
61+
Set up an alert rule by going to **Alerts** and clicking "Create Alert*". From here, you can configure alerts to route notifications to your Slack workspace(s).
8562

86-
Update the Slack channel routing by for existing Alert Rules by choosing Slack as the action under **Perform these actions**:
63+
In [issue alerts](/product/alerts/alert-types/#issue-alerts), select "Send a PagerDuty notification" in the actions dropdown and then select your workspace and channel:
8764

88-
![](slack-alert-rule-edit.png)
65+
![](slack_issue_alert.png)
8966

90-
After selecting **Send a Slack notification**, specify the workspace, channel(s), and tags you’d like to include with your Alert Rule.
67+
In [metric alerts](/product/alerts/alert-types/#metric-alerts), select the Slack option in the dropdown that corresponds to your workspace and the select your channel:
9168

92-
![](slack-alert-rule-edit-channels.png)
69+
![](slack_metric_alert.png)
9370

94-
You can add Alert Rules routing to as many Slack channels as you’d like.
9571

96-
1. Then once you receive a Slack notification, you can use the Resolve, Ignore, or Assign buttons to update the Issue in Sentry.
72+
Once you receive a Slack notification for an issue alert, you can use the "Resolve", "Ignore", or "Assign" buttons to update the Issue in Sentry.
9773

9874
![](slack-alert-message.png)
9975

Loading
Loading

0 commit comments

Comments
 (0)