centralcloud/oncall-engine
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge

Browse source
This commit is contained in:
Matvey Kukuy 2022-06-14 19:17:20 +03:00
commit 5064fb0d9f
35 changed files with 179 additions and 126 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
docs/sources/_index.md
View file

@ -11,15 +11,25 @@ keywords:
- OnCall
- irm
title: Grafana OnCall
canonical: "https://grafana.com/docs/oncall/latest/"
weight: 1000
---
# Grafana OnCall
# Grafana OnCall documentation
You can use Grafana OnCall to connect to the monitoring systems of your Grafana Cloud integrations so that you can ensure alert notifications reach the right people, at the right time, using the right medium. Team members can review and manage alert group notifications directly in OnCall, or in supported platforms, like Telegram and Slack.
<img src="/static/img/docs/oncall/oncall-logo.png" class="no-shadow" width="700px">
When you integrate an alert monitoring system with Grafana OnCall, the alerts will create an alert group. This group will fire notifications that are sent according to escalation policies that you define in routes and escalation chains. You can configure escalation actions, and automatically notify users and groups through services like Slack, by text message, and by phone call. You can also use popular calendar services like Google Calendar and Outlook to schedule on-call shifts for team members.
Follow these links to learn more:
Grafana OnCall is an open source incident response management tool built to help teams improve their collaboration and resolve incidents faster. Some of the core strengths of Grafana OnCall include:
- **Support for a broad set of monitoring systems:** Grafana OnCall supports integrations with many monitoring systems, including Grafana, Prometheus, AlertManager, Zabbix, and more.
- **Reduce alert noise:** Automatic alert grouping helps avoid alert storms and reduce noise during incidents. Auto-resolve settings can resolve without human intervention when the resolve conditions are met, enabling you to control alert noise and reduce alert fatigue.
- **Automatic escalation to on-call rotations:** Grafana OnCall’s flexible calendar integration allows you to define your on-call rotations while managing on-call schedules in your preferred calendar application with iCal format. Configurable alert escalation automatically escalates alerts to on-call team members, notifies slack channels, and more.
- **ChatOps focused:** Grafana OnCall integrates closely with your slack workspace to deliver alert notifications to individuals and groups, making daily alerts more visible and easier to manage.
- **Highly customizable**: With customizable alert grouping and routing, you can decide which alerts you want to be notified of and how, ensuring the right people are notified for the right issues.
- **Massive scalability:** Grafana OnCall is equipped with a full API and Terraform capabilities. Ready for GitOps and large organization configuration.
> **Note:** You can use [Grafana Cloud](https://grafana.com/products/cloud/?plcmt=nav-products-cta1&cta=cloud) to avoid installing, maintaining, and scaling your own instance of Grafana OnCall. The free forever plan includes 30 Grafana OnCall notification. [Create an account to get started](https://grafana.com/auth/sign-up/create-user?pg=oncall&plcmt=hero-btn-1).
{{< section >}}

3
docs/sources/calendar-schedules/_index.md
View file

@ -8,7 +8,8 @@ keywords:
- on-call
- calendar
title: Configure and manage on-call schedules
weight: 900
canonical: "https://grafana.com/docs/oncall/latest/calendar-schedules/"
weight: 1100
---
# Configure and manage on-call schedules

5
docs/sources/chat-options/_index.md
View file

@ -10,12 +10,13 @@ keywords:
- oncall
- slack
title: Connect ChatOps to Grafana OnCall
weight: 700
canonical: "https://grafana.com/docs/oncall/latest/chat-options/"
weight: 900
---
# Connect ChatOps to Grafana OnCall
Grafana OnCall directly supports the export of alert notifications to some popular messaging applications like Slack and Telegram. You can use outgoing webhooks to applications that aren't directly supported. For information on configuring outgoing webhooks, see [Send alert group notifications by webhook]({{< relref "../integrations/webhooks/configure-outgoing-webhooks.md" >}}).
Grafana OnCall directly supports the export of alert notifications to some popular messaging applications like Slack and Telegram. You can use outgoing webhooks to applications that aren't directly supported. For information on configuring outgoing webhooks, see [Send alert group notifications by webhook]({{< relref "../integrations/configure-outgoing-webhooks.md" >}}).
To configure supported messaging apps, see the following topics:

64
docs/sources/chat-options/configure-slack.md
View file

@ -9,36 +9,60 @@ keywords:
- amixr
- oncall
- slack
title: Connect Slack to Grafana OnCall
title: Slack integration for Grafana OnCall
canonical: "https://grafana.com/docs/oncall/latest/chat-options/configure-slack/"
weight: 100
---
# Connect Slack to Grafana OnCall
# Slack integration for Grafana OnCall
Grafana OnCall integrates closely with your Slack workspace to deliver alert group notifications to individuals, groups, and team members.
The Slack integration for Grafana OnCall incorporates your Slack workspace directly into your incident response workflow to help your team focus on alert resolution with less friction.
## Connect to Slack
Integrating your Slack workspace with Grafana OnCall allows users and teams to be notified of alerts directly in Slack with automated alert escalation steps and user notification preferences. There are a number of alert actions that users can take directly from Slack, including acknowledge, resolve, add resolution notes, and more.
Connect your organization's Slack workspace to your Grafana OnCall instance.
> **NOTE:** Only Grafana users with the administrator role can configure OnCall settings.
## Before you begin
1. In OnCall, click on the **ChatOps** tab and select Slack in the side menu.
1. Click **Install Slack integration**.
1. Read the notice and click the button to proceed to the Slack website.
1. Sign in to your organization's workspace.
1. Click **Allow** to allow OnCall to access Slack.
1. Ensure users verify their Slack accounts in their user profile in OnCall.
To install the Slack integration, you must have Admin permissions in your Grafana instance as well as the Slack workspace that you’d like to integrate with.
## Configure Slack in OnCall
For Open Source Grafana OnCall Slack installation guidance, refer to [Open Source Grafana OnCall]({{< relref "../open-source.md" >}}).
In the Slack settings for Grafana OnCall, administrators can set a default Slack channel for notifications and opt to set reminders for acknowledged alerts that can timeout and revert an alert group to the unacknowledged state.
## Install Slack integration for Grafana OnCall
1. In OnCall, click on the **ChatOps** tab and select Slack in the side menu.
1. In the first dropdown menu, select a default Slack channel.
When you set up escalation policies to notify Slack channels of incoming alerts, the default will be the one you set here. You will still have the option to select from all the channels available in your organization.
1. In **Additional settings** you can choose how to remind users of acknowledged but unresolved alert groups. You can also select whether and or when to automatically revoke the "acknowledged" status from an alert group to an unacknowledged state.
1. From the **ChatOps** tab in Grafana OnCall, select **Slack** in the side menu.
2. Click **Install Slack integration**.
3. Read the notice and agree to proceed to the Slack website.
4. Provide your Slack workspace URL and sign with your Slack credentials.
5. Click **Allow** to give Grafana OnCall permission to access your Slack workspace.
## Slack settings for on-call calendar scheduling notifications
Admins can configure settings in Slack to notify people and groups about on-call schedules. When an on-call shift notification is sent to a person or channel, click the gear button to access **Notification preferences**. Use the options to configure the behavior of future shift notifications.
## Post-install configuration for Slack integration
Configure the following additional settings to ensure Grafana OnCall alerts are routed to the intended Slack channels and users:
1. From your **Slack integration** settings, select a default slack channel in the first dropdown menu. This is where alerts will be sent unless otherwise specified in escalation chains.
2. In **Additional Settings**, configure alert reminders for alerts to retrigger after being acknowledged for some amount of time.
3. Ensure all users verify their slack account in their Grafana OnCall **users info**.
### Configure Escalation Chains with Slack notifications
Once your Slack integration is configured you can configure Escalation Chains to notify via Slack messages for alerts in Grafana OnCall.
There are two Slack notification options that you can configure into escalation chains, notify whole Slack channel and notify Slack user group:
1. In Grafana OnCall, navigate to the **Escalation Chains** tab then select an existing escalation chain or click **+ New escalation chain**.
2. Click the dropdown for **Add escalation step**.
3. Configure your escalation chain with automated Slack notifications.
### Configure user notifications with Slack mentions
To be notified of alerts in Grafana OnCall via Slack mentions:
1. Navigate to the **Users** tab in Grafana OnCall, click **Edit** next to a user.
2. In the **User Info** tab, edit or configure notification steps by clicking + Add Notification step
3. select **Notify by** in the first dropdown and select **Slack mentions** in the second dropdown to receive alert notifications via Slack mentions.
### Configure on-call notifications in Slack
The Slack integration for Grafana Oncall supports automated Slack on-call notifications that notify individuals and teams of their on-call shifts. Admins can configure shift notification behavior in Notification preferences:
1. When an on-call shift notification is sent to a person or channel, click the gear icon to access **Notifications preferences**.
2. Configure on-call notifications for future shift notifications.

5
docs/sources/chat-options/configure-telegram.md
View file

@ -9,11 +9,12 @@ keywords:
- amixr
- oncall
- telegram
title: Connect Telegram to Grafana OnCall
title: Telegram integration for Grafana OnCall
canonical: "https://grafana.com/docs/oncall/latest/chat-options/configure-telegram/"
weight: 300
---
# Connect Telegram to Grafana OnCall
# Telegram integration for Grafana OnCall
You can use Telegram to deliver alert group notifications to a dedicated channel, and allow users to perform notification actions.

3
docs/sources/configure-user-settings.md
View file

@ -10,7 +10,8 @@ keywords:
- oncall
- integrations
title: Manage users and teams for Grafana OnCall
weight: 1100
canonical: "https://grafana.com/docs/oncall/latest/configure-user-setting/"
weight: 1300
---
# Manage users and teams for Grafana OnCall

20
docs/sources/escalation-policies/_index.md
View file

@ -1,19 +1,15 @@
---
title: Configure escalation chains and routes for Grafana OnCall
weight: 700
canonical: "https://grafana.com/docs/oncall/latest/escalation-policies/"
aliases:
- /docs/oncall/latest/escalation-policies/
keywords:
- Grafana Cloud
- Alerts
- Notifications
- on-call
- amixr
- oncall
- integrations
title: Escalation Chains and Routes
weight: 500
- /docs/oncall/latest/chat-options/escalation-policies/
---
# Escalation Chains and Routes for Grafana OnCall
# Configure escalation chains and routes for Grafana OnCall
Escalation chains and routes for Grafana OnCall
Administrators can create escalation policies to automatically send alert group notifications to recipients. These policies define how, where, and when to send notifications.

3
docs/sources/escalation-policies/configure-escalation-chains.md
View file

@ -10,6 +10,7 @@ keywords:
- oncall
- integrations
title: Configure and manage Escalation Chains
canonical: "https://grafana.com/docs/oncall/latest/escalation-policies/configure-escalation-chains/"
weight: 100
---
@ -30,5 +31,3 @@ An escalation chain can have many steps, or only one step. For example, steps ca
## Routes
An escalation workflow can employ **routes** that administrators can configure to filter alerts by regular expressions in their payloads. Notifications for these alerts can be sent to individuals, or they can make use of a new or existing escalation chain.
To learn how to configure escalation chains and routes, see [Configure escalation policies]({{< relref "configure-escalation-policies">}}).

5
docs/sources/escalation-policies/configure-routes.md
View file

@ -9,11 +9,12 @@ keywords:
- amixr
- oncall
- integrations
title: Configure and manage Routes
title: Configure and manage routes
canonical: "https://grafana.com/docs/oncall/latest/escalation-policies/configure-routes/"
weight: 300
---
# Configure and manage Routes
# Configure and manage routes
Set up escalation chains and routes to configure escalation behavior for alert group notifications.

137
docs/sources/getting-started.md
View file

@ -3,125 +3,122 @@ aliases:
- /docs/grafana-cloud/oncall/getting-started/
- /docs/oncall/latest/getting-started/
keywords:
- Get started
- On call
- Grafana Cloud
- Alerts
- Notifications
- on-call
title: Getting started with Grafana OnCall
weight: 100
title: Get started with Grafana OnCall
canonical: "https://grafana.com/docs/oncall/latest/getting-started/"
weight: 300
---
# Getting started with Grafana OnCall
# Get started with Grafana OnCall
These procedures introduce you to the configuration of user settings, how to set up escalation policies, and how to use your calendar service for on-call scheduling.
Grafana OnCall is an incident response tool built to help DevOps and SRE teams improve their collaboration and resolve incidents faster.
## Before you begin
With a centralized view of all your alerts, automated alert escalation and grouping, and on-call scheduling, Grafana OnCall helps ensure that alert notifications reach the right people, at the right time using the right notification method.
You must have a [Grafana Cloud](https://grafana.com/products/cloud/) account or [Open Source Grafana OnCall]({{< relref " open-source.md" >}})
The following diagram details an example alert workflow with Grafana OnCall:
Each supported integration and the associated monitoring system has a slightly different configuration method. These methods will not be explained in this guide, however, you can follow the online instructions provided when adding an integration.
<img src="/static/img/docs/oncall/oncall-alertworkflow.png" class="no-shadow" width="700px">
## Configure user notification policies
These procedures introduce you to initial Grafana OnCall configuration steps, including monitoring system integration, how to set up escalation chains, and how to use your calendar service for on-call scheduling.
You can configure how each user will receive notifications when they are assigned in escalation policies.
1. Find users.
## Before you begin
Select the **Users** tab and use the browser to search for a user in your organization.
Grafana OnCall is available for Grafana Cloud as well as Grafana open source users. You must have a Grafana Cloud account or [Open Source Grafana OnCall]({{< relref "open-source.md" >}})
1. Configure user settings.
For more information, see [Grafana Pricing](https://grafana.com/pricing/) for details.
Add and verify a phone number and a Slack username if you want to deliver notifications using these mediums.
<br>
> **NOTE:** To edit a user's username, email, or role, you must do so in the **Users** tab in the **Configuration** menu of your Grafana instance.
## Install Open Source Grafana OnCall
1. Configure notification settings.
For Open Source Grafana OnCall installation guidance, refer to [Open Source Grafana OnCall]({{< relref "open-source.md" >}})
You can configure the notification medium and frequency for each user. **Important Notifications** are specified in escalation steps.
>**Note:** If you are using Grafana OnCall with your Grafana Cloud instance there are no install steps. Access Grafana OnCall from your Grafana Cloud account and skip ahead to “Get alerts into Grafana OnCall”
## Connect to integration data sources
You use Grafana OnCall to connect to the monitoring services of your alert sources listed in the Grafana OnCall **Integrations** section.
## Get alerts into Grafana OnCall
1. Connect to a alert source with configured alerts.
Once you’ve installed Grafana OnCall or accessed it from your Grafana Cloud instance, you can begin integrating with monitoring systems, configuring escalation chains, and get alerts into Grafana OnCall.
In Grafana OnCall, click on the **Integrations** tab and click **+ New integration for receiving alerts**.
### Integrate with a monitoring system
1. Select an integration from the provided options.
Regardless of where your alerts originate, you can send them to Grafana OnCall via available integrations or customizable webhooks. To start receiving alerts in Grafana OnCall, use the following steps to configure your first integration and send a demo alert.
If you want to use an integration that is not listed, you must use webhooks.
#### Configure your first integration:
1. In Grafana OnCall, navigate to the **Integrations** tab and click **+ New integration for receiving alerts**.
2. Select an integration from the provided options, if the integration you’re looking for isn’t listed, then select Webhook.
3. Follow the configuration steps on the integration settings page.
4. Complete any necessary configurations in your monitoring system to send alerts to Grafana OnCall.
1. Configure your integration.
Each integration has a different method of connecting to Grafana OnCall. For example, if you want to connect to your Grafana alert source, select Grafana and follow the instructions.
#### Send a demo alert
## Configure escalation policies
1. In the integration tab, click **Send demo alert** then navigate to the **Alert Groups** tab to see your test alert firing.
2. Explore the alert by clicking on the title of the alert.
3. Acknowledge and resolve the test alert.
You can use **escalation chains** to determine ordered escalation procedures. Configuring escalation chains allows you to set up a chain of incident notification actions that trigger if certain conditions that you specify are not met.
For more information on Grafana OnCall integrations and further configuration guidance, refer to, [Connect to Grafana OnCall]({{< relref "integrations/" >}})
1. Click on the integration tile for which you want to define escalation policies.
The **Escalations** section for the notification is in the pane to the right of the list of notifications.
You can click **Change alert template and grouping** to customize the look of the alert. You can also do this by clicking the **Settings** (gear) icon in the integration tile.
### Configure Escalation Chains
1. Create an escalation chain.
Escalation Chains are customizable automated alert routing steps that enable you to specify who is notified for a certain alert. In addition to escalation chains, you can configure Routes to send alerts to different escalation chains depending on the alert details.
In the escalation pane, click the **escalate to** menu to choose from previously added escalation chains, or create a new one by clicking **Create a new**. This will be the name of the escalation policy you define.
Once your integration is configured, you can set up an escalation chain to determine how alerts from your integration are handled. Multi-step escalation chains help ensure thorough alert escalation to prevent alerts from being missed.
1. Add escalation steps.
To configure Escalation Chains:
1. Navigate to the **Escalation Chains** tab and click **+ New Escalation Chain**
2. Give your Escalation Chain a useful name and click **Create**
3. Add a series of escalation steps from the available dropdown options.
4. To link your Escalation Chain to your integration, navigate back to the **Integrations tab**, Select your newly created Escalation Chain from the “**Escalate to**” dropdown.
Click **Add escalation step** to choose from a set of actions and specify their triggering conditions. By default, the first step is to notify a slack channel or user. Specify users or channels or toggle the switch to turn this step off.
Alerts from this integration will now follow the escalation steps configured in your Escalation Chain.
To mark an escalation as **Important**, select the option from the step **Start** dropdown menu. User notification policies can be separately defined for **Important** and **Default** escalations.
For more information on Escalation Chains and more ways to customize them, refer to [Configure and manage Escalation Chains]({{< relref "escalation-policies/configure-escalation-chains/" >}})
1. Add a route.
## Get notified of an alert
To add a route, click **Add Route**.
In order for Grafana OnCall to notify you of an alert, you must configure how you want to be notified. Personal notification policies, chatops integrations, and on-call schedules allow you to automate how users are notified of alerts.
You can set up a single route and specify notification escalation steps, or you can add multiple routes, each with its own configuration.
### Configure personal notification policies
Personal notification policies determine how a user is notified for a certain type of alert. Administrators can configure how users receive notification for certain types of alerts. For more information on personal notification policies, refer to [Manage users and teams for Grafana OnCall]({{< relref "configure-user-settings/" >}})
Each route added to an escalation policy follows an `IF`, `ELSE IF`, and `ELSE` path and depends on the type of alert you specify using a regular expression that matches content in the payload body of the alert. You can also specify where to send the notification for each route.
To configure users personal notification policies:
For example, you can send notifications for alert incidents with `\"severity\": \"critical\"` in the payload to an escalation chain called `Bob_OnCall`. You can create a different route for alerts with the payload `\"namespace\" *: *\"synthetic-monitoring-dev-.*\"` and select a escalation chain called `NotifySecurity`.
1. Navigate to the **Users** tab in Grafana OnCall
2. Select a user from the user list and click **Edit**
3. Configure **Default Notifications** and **Important Notification**
You can set up escalation steps for each route in a chain.
> **NOTE:** When you modify an escalation chain or a route, it will modify that escalation chain across all integrations that use it.
### Configure Slack for Grafana OnCall
## Use calendars to configure on-call schedules
Grafana OnCall integrates closely with your Slack workspace to deliver alert notifications to individuals, user groups, and channels. Slack notifications can be triggered by steps in an escalation chain or as a step in users personal notification policies.
You can use any calendar with an iCal address to schedule on-call times for users. During these times, notifications configured in escalation chains with the **Notify users from an on-call schedule** setting will be sent to the the person scheduled. You can also schedule multiple users for overlapping times, and assign prioritization labels for the user that you would like to notify.
To configure Slack for Grafana OnCall:
1. In the **Scheduling** section of Grafana OnCall, click **+ Create schedule**.
1. In OnCall, click on the ChatOps tab and select Slack in the side menu.
2. Click Install Slack integration.
3. Read the notice and confirm to proceed to the Slack website.
4. Sign in to your organization's Slack workspace.
5. Click Allow to allow Grafana OnCall to access Slack.
6. Ensure users verify their Slack accounts in their user profile in Grafana OnCall.
1. Give the schedule a name.
For further instruction on connecting to your Slack workspace, refer to [Connect Slack to Grafana OnCall]({{< relref "chat-options/configure-slack/" >}})
1. Create a new calendar in your calendar service and locate the secret iCal URL. For example, in a Google calendar, this URL can be found in **Settings > Settings for my calendars > Integrate calendar**.
1. Copy the secret iCal URL. In OnCall, paste it into the **Primary schedule for iCal URL** field.
The permissions you set for the calendar determine who can modify the calendar.
### Add your on-call schedule
1. Click **Create Schedule**.
Grafana OnCall allows you to manage your on-call schedule in your preferred calendar app such as Google Calendar or Microsoft Outlook.
1. Schedule on-call times for team members.
To integrate your on-call calendar with Grafana OnCall:
Use the usersname of team members as the event name to schedule their on-call times. You can take advantage of all of the features of your calendar service.
1. In the **Schedules** tab of Grafana OnCall, click **+ Add team schedule for on-call rotation**.
2. Provide a schedule name.
3. Copy the iCal URL associated with your on-call calendar from your calendar integration settings.
4. Configure the rest of the schedule settings and click Create Schedule
1. (Optional) Create overlapping schedules.
For more information on on-call schedules, refer to [Configure and manage on-call schedules]({{< relref "calendar-schedules/" >}})
When you create schedules that overlap, you can prioritize a schedule by adding a level marker. For example, if users AliceGrafana and BobGrafana have overlapping schedules, but BobGrafana is the primary contact, you would name his event `[L1] BobGrafana`, AliceGrafana maintains the default `[L0]` status, and would not receive notifications during the overlapping time. You can prioritize up to and including level 9, or `[L9]`.
### (Optional) Create an override calendar.
You can use an override calendar to allow team members to schedule on-call duties that will override the primary schedule. An override option allows flexibility without modifying the primary schedule. Events scheduled on the override calendar will always override overlapping events on the primary calendar.
1. Create a new calendar using the same calendar service you used to create the primary calendar.
Be sure to set permissions that allow team members to edit the calendar.
1. In the scheduling section of Grafana OnCall, select the primary calendar you want to override.
1. Click **Edit**.
1. Enter the secret iCal URL in the **Overrides schedule iCal URL** field and click **Update**.

7
docs/sources/integrations/_index.md
View file

@ -11,7 +11,8 @@ keywords:
- oncall
- integrations
title: Connect to Grafana OnCall
weight: 300
canonical: "https://grafana.com/docs/oncall/latest/integrations/"
weight: 500
---
# Connect to Grafana OnCall
@ -52,7 +53,7 @@ To customize alert grouping for an integration:
2. Select **Alert Behavior** from the dropdown menu next to **Edit template for**.
3. Edit the **grouping id**, **acknowledge condition**, and **resolve condition** templates as needed to customize your alert behavior.
For more information on alert templates, see [Configure alerts in Grafana OnCall]({{< relref " ../create-custom-templates/" >}})
For more information on alert templates, see [Configure alerts in Grafana OnCall]({{< relref "create-custom-templates/" >}})
#### Add Routes
@ -64,8 +65,6 @@ To add a route to an integration using regular expression:
4. Click **Create Route**.
5. Select an escalation chain for “**IF** alert payload matches regex” and “**ELSE**” to specify where to route each type of alert.
To learn more about routes, refer to [Configure and manage Routes]({{< relref " ../configure-routes/" >}})
#### Edit integration name
To edit the name of an integration:

3
docs/sources/integrations/add-webhook-integration.md
View file

@ -9,6 +9,7 @@ keywords:
- Alertmanager
- Prometheus
title: Webhook integration for Grafana OnCall
canonical: "https://grafana.com/docs/oncall/latest/integrations/add-webhook-integration/"
weight: 700
---
@ -55,4 +56,4 @@ For example:
}'
```
To learn how to use custom alert templates for formatted webhooks, see [Configure alerts in Grafana OnCall]({{< relref "../create-custom-templates/" >}}).
To learn how to use custom alert templates for formatted webhooks, see [Configure alerts in Grafana OnCall]({{< relref "../integrations/create-custom-templates/" >}}).

5
docs/sources/integrations/available-integrations /_index.md → docs/sources/integrations/available-integrations/_index.md
View file

@ -1,7 +1,7 @@
---
aliases:
- /docs/grafana-cloud/oncall/integrations/add-integration/
- /docs/oncall/latest/integrations/available-integrations /
- /docs/oncall/latest/integrations/available-integrations/
keywords:
- Grafana Cloud
- Alerts
@ -10,6 +10,7 @@ keywords:
- Alertmanager
- Prometheus
title: Currently available integrations for Grafana OnCall
canonical: "https://grafana.com/docs/oncall/latest/integrations/available-integrations/"
weight: 100
---
@ -17,7 +18,7 @@ weight: 100
Grafana OnCall can connect directly to the monitoring services where your alerts originate. All currently available integrations are listed in the Grafana OnCall **Create Integration** section.
If the integration you're looking for isn't currently listed, see [Configure Webhook integrations for Grafana OnCall]({{< relref " ../add-webhook-integration/" >}}) to integration your monitoring system with Grafana OnCall.
If the integration you're looking for isn't currently listed, see [Configure Webhook integrations for Grafana OnCall]({{< relref "../add-webhook-integration/" >}}) to integration your monitoring system with Grafana OnCall.
> **Note:** Some integrations are available for Grafana Cloud instances only. See individual integration guides for more information.

1
docs/sources/integrations/available-integrations /add-alertmanager.md → docs/sources/integrations/available-integrations/add-alertmanager.md
View file

@ -10,6 +10,7 @@ keywords:
- Alertmanager
- Prometheus
title: Connect Alert Manager to Grafana OnCall
canonical: "https://grafana.com/docs/oncall/latest/integrations/available-integrations/add-alertmanager/"
weight: 300
---

1
docs/sources/integrations/available-integrations /add-grafana-alerting.md → docs/sources/integrations/available-integrations/add-grafana-alerting.md
View file

@ -9,6 +9,7 @@ keywords:
- on-call
- Prometheus
title: Connect Grafana Alerting to Grafana OnCall
canonical: "https://grafana.com/docs/oncall/latest/integrations/available-integrations/add-grafana-alerting/"
weight: 100
---

1
docs/sources/integrations/available-integrations /add-zabbix.md → docs/sources/integrations/available-integrations/add-zabbix.md
View file

@ -8,6 +8,7 @@ keywords:
- on-call
- Zabbix
title: Connect Zabbix to Grafana OnCall
canonical: "https://grafana.com/docs/oncall/latest/integrations/available-integrations/add-zabbix/"
weight: 500
---

1
docs/sources/integrations/configure-outgoing-webhooks.md
View file

@ -9,6 +9,7 @@ keywords:
- amixr
- webhooks
title: Configure outgoing webhooks for Grafana OnCall
canonical: "https://grafana.com/docs/oncall/latest/integrations/configure-outgoing-webhooks/"
weight: 500
---

1
docs/sources/integrations/create-custom-templates.md
View file

@ -8,6 +8,7 @@ keywords:
- on-call
- Jinja
title: Configure alerts in Grafana OnCall
canonical: "https://grafana.com/docs/oncall/latest/integrations/create-custom-templates/"
weight: 300
---

3
docs/sources/oncall-api-reference/_index.md
View file

@ -2,7 +2,8 @@
aliases:
- /docs/oncall/latest/oncall-api-reference/
title: Grafana OnCall HTTP API reference
weight: 1300
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/"
weight: 1500
---
# HTTP API Reference

1
docs/sources/oncall-api-reference/alertgroups.md
View file

@ -3,6 +3,7 @@ aliases:
- /docs/grafana-cloud/oncall/oncall-api-reference/alertgroups/
- /docs/oncall/latest/oncall-api-reference/alertgroups/
title: Alert groups HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/alertgroups/"
weight: 400
---

1
docs/sources/oncall-api-reference/alerts.md
View file

@ -3,6 +3,7 @@ aliases:
- /docs/grafana-cloud/oncall/oncall-api-reference/alerts/
- /docs/oncall/latest/oncall-api-reference/alerts/
title: Alerts HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/alerts/"
weight: 100
---

1
docs/sources/oncall-api-reference/escalation_chains.md
View file

@ -3,6 +3,7 @@ aliases:
- /docs/grafana-cloud/oncall/oncall-api-reference/escalation_chains/
- /docs/oncall/latest/oncall-api-reference/escalation_chains/
title: Escalation Chains HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/escalation_chains/"
weight: 200
---

1
docs/sources/oncall-api-reference/escalation_policies.md
View file

@ -3,6 +3,7 @@ aliases:
- /docs/grafana-cloud/oncall/oncall-api-reference/escalation_policies/
- /docs/oncall/latest/oncall-api-reference/escalation_policies/
title: Escalation Policies HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/escalation_policies/"
weight: 300
---

3
docs/sources/oncall-api-reference/integrations.md
View file

@ -3,6 +3,7 @@ aliases:
- /docs/grafana-cloud/oncall/oncall-api-reference/integrations/
- /docs/oncall/latest/oncall-api-reference/integrations/
title: Integrations HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/integrations/"
weight: 500
---
@ -67,7 +68,7 @@ The above command returns JSON structured in the following way:
```
Integrations are sources of alerts and alert groups for Grafana OnCall.
For example, to learn how to integrate Grafana OnCall with Alertmanager see [Alertmanager]({{< relref "../integrations/add-alertmanager" >}}).
For example, to learn how to integrate Grafana OnCall with Alertmanager see [Alertmanager]({{< relref "../integrations/available-integrations/add-alertmanager/" >}}).
**HTTP request**

1
docs/sources/oncall-api-reference/on_call_shifts.md
View file

@ -3,6 +3,7 @@ aliases:
- /docs/grafana-cloud/oncall/oncall-api-reference/on_call_shifts/
- /docs/oncall/latest/oncall-api-reference/on_call_shifts/
title: OnCall shifts HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/on_call_shifts/"
weight: 600
---

1
docs/sources/oncall-api-reference/outgoing_webhooks.md
View file

@ -3,6 +3,7 @@ aliases:
- /docs/grafana-cloud/oncall/oncall-api-reference/outgoing_webhooks/
- /docs/oncall/latest/oncall-api-reference/outgoing_webhooks/
title: Outgoing webhooks HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/outgoing_webhooks/"
weight: 700
---

1
docs/sources/oncall-api-reference/personal_notification_rules.md
View file

@ -3,6 +3,7 @@ aliases:
- /docs/grafana-cloud/oncall/oncall-api-reference/personal_notification_rules/
- /docs/oncall/latest/oncall-api-reference/personal_notification_rules/
title: Personal Notification Rules HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/personal_notification_rules/"
weight: 800
---

1
docs/sources/oncall-api-reference/postmortem_messages.md
View file

@ -4,6 +4,7 @@ aliases:
- /docs/oncall/latest/oncall-api-reference/postmortem_messages/
draft: true
title: Postmortem Messages HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/postmortem_messages/"
weight: 900
---

1
docs/sources/oncall-api-reference/postmortems.md
View file

@ -4,6 +4,7 @@ aliases:
- /docs/oncall/latest/oncall-api-reference/postmortems/
draft: true
title: Postmortem HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/postmortems/"
weight: 1000
---

1
docs/sources/oncall-api-reference/routes.md
View file

@ -3,6 +3,7 @@ aliases:
- /docs/grafana-cloud/oncall/oncall-api-reference/routes/
- /docs/oncall/latest/oncall-api-reference/routes/
title: Routes HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/routes/"
weight: 1100
---

1
docs/sources/oncall-api-reference/schedules.md
View file

@ -3,6 +3,7 @@ aliases:
- /docs/grafana-cloud/oncall/oncall-api-reference/schedules/
- /docs/oncall/latest/oncall-api-reference/schedules/
title: Schedule HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/schedules/"
weight: 1200
---

1
docs/sources/oncall-api-reference/slack_channels.md
View file

@ -3,6 +3,7 @@ aliases:
- /docs/grafana-cloud/oncall/oncall-api-reference/slack_channels/
- /docs/oncall/latest/oncall-api-reference/slack_channels/
title: Slack Channels HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/slack_channels/"
weight: 1300
---

1
docs/sources/oncall-api-reference/user_groups.md
View file

@ -3,6 +3,7 @@ aliases:
- /docs/grafana-cloud/oncall/oncall-api-reference/user_groups/
- /docs/oncall/latest/oncall-api-reference/user_groups/
title: OnCall User Groups HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/user_groups/"
weight: 1400
---

1
docs/sources/oncall-api-reference/users.md
View file

@ -3,6 +3,7 @@ aliases:
- /docs/grafana-cloud/oncall/oncall-api-reference/users/
- /docs/oncall/latest/oncall-api-reference/users/
title: Grafana OnCall Users HTTP API
canonical: "https://grafana.com/docs/oncall/latest/oncall-api-reference/users/"
weight: 1500
---

2
docs/sources/open-source.md
View file

@ -5,7 +5,7 @@ aliases:
keywords:
- Open Source
title: Open Source
weight: 100
weight: 300
---
# Open Source