Skip to content

feat(Monitors and Alerts): Monitors and Alerts GA#17659

Open
sfanahata wants to merge 2 commits intomasterfrom
feat/monitors-and-alerts-ga
Open

feat(Monitors and Alerts): Monitors and Alerts GA#17659
sfanahata wants to merge 2 commits intomasterfrom
feat/monitors-and-alerts-ga

Conversation

@sfanahata
Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

Deleting Alerts section, redirects added, updated all links in repo referencing /product/alerts to /product/monitors-and-alerts

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.): ASAP
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

…eferencing /product/alerts to /product/monitors-and-alerts
@vercel
Copy link
Copy Markdown

vercel Bot commented May 6, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment May 7, 2026 3:08am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview May 7, 2026 3:08am

Request Review

@sfanahata
Copy link
Copy Markdown
Contributor Author

Unrelated external link https://imageoptim.com/ is 502ing right now.

![Opsgenie sample alert](./img/opsgenie-sample-alert.png)

If you'd rather be alerted when a specific metric crosses a threshold, you can set a [metric alert](/product/alerts/alert-types/#metric-alerts) by following the same steps as above. Once you've chosen the metric you want to be alerted about, click "Add Action", then select Opsgenie from the notification types dropdown. You can also select a custom priority for the alert, or leave it blank to use the default severity level that Sentry provides for incident statuses ("P1" for critical status and "P2" for warning status)
If you'd rather be alerted when a specific metric crosses a threshold, you can set a [Monitor](/product/monitors-and-alerts/monitors/) by following the same steps as above. Once you've chosen the metric you want to be alerted about, click "Add Action", then select Opsgenie from the notification types dropdown. You can also select a custom priority for the alert, or leave it blank to use the default severity level that Sentry provides for incident statuses ("P1" for critical status and "P2" for warning status)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: The documentation for Opsgenie, PagerDuty, and MS Teams incorrectly directs users to the 'Monitors' page to configure notification actions, which is actually done in the 'Alerts' flow.
Severity: MEDIUM

Suggested Fix

Update the documentation for Opsgenie, PagerDuty, and MS Teams to reflect that notification actions are configured within the Alerts creation flow. Change the links and instructions to guide the user to the correct 'Alerts' page and workflow instead of the 'Monitors' page.

Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's
not valid.

Location: docs/integrations/notification-incidents/opsgenie/index.mdx#L56

Potential issue: The integration documentation for Opsgenie, PagerDuty, and MS Teams
incorrectly states that notification actions are configured under 'Monitors'. The
documentation directs users to the Monitors page to 'Add Action', but this UI and
workflow actually exist within the 'Alerts' creation flow. Users following the
documentation will navigate to the wrong page and be unable to configure notifications
for these services, causing confusion and preventing them from completing the setup.

Also affects:

  • docs/integrations/notification-incidents/pagerduty/index.mdx:54
  • docs/integrations/notification-incidents/msteams/index.mdx:60

Did we get this right? 👍 / 👎 to inform future reviews.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant