oncall-engine/docs/sources/integrations/sentry/index.md
Alyssa Wada 80f932995c
oncall docs refactor (#3757)
# What this PR does

- Restructure the OnCall documentation to align with Grafana Labs
[documentation structure
guidance](https://grafana.com/docs/writers-toolkit/structure/).

- Updates documentation front matter to include all required fields.

## Which issue(s) this PR fixes
Related to issue #3700 

## Checklist

- [ ] Unit, integration, and e2e (if applicable) tests updated
- [ ] Documentation added (or `pr:no public docs` PR label added if not
required)
- [ ] `CHANGELOG.md` updated (or `pr:no changelog` PR label added if not
required)

---------

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: Jack Baldry <jack.baldry@grafana.com>
2024-02-08 22:59:28 +00:00

2.3 KiB

aliases canonical keywords labels title weight
add-sentry/
/docs/oncall/latest/integrations/available-integrations/configure-Sentry/
https://grafana.com/docs/oncall/latest/integrations/sentry/
Grafana Cloud
Alerts
Notifications
on-call
sentry
products
cloud
Sentry 500

Sentry integration for Grafana OnCall

This integration is not available in OSS version

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.

You must have the [role of Admin][user-and-team-management] to be able to create integrations in Grafana OnCall.

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.

{{% docs/reference %}} [user-and-team-management]: "/docs/oncall/ -> /docs/oncall/<ONCALL_VERSION>/manage/user-and-team-management" [user-and-team-management]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/alerting-and-irm/oncall/manage/user-and-team-management" {{% /docs/reference %}}