From e061f2886feafbd869c6e9a4c9870eeb72ea1bc9 Mon Sep 17 00:00:00 2001 From: antonio <45235678+tonypowa@users.noreply.github.com> Date: Sat, 6 Jul 2024 11:38:25 +0200 Subject: [PATCH] alerting/integrations:opsgenie (#90133) * alerting/integrations:opsgenie * Update _index.md * new line * all pretty no pity * numbering * Update docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-opsgenie.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-opsgenie.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update configure-opsgenie.md --------- Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> --- .../manage-contact-points/_index.md | 7 ++- .../integrations/configure-opsgenie.md | 62 +++++++++++++++++++ 2 files changed, 68 insertions(+), 1 deletion(-) create mode 100644 docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-opsgenie.md diff --git a/docs/sources/alerting/configure-notifications/manage-contact-points/_index.md b/docs/sources/alerting/configure-notifications/manage-contact-points/_index.md index a371d4de9bf..810d7549eab 100644 --- a/docs/sources/alerting/configure-notifications/manage-contact-points/_index.md +++ b/docs/sources/alerting/configure-notifications/manage-contact-points/_index.md @@ -46,6 +46,11 @@ refs: destination: /docs/grafana//alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier/ - pattern: /docs/grafana-cloud/ destination: /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier/ + opsgenie: + - pattern: /docs/grafana/ + destination: /docs/grafana//alerting/configure-notifications/manage-contact-points/integrations/configure-opsgenie/ + - pattern: /docs/grafana-cloud/ + destination: /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/integrations/configure-opsgenie/ pagerduty: - pattern: /docs/grafana/ destination: /docs/grafana//alerting/configure-notifications/manage-contact-points/integrations/pager-duty/ @@ -161,7 +166,7 @@ The following table lists the contact point integrations supported by Grafana. | Kafka REST Proxy | `kafka` | | Line | `line` | | [Microsoft Teams](ref:teams) | `teams` | -| Opsgenie | `opsgenie` | +| [Opsgenie](ref:opsgenie) | `opsgenie` | | [Pagerduty](ref:pagerduty) | `pagerduty` | | Pushover | `pushover` | | Sensu Go | `sensugo` | diff --git a/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-opsgenie.md b/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-opsgenie.md new file mode 100644 index 00000000000..dfca507ddb9 --- /dev/null +++ b/docs/sources/alerting/configure-notifications/manage-contact-points/integrations/configure-opsgenie.md @@ -0,0 +1,62 @@ +--- +canonical: https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/configure-opsgenie/ +description: Configure the Opsgenie integration to receive notifications when your alerts are firing +keywords: + - grafana + - alerting + - Opsgenie + - integration +labels: + products: + - cloud + - enterprise + - oss +menuTitle: Opsgenie +title: Configure Opsgenie for Alerting +weight: 300 +--- + +# Configure Opsgenie for Alerting + +Use the Grafana Alerting - Opsgenie integration to receive alert notifications in your Opsgenie alert dashboard when your Grafana alert rules are triggered and resolved. + +## Before you begin + +Create an API key to enable Grafana to send alert notifications to Opsgenie alert dashboard. + +To create an API key in Opsgenie, complete the following steps. + +1. Follow the steps in the [API integration guide](https://support.atlassian.com/opsgenie/docs/create-a-default-api-integration/). + + Make sure you turn on the integration. + +1. Copy the API key. + +## Procedure + +To create your Opsgenie integration in Grafana Alerting, complete the following steps. + +1. Navigate to **Alerts & IRM** -> **Alerting** -> **Contact points**. +1. Click **+ Add contact point**. +1. Enter a contact point name. +1. From the **Integration** list, select **Opsgenie**. +1. In the **API key** field, paste in your API key. +1. In the **Alert API URL**, enter `https://api.opsgenie.com/v2/alerts`. +1. Click **Test** to check that your integration works. + + A test alert notification is sent to the Alerts page in Opsgenie. + +1. Click **Save contact point**. + +## Next steps + +The Opsgenie contact point is ready to receive alert notifications. + +To add this contact point to your alert rule, complete the following steps: + +1. In Grafana, navigate to **Alerting** > **Alert rules**. +1. Edit or create a new alert rule. +1. Scroll down to the **Configure labels and notifications** section. +1. Under **Notifications**, click **Select contact point**. +1. From the drop-down menu, select the previously created contact point. +1. Click **Save rule and exit**.