1735db4c3b
# What this PR does The `docs/reference` shortcode supports contextual destinations and version inference. `<ONCALL VERSION>` is inferred to match the version of the documentation set. For example, the inferred version for the page /docs/grafana/oncall/latest/get-started/ is "latest". It can also be overriden using front matter. Given the same page, but with the additional front matter `oncall_version: next`, the variable is substituted with "next" rather than "latest". Contextual destinations are achieved using repeated labels in the shortcode inner text. The format is [<LABEL>]: "<PAGE PATH PREFIX> -> <HUGO REFERENCE>". - _`<LABEL>`_ matches the reference style link label used in the rest of the text. - _`<PAGE PATH PREFIX>`_ is matched against the page during the production build. If the match is successful, the destination that is used is _`<HUGO REFERENCE>`_. The first matching prefix is used, not the longest matching prefix. ## Which issue(s) this PR fixes - Broken links due to ambiguous relref resolution. Any relref parameter that does not start with either `/`, `./`, or `../` can resolve ambiguously and is resulting in broken link behavior on the current site. - Broken links in Grafana Cloud. We mount OnCall documentation in Grafana Cloud. In https://github.com/grafana/website/pull/13872 the location will become /docs/grafana-cloud/alerting-and-irm/oncall. This PR is intended to be merged alongside that PR. --------- Signed-off-by: Jack Baldry <jack.baldry@grafana.com> Co-authored-by: Joey Orlando <joey.orlando@grafana.com>
39 lines
1.7 KiB
Markdown
39 lines
1.7 KiB
Markdown
---
|
|
aliases:
|
|
- add-stackdriver/
|
|
- /docs/oncall/latest/integrations/available-integrations/configure-stackdriver/
|
|
canonical: https://grafana.com/docs/oncall/latest/integrations/available-integrations/configure-stackdriver/
|
|
keywords:
|
|
- Grafana Cloud
|
|
- Alerts
|
|
- Notifications
|
|
- on-call
|
|
- stackdriver
|
|
title: Stackdriver
|
|
weight: 500
|
|
---
|
|
|
|
# Stackdriver integration for Grafana OnCall
|
|
|
|
The Stackdriver integration for Grafana OnCall handles ticket events sent from Stackdriver 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 Stackdriver
|
|
|
|
1. In the **Integrations** tab, click **+ New integration**.
|
|
2. Select **Stackdriver** 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 Stackdriver to Send Alerts to Grafana OnCall
|
|
|
|
1. Create a notification channel in Stackdriver by navigating to Workspace Settings -> WEBHOOKS -> Add Webhook **OnCall Integration URL**
|
|
|
|
2. Create and alert in Stackdriver by navigating to Alerting -> Policies -> Add Policy -> Choose Notification Channel using the channel set up in step 1
|
|
|
|
{{% docs/reference %}}
|
|
[user-and-team-management]: "/docs/oncall/ -> /docs/oncall/<ONCALL VERSION>/user-and-team-management"
|
|
[user-and-team-management]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/alerting-and-irm/oncall/user-and-team-management"
|
|
{{% /docs/reference %}}
|