diff --git a/config/_default/menus/main.en.yaml b/config/_default/menus/main.en.yaml index 69ba6d57d55..3436f8b89fc 100644 --- a/config/_default/menus/main.en.yaml +++ b/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 diff --git a/content/en/incident_response/on-call/integrations.md b/content/en/incident_response/on-call/integrations.md new file mode 100644 index 00000000000..d13cdddea43 --- /dev/null +++ b/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-` to route the Page to the correct On-Call team. | + +The `@oncall-` mention in `text` determines which On-Call team receives the Page. Replace `` 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" >}} diff --git a/content/en/incident_response/on-call/pages/_index.md b/content/en/incident_response/on-call/pages/_index.md index 39ad1c8a8d6..8d738f669b9 100644 --- a/content/en/incident_response/on-call/pages/_index.md +++ b/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/ diff --git a/layouts/shortcodes/integration-tile-grid.html b/layouts/shortcodes/integration-tile-grid.html new file mode 100644 index 00000000000..7abac525bd1 --- /dev/null +++ b/layouts/shortcodes/integration-tile-grid.html @@ -0,0 +1,4 @@ +{{ $inner := .Inner }} +
+ {{ $inner }} +
diff --git a/layouts/shortcodes/integration-tile.html b/layouts/shortcodes/integration-tile.html new file mode 100644 index 00000000000..ef197867846 --- /dev/null +++ b/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 }} + +
+
+ {{ if eq $preview "true" }} +
+

Preview

+
+ {{ end }} +
+ + {{ with $int_logo }} + + {{ $alt }} + +
{{ $title }}
+ {{ else }} +
{{ $title }}
+ {{ end }} + +
+
+