Runbook Link in Alert Definitions

[Maixy]

Problem Statement

Problem Statement

Currently when our alerts page us through our 3rd party alerting tool, they provide the title and description of the alert, but any additional context is lost. What would be really helpful is the ability to add a link to an Alert definition that we could use to point at a high context runbook written specifically for that alert.

Solution Brainstorm

An extra text field, possibly in the Establish Ownership section of the Alert definition, that supports a generic link to any URL. Our runbooks are currently hosted in Notion, but I can imagine some folk have them in google docs, confluence, etc. That field would be included on alert payloads that are sent to connected integrations like Incident.io, PagerDuty, etc.

I've opened up this additional issue to follow up on #111808, which I'm not able to comment on or re-open! Sorry for the duplication, additional context about what's coming next in the Alert UI would be awesome!

Specific questions around the new UI

• sentaur-athena mentioned that developers will be able to ad a link to their alert, but it sounds like that link would have to be to a specific Sentry URL, not a generic one. Is that the case? Would it be possible to add support for runbooks outside of Sentry? (it would suck to have to duplicate runbooks across a bunch of different providers)
• Her comment also mentioned that the alert payload sent when the alert trigger would include a link to the Alert, but not the new developer-added Link. Is there any chance it could be included in the alert payload that is sent to third party alerting providers? Slack, PagerDuty, Incident.io, etc. would all be able to parse it out and include it in the notification that gets to a production operator, so they don't have to click around a bunch of different UIs when they really want to quickly evaluate the severity and context of the outage.

Thanks for any additional context here!! 🙇

Product Area

Alerts

Solution Brainstorm

No response

Product Area

Unknown

[linear-code]

ENG-7228

[getsantry]

Auto-routing to @getsentry/product-owners-alerts for triage ⏲️

[souredoutlook]

Hey there, to clarify:

• you will be able to add text freely to any metric alert/monitor
• we currently don't surface this in the payload (this feature is in closed beta you can give it a try if you'd like to send me an email nicholas.meisenheimer@sentry.io) but I think it's clear we'll need to soon

An example of what the new fields look like on Monitors:

[sentaur-athena]

To clarify the link I mentioned in previous issue is "link to the alert on Sentry". In which you can have a runbook as Nick mentioned and if you like you can link it out to somewhere on notion. We don't plan to provide an extra field for external runbook link.