From 092693d0bf888f692ee3cfc9a05d4989f65a37a0 Mon Sep 17 00:00:00 2001 From: Dalje-et Date: Tue, 1 Apr 2025 22:29:27 +0200 Subject: [PATCH 1/6] Add Documentation for Handover Automations --- .../service_management/on-call/automations.md | 32 +++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 content/en/service_management/on-call/automations.md diff --git a/content/en/service_management/on-call/automations.md b/content/en/service_management/on-call/automations.md new file mode 100644 index 0000000000000..6269c3c89c2b9 --- /dev/null +++ b/content/en/service_management/on-call/automations.md @@ -0,0 +1,32 @@ +--- +title: Automations +further_reading: +- link: '/service_management/on-call/' + tag: 'Documentation' + text: 'Datadog On-Call' +- link: "https://docs.datadoghq.com/service_management/workflows/" + tag: "Documentation" + text: "Workflow Automation" +--- + +Automations let you trigger actions based on events in On-Call. There are two types: handover automations, which run when an on-call shift changes, and [workflow automations][1], a low-code/no-code solution that will allow users to trigger actions based on on-call activity. + +# Handover Automations +Handover automations run automatically at the start or end of an on-call shift. They’re built for the kinds of tasks teams often handled with custom scripts—like alerting another system about who’s on-call, updating internal dashboards, or rotating credentials. Instead of maintaining cron jobs or one-off tools, you can now run these actions directly through built-in automation. It removes manual steps and makes sure the right tasks run every time a shift changes. + +
+The list of supported actions isn’t final. If you need a specific action that isn’t currently offered, contact your account representative or support@datadoghq.com to let us know. +
+ +Handover Automations are maintained on a Team level. To get started, visit your On-Call Team and scroll down to the Handover Automation section! + +### Send a Slack Message +Post a message to Slack at the start or end of a shift using a handover automation. The message shows the previous and next on-call users (if any). Note: This requires the Datadog Slack app—make sure it’s [added to your workspace][2]. + +### Send a Microsoft Teams Message +Post a message to Microsoft Teams at the start or end of a shift using a handover automation. The message shows the previous and next on-call users (if any). Note: This requires the Datadog Teams app—make sure it’s [added to your workspace][3]. + + +[1]: /service_management/workflows/ +[2]: /integrations/slack/?tab=datadogforslack#install-the-datadog-app-in-your-slack-workspace +[3]: /integrations/microsoft_teams/?tab=datadogapprecommended#overview \ No newline at end of file From 23f0f6c0818edeffe16d6531a24abf02a29e8613 Mon Sep 17 00:00:00 2001 From: Dalje-et Date: Tue, 1 Apr 2025 22:32:59 +0200 Subject: [PATCH 2/6] Add automations to doc navbar --- config/_default/menus/main.en.yaml | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/config/_default/menus/main.en.yaml b/config/_default/menus/main.en.yaml index 9227daf2a3f87..9880372798dfa 100644 --- a/config/_default/menus/main.en.yaml +++ b/config/_default/menus/main.en.yaml @@ -2378,16 +2378,21 @@ menu: parent: oncall identifier: oncall_schedules weight: 5 + - name: Automations + url: service_management/on-call/automations + parent: oncall + identifier: oncall_automations + weight: 6 - name: Profile Settings url: service_management/on-call/profile_settings/ parent: oncall identifier: oncall_profile_settings - weight: 6 + weight: 7 - name: Guides url: service_management/on-call/guides/ parent: oncall identifier: oncall_guides - weight: 7 + weight: 8 - name: Event Management url: service_management/events/ pre: events From 0b80dbe702b58b448ea12efe20f680bbc43dd084 Mon Sep 17 00:00:00 2001 From: Dalje-et Date: Tue, 1 Apr 2025 22:38:58 +0200 Subject: [PATCH 3/6] Use straight quotes instead of smart quotes --- content/en/service_management/on-call/automations.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/service_management/on-call/automations.md b/content/en/service_management/on-call/automations.md index 6269c3c89c2b9..5e21a1d94ad9c 100644 --- a/content/en/service_management/on-call/automations.md +++ b/content/en/service_management/on-call/automations.md @@ -12,19 +12,19 @@ further_reading: Automations let you trigger actions based on events in On-Call. There are two types: handover automations, which run when an on-call shift changes, and [workflow automations][1], a low-code/no-code solution that will allow users to trigger actions based on on-call activity. # Handover Automations -Handover automations run automatically at the start or end of an on-call shift. They’re built for the kinds of tasks teams often handled with custom scripts—like alerting another system about who’s on-call, updating internal dashboards, or rotating credentials. Instead of maintaining cron jobs or one-off tools, you can now run these actions directly through built-in automation. It removes manual steps and makes sure the right tasks run every time a shift changes. +Handover automations run automatically at the start or end of an on-call shift. They're built for the kinds of tasks teams often handled with custom scripts—like alerting another system about who's on-call, updating internal dashboards, or rotating credentials. Instead of maintaining cron jobs or one-off tools, you can now run these actions directly through built-in automation. It removes manual steps and makes sure the right tasks run every time a shift changes.
-The list of supported actions isn’t final. If you need a specific action that isn’t currently offered, contact your account representative or support@datadoghq.com to let us know. +The list of supported actions isn't final. If you need a specific action that isn't currently offered, contact your account representative or support@datadoghq.com to let us know.
Handover Automations are maintained on a Team level. To get started, visit your On-Call Team and scroll down to the Handover Automation section! ### Send a Slack Message -Post a message to Slack at the start or end of a shift using a handover automation. The message shows the previous and next on-call users (if any). Note: This requires the Datadog Slack app—make sure it’s [added to your workspace][2]. +Post a message to Slack at the start or end of a shift using a handover automation. The message shows the previous and next on-call users (if any). Note: This requires the Datadog Slack app—make sure it's [added to your workspace][2]. ### Send a Microsoft Teams Message -Post a message to Microsoft Teams at the start or end of a shift using a handover automation. The message shows the previous and next on-call users (if any). Note: This requires the Datadog Teams app—make sure it’s [added to your workspace][3]. +Post a message to Microsoft Teams at the start or end of a shift using a handover automation. The message shows the previous and next on-call users (if any). Note: This requires the Datadog Teams app—make sure it's [added to your workspace][3]. [1]: /service_management/workflows/ From 7cb0adcd3b84b3131c494042f57135742ab13e32 Mon Sep 17 00:00:00 2001 From: Daljeet <28733517+Dalje-et@users.noreply.github.com> Date: Wed, 9 Apr 2025 13:05:50 +0200 Subject: [PATCH 4/6] Apply suggestions from code review PR Review Co-authored-by: Esther Kim --- .../service_management/on-call/automations.md | 28 +++++++++++++------ 1 file changed, 20 insertions(+), 8 deletions(-) diff --git a/content/en/service_management/on-call/automations.md b/content/en/service_management/on-call/automations.md index 5e21a1d94ad9c..252dde965ae5c 100644 --- a/content/en/service_management/on-call/automations.md +++ b/content/en/service_management/on-call/automations.md @@ -9,24 +9,36 @@ further_reading: text: "Workflow Automation" --- -Automations let you trigger actions based on events in On-Call. There are two types: handover automations, which run when an on-call shift changes, and [workflow automations][1], a low-code/no-code solution that will allow users to trigger actions based on on-call activity. +## Overview + +Automations allow you to trigger actions based on events in On-Call. There are two types: +- **Handover automations** – Triggered automatically when an on-call shift changes. +- **[Workflow automations][1]** – A low-code/no-code solution that lets you define actions based on various on-call activities. + + +## Handover automations +Handover automations run automatically at the start or end of an on-call shift. They're designed to handle tasks that teams typically manage with custom scripts—such as notifying other systems about who's on-call, updating internal dashboards, or rotating credentials. + +By using built-in automation instead of maintaining cron jobs or custom tools, you can streamline operations, eliminate manual steps, and ensure the right actions always run when a shift changes. -# Handover Automations -Handover automations run automatically at the start or end of an on-call shift. They're built for the kinds of tasks teams often handled with custom scripts—like alerting another system about who's on-call, updating internal dashboards, or rotating credentials. Instead of maintaining cron jobs or one-off tools, you can now run these actions directly through built-in automation. It removes manual steps and makes sure the right tasks run every time a shift changes.
-The list of supported actions isn't final. If you need a specific action that isn't currently offered, contact your account representative or support@datadoghq.com to let us know. +If you need a specific action that isn't listed, contact your account representative or support@datadoghq.com.
-Handover Automations are maintained on a Team level. To get started, visit your On-Call Team and scroll down to the Handover Automation section! +Handover Automations are maintained on a Team level. To get started, navigate to the [On-Call Team][4], open a specific team and scroll down to the **Handover Automation** section. ### Send a Slack Message -Post a message to Slack at the start or end of a shift using a handover automation. The message shows the previous and next on-call users (if any). Note: This requires the Datadog Slack app—make sure it's [added to your workspace][2]. +Post a message to Slack at the start or end of a shift using a handover automation. The message shows the previous and next on-call users (if any). **Note**: This requires the Datadog Slack app—make sure it's [added to your workspace][2]. ### Send a Microsoft Teams Message -Post a message to Microsoft Teams at the start or end of a shift using a handover automation. The message shows the previous and next on-call users (if any). Note: This requires the Datadog Teams app—make sure it's [added to your workspace][3]. +Post a message to Microsoft Teams at the start or end of a shift using a handover automation. The message shows the previous and next on-call users (if any). **Note**: This requires the Datadog Teams app—make sure it's [added to your workspace][3]. + +## Further reading +{{< partial name="whats-next/whats-next.html" >}} [1]: /service_management/workflows/ [2]: /integrations/slack/?tab=datadogforslack#install-the-datadog-app-in-your-slack-workspace -[3]: /integrations/microsoft_teams/?tab=datadogapprecommended#overview \ No newline at end of file +[3]: /integrations/microsoft_teams/?tab=datadogapprecommended#overview +[4]: https://app.datadoghq.com/on-call/teams \ No newline at end of file From ce0024c259df3e14ee0c73279a21343996bbee42 Mon Sep 17 00:00:00 2001 From: Dalje-et Date: Wed, 9 Apr 2025 14:18:52 +0200 Subject: [PATCH 5/6] Fix Vale warnings --- .../en/service_management/on-call/automations.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/en/service_management/on-call/automations.md b/content/en/service_management/on-call/automations.md index 252dde965ae5c..f6abcbdb1e830 100644 --- a/content/en/service_management/on-call/automations.md +++ b/content/en/service_management/on-call/automations.md @@ -9,11 +9,11 @@ further_reading: text: "Workflow Automation" --- -## Overview +## Overview Automations allow you to trigger actions based on events in On-Call. There are two types: -- **Handover automations** – Triggered automatically when an on-call shift changes. -- **[Workflow automations][1]** – A low-code/no-code solution that lets you define actions based on various on-call activities. +- **Handover automations**: Triggered automatically when an on-call shift changes. +- **[Workflow automations][1]**: A low-code/no-code solution that lets you define actions based on various on-call activities. ## Handover automations @@ -28,17 +28,17 @@ If you need a specific action that isn't listed, contact your account representa Handover Automations are maintained on a Team level. To get started, navigate to the [On-Call Team][4], open a specific team and scroll down to the **Handover Automation** section. -### Send a Slack Message +### Send a Slack message Post a message to Slack at the start or end of a shift using a handover automation. The message shows the previous and next on-call users (if any). **Note**: This requires the Datadog Slack app—make sure it's [added to your workspace][2]. -### Send a Microsoft Teams Message +### Send a Microsoft Teams message Post a message to Microsoft Teams at the start or end of a shift using a handover automation. The message shows the previous and next on-call users (if any). **Note**: This requires the Datadog Teams app—make sure it's [added to your workspace][3]. ## Further reading -{{< partial name="whats-next/whats-next.html" >}} +{{< partial name="whats-next/whats-next.html" >}} [1]: /service_management/workflows/ [2]: /integrations/slack/?tab=datadogforslack#install-the-datadog-app-in-your-slack-workspace [3]: /integrations/microsoft_teams/?tab=datadogapprecommended#overview -[4]: https://app.datadoghq.com/on-call/teams \ No newline at end of file +[4]: https://app.datadoghq.com/on-call/teams From 7bbf69ad3792b35202b5ca57f58e507264875985 Mon Sep 17 00:00:00 2001 From: Daljeet <28733517+Dalje-et@users.noreply.github.com> Date: Wed, 9 Apr 2025 17:28:17 +0200 Subject: [PATCH 6/6] Apply suggestions from code review changes from review Co-authored-by: Esther Kim --- content/en/service_management/on-call/automations.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/service_management/on-call/automations.md b/content/en/service_management/on-call/automations.md index f6abcbdb1e830..3afc8bb96a5e0 100644 --- a/content/en/service_management/on-call/automations.md +++ b/content/en/service_management/on-call/automations.md @@ -19,14 +19,14 @@ Automations allow you to trigger actions based on events in On-Call. There are t ## Handover automations Handover automations run automatically at the start or end of an on-call shift. They're designed to handle tasks that teams typically manage with custom scripts—such as notifying other systems about who's on-call, updating internal dashboards, or rotating credentials. -By using built-in automation instead of maintaining cron jobs or custom tools, you can streamline operations, eliminate manual steps, and ensure the right actions always run when a shift changes. +By using built-in automations instead of maintaining cron jobs or custom tools, you can streamline operations, eliminate manual steps, and ensure the right actions always run when a shift changes.
If you need a specific action that isn't listed, contact your account representative or support@datadoghq.com.
-Handover Automations are maintained on a Team level. To get started, navigate to the [On-Call Team][4], open a specific team and scroll down to the **Handover Automation** section. +Handover Automations are maintained on a Team level. To get started, navigate to [On-Call Team][4], open a specific team, and scroll down to the **Handover Automation** section. ### Send a Slack message Post a message to Slack at the start or end of a shift using a handover automation. The message shows the previous and next on-call users (if any). **Note**: This requires the Datadog Slack app—make sure it's [added to your workspace][2].