oncall-engine/docs/sources/configure/integrations/references/sentry/index.md
Jack Baldry 9ae442faa6
Replace docs/reference shortcode with ref URIs (#4301)
You can use `ref` URIs in admonitions (or any shortcodes) because they
are inline and not subject to the issues noted in the [`admonition`
shortcode](https://grafana.com/docs/writers-toolkit/write/shortcodes/#code-shortcode:~:text=to%20core%20understanding.-,WARNING,For%20more%20information%2C%20refer%20to%20Markdown%20Reference%20Links%20in%20Shortcodes.,-Examples).

The `ref` URIs perform the same pattern matching as `docs/reference` but
don't require the use of reference-style links and the destinations are
ordinary (full) URLs that can include version substitution. Unlike
`docs/reference`, the implementation doesn't use `relref` so you don't
have to be careful with omitting trailing slashes and the links will
follow redirects.

Documentation:
https://grafana.com/docs/writers-toolkit/write/links/#link-from-source-content-thats-used-in-multiple-projects

To check the links, refer to the deploy preview in
https://github.com/grafana/website/pull/19630.

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

---------

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
2024-07-29 14:13:24 +00:00

2.6 KiB

title menuTitle description weight keywords labels canonical aliases refs
Sentry integration for Grafana OnCall Sentry Sentry integration reference material for Grafana OnCall. 0
OnCall
Integrations
Alerts
Sentry
Notifications
products
cloud
https://grafana.com/docs/oncall/latest/configure/integrations/references/sentry
/docs/grafana-cloud/alerting-and-irm/oncall/configure/integrations/references/sentry
/docs/grafana-cloud/alerting-and-irm/oncall/integrations/sentry
add-sentry/
../integrations/
user-and-team-management
pattern destination
/docs/oncall/ /docs/oncall/<ONCALL_VERSION>/manage/user-and-team-management/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/alerting-and-irm/oncall/manage/user-and-team-management/

Sentry integration for Grafana OnCall

{{< admonition type="note" >}} This integration is available exclusively on Grafana Cloud. {{< /admonition >}}

The Sentry integration for Grafana OnCall handles ticket events sent from Sentry webhooks. The integration provides grouping, auto-acknowledge and auto-resolve logic via customizable alert templates.

Configuring Grafana OnCall to Receive Alerts from Sentry

  1. In the Integrations tab, click + New integration.
  2. Select Sentry from the list of available integrations.
  3. Enter a name and description for the integration, click Create
  4. A new page will open with the integration details. Copy the OnCall Integration URL from HTTP Endpoint section.

Configuring Sentry to Send Alerts to Grafana OnCall

To send a webhook alert from Sentry, you can follow these steps:

  1. Log in to your Sentry account.

  2. Navigate to your project's settings.

  3. Click on "Alerts" in the sidebar menu.

  4. Click on "New Alert Rule" to create a new alert rule.

  5. Configure the conditions for the alert rule based on your requirements. For example, you can set conditions based on issue level, event frequency, or specific tags.

  6. In the "Actions" section, select "Webhook" as the action type.

  7. Provide the necessary details for the webhook:

    • URL: OnCall Integration URL
    • Method: POST
    • Payload: Define the payload structure and content that you want to send to the webhook endpoint. You can use Sentry's dynamic variables to include relevant information in the payload.
  8. Save the alert rule.

Once the alert conditions are met, Sentry will trigger the webhook action and send a request to the Grafana OnCall.