On-Call integrations documentation

config/_default/menus/main.en.yaml

@@ -2816,11 +2816,16 @@ menu:
       parent: oncall
       identifier: oncall_profile_settings
       weight: 7
+    - name: Integrations
+      url: incident_response/on-call/integrations/
+      parent: oncall
+      identifier: oncall_integrations
+      weight: 8
     - name: Guides
       url: incident_response/on-call/guides/
       parent: oncall
       identifier: oncall_guides
-      weight: 8
+      weight: 9
     - name: Status Pages
       url: incident_response/status_pages/
       pre: status-page-wui

content/en/incident_response/on-call/integrations.md

@@ -0,0 +1,62 @@
+---
+title: On-Call Integrations
+further_reading:
+- link: '/incident_response/on-call/'
+  tag: 'Documentation'
+  text: 'Datadog On-Call'
+- link: '/incident_response/on-call/pages/'
+  tag: 'Documentation'
+  text: 'Pages'
+- link: '/incident_response/on-call/routing_rules/'
+  tag: 'Documentation'
+  text: 'Routing Rules'
+---
+
+## Overview
+
+Datadog On-Call supports multiple triggering sources beyond native Datadog monitors. Use third-party tools to send Pages directly to your On-Call teams, so alerts from any part of your stack reach the right responders through your configured escalation policies.
+
+{{< beta-callout url="https://www.datadoghq.com/product-preview/on-call-integrations/" >}}
+To use an integration marked "Preview", or to request a new integration, request access.
+{{< /beta-callout >}}
+
+{{< integration-tile-grid >}}
+  {{< integration-tile href="/incident_response/on-call/pages/#through-slack" logo_id="slack" src="integrations_logos/slack.png" alt="Slack" title="Slack" >}}
+  {{< integration-tile href="/incident_response/on-call/pages/#through-microsoft-teams" logo_id="microsoft-teams" src="integrations_logos/microsoft_teams.png" alt="Microsoft Teams" title="Microsoft Teams" >}}
+  {{< integration-tile href="/integrations/prometheus/?tab=v2preferred#prometheus-alertmanager" logo_id="prometheus" src="integrations_logos/prometheus.png" alt="Prometheus Alertmanager" title="Prometheus Alertmanager" >}}
+  {{< integration-tile href="/integrations/pingdom/#page-a-datadog-on-call-team" logo_id="pingdom-v3" src="integrations_logos/pingdom.png" alt="Pingdom" title="Pingdom" >}}
+  {{< integration-tile href="/integrations/sentry/#page-a-datadog-on-call-team" logo_id="sentry" src="integrations_logos/sentry.png" alt="Sentry" title="Sentry" >}}
+  {{< integration-tile href="/integrations/amazon-sns/#page-a-datadog-on-call-team-from-sns" logo_id="amazon-sns" src="integrations_logos/amazon_sns.png" alt="Amazon CloudWatch" title="Amazon CloudWatch" >}}
+  {{< integration-tile href="/integrations/azure-monitor-alerts/#page-a-datadog-on-call-team" logo_id="azure" src="integrations_logos/azure.png" alt="Azure Monitor" title="Azure Monitor" >}}
+  {{< integration-tile href="/integrations/zabbix/#trigger-on-call-pages" logo_id="zabbix" src="integrations_logos/zabbix.png" alt="Zabbix" title="Zabbix" >}}
+  {{< integration-tile href="/integrations/nagios/?tab=host#trigger-on-call-pages" logo_id="nagios" src="integrations_logos/nagios.png" alt="Nagios" title="Nagios" >}}
+  {{< integration-tile href="/integrations/catchpoint/#events" logo_id="catchpoint" src="integrations_logos/catchpoint.png" alt="Catchpoint" title="Catchpoint" >}}
+  {{< integration-tile href="/integrations/sumo-logic/#trigger-on-call-pages" logo_id="sumo-logic" src="integrations_logos/sumo_logic.png" alt="Sumo Logic" title="Sumo Logic" >}}
+  {{< integration-tile href="/integrations/new-relic/#trigger-on-call-pages" logo_id="new-relic" src="integrations_logos/new_relic.png" alt="New Relic" title="New Relic" >}}
+  {{< integration-tile href="https://www.datadoghq.com/product-preview/on-call-integrations/" logo_id="bugsnag" src="integrations_logos/bugsnag.png" alt="BugSnag" title="BugSnag" preview="true" >}}
+  {{< integration-tile href="https://www.datadoghq.com/product-preview/on-call-integrations/" title="Coralogix" preview="true" >}}
+  {{< integration-tile href="https://www.datadoghq.com/product-preview/on-call-integrations/" title="Cronitor" preview="true" >}}
+  {{< integration-tile href="https://www.datadoghq.com/product-preview/on-call-integrations/" logo_id="uptime" src="integrations_logos/uptime.png" alt="uptime.com" title="uptime.com" preview="true" >}}
+  {{< integration-tile href="https://www.datadoghq.com/product-preview/on-call-integrations/" title="Dynatrace" preview="true" >}}
+{{< /integration-tile-grid >}}
+
+## Other tools
+
+If your tool is not listed above, use the [Datadog Events API][1] to trigger On-Call pages from any source that can make an HTTP request.
+
+Post an event with the following parameters:
+
+| Parameter | Value |
+|-----------|-------|
+| `alert_type` | `error` |
+| `aggregation_key` | A string that groups related alerts into a single Page. |
+| `title` | A short description of the alert. |
+| `text` | Include `@oncall-<team_handle>` to route the Page to the correct On-Call team. |
+
+The `@oncall-<team_handle>` mention in `text` determines which On-Call team receives the Page. Replace `<team_handle>` with your team's handle as configured in Datadog.
+
+[1]: https://docs.datadoghq.com/api/latest/events/post-an-event/
+
+## Further Reading
+
+{{< partial name="whats-next/whats-next.html" >}}

content/en/incident_response/on-call/pages/_index.md

@@ -95,6 +95,14 @@ Pages sent from Slack are always `high` urgency.
 
 To receive Page notifications in Slack, see [Routing Rules][4].
 
+#### Through Microsoft Teams
+
+1. Install the [Datadog Microsoft Teams app][9].
+1. In any channel or chat, enter `@Datadog page`.
+1. Select a Team to send a Page to.
+
+Pages sent from Microsoft Teams are always `high` urgency.
+
 ## Respond to a Page
 
 Go to [**On-Call** > **Pages**][7] to view all active and historical Pages. Click a Page to open its side panel and take action, or select the checkbox next to one or more Pages to bulk-edit them.
@@ -185,3 +193,4 @@ To add a comment, open the Page and enter your text in the **Timeline** section.
 [6]: /incident_response/incident_management/
 [7]: https://app.datadoghq.com/on-call/pages
 [8]: /monitors/notify/#renotify
+[9]: /integrations/microsoft-teams/

layouts/shortcodes/integration-tile-grid.html

@@ -0,0 +1,4 @@
+{{ $inner := .Inner }}
+<div class="row integration-row mx-0">
+  {{ $inner }}
+</div>

layouts/shortcodes/integration-tile.html

@@ -0,0 +1,38 @@
+{{ $href := .Get "href" }}
+{{ $logo_id := .Get "logo_id" }}
+{{ $src := .Get "src" }}
+{{ $alt := .Get "alt" | default "" }}
+{{ $title := .Get "title" }}
+{{ $preview := .Get "preview" }}
+
+{{ $int_logo := "" }}
+{{ with $logo_id }}
+  {{ $int_logo = partialCached "integrations-logo.html" (dict "context" $ "basename" . "variant" "avatar") . "avatar" }}
+{{ end }}
+{{ if not $int_logo }}
+  {{ with $src }}
+    {{ $int_logo = (print $.Site.Params.img_url "images/" .) | safeURL }}
+  {{ end }}
+{{ end }}
+
+<div class="item">
+  <div class="integration{{ if eq $preview "true" }} integration-marketplace{{ end }}">
+    {{ if eq $preview "true" }}
+      <div class="card-banner">
+        <p class="font-primary fw-bold text-uppercase text-center">Preview</p>
+      </div>
+    {{ end }}
+    <div class="card-content">
+      <a href="{{ $href }}">
+        {{ with $int_logo }}
+          <picture class="mx-auto my-auto">
+            <img class="img-fluid mx-auto my-auto pt-2 pb-5 px-5" src="{{ . }}" alt="{{ $alt }}" loading="lazy">
+          </picture>
+          <div class="text-center picture-title">{{ $title }}</div>
+        {{ else }}
+          <div class="text-center picture-title" style="position: static;">{{ $title }}</div>
+        {{ end }}
+      </a>
+    </div>
+  </div>
+</div>