Skip to content

Commit 49c0e18

Browse files
estherk15claude
andauthored
[DOCS-14661] Migrate On-Call images to incident_response/on-call/ and organize into per-page subfolders (#37699)
* Remove unreferenced images from service_management/oncall/ Deleted 7 image(s) with no references in any content files. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * Move oncall images from service_management/ to incident_response/on-call/ Relocates static/images/service_management/oncall/ to static/images/incident_response/on-call/ and updates all markdown image references in English content. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * Update oncall image paths in translated content Updates service_management/oncall/ image references to incident_response/on-call/ across translated content files to match the English path migration. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * Organize on-call images into per-page subfolders Restructures static/images/incident_response/on-call/ so images live in subfolders matching the content page structure (automations/, escalation_policies/, guides/<page>/, pages/, etc.). Images shared across pages and section index images remain at the on-call/ root. Updates English image references accordingly. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * Update translated on-call image paths to per-page subfolders Updates image references in translated content to match the English per-page subfolder structure under incident_response/on-call/. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * Remove non-docs slash-command file from on-call migration branch Untracks .claude/commands/migrate-images.md, which was unintentionally included; it is unrelated to the On-Call image migration. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
1 parent f391412 commit 49c0e18

90 files changed

Lines changed: 126 additions & 126 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ cascade:
2222

2323
Datadog On-Call integrates monitoring, paging, and incident response into one platform.
2424

25-
{{< img src="service_management/oncall/oncall_overview.png" alt="Overview of how Pages are routed. From a monitor, incident, security signal, or API call, the Page is sent to a Team (e.g. 'payments-team'), then to routing rules (e.g. based on priority) then to an escalation policy. There, it can be sent to a schedule or directly to a user." style="width:100%;" >}}
25+
{{< img src="incident_response/on-call/oncall_overview.png" alt="Overview of how Pages are routed. From a monitor, incident, security signal, or API call, the Page is sent to a Team (e.g. 'payments-team'), then to routing rules (e.g. based on priority) then to an escalation policy. There, it can be sent to a schedule or directly to a user." style="width:100%;" >}}
2626

2727
## Concepts
2828

@@ -36,15 +36,15 @@ Datadog On-Call integrates monitoring, paging, and incident response into one pl
3636

3737
**Teams** are the central organizational unit of Datadog On-Call. When a notification is triggered in Datadog, a **Page** is sent to the designated On-Call Team.
3838

39-
{{< img src="service_management/oncall/notification_page.png" alt="Notification that mentions an On-Call Team." style="width:80%;" >}}
39+
{{< img src="incident_response/on-call/notification_page.png" alt="Notification that mentions an On-Call Team." style="width:80%;" >}}
4040

4141
Each Team owns **escalation policies** and **schedules**. Escalation policies define how a Page is sent to various schedules, such as _Checkout Operations - Interrupt Handler_, _Primary_, and _Secondary_ in the following screenshot. Each Team can also configure **routing rules** to route Pages to different escalation policies.
4242

43-
{{< img src="service_management/oncall/escalation_policy.png" alt="A sample escalation policy." style="width:80%;" >}}
43+
{{< img src="incident_response/on-call/escalation_policy.png" alt="A sample escalation policy." style="width:80%;" >}}
4444

4545
A schedule defines specific times when Team members are assigned to respond to Pages. Schedules organize and manage the availability of Team members across different time zones and shifts.
4646

47-
{{< img src="service_management/oncall/schedule.png" alt="A sample schedule, with multiple layers for JP, EU, and US business hours." style="width:80%;" >}}
47+
{{< img src="incident_response/on-call/schedule.png" alt="A sample schedule, with multiple layers for JP, EU, and US business hours." style="width:80%;" >}}
4848

4949
## Granular access control
5050

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

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ further_reading:
2222

2323
## Overview
2424

25-
{{< img src="service_management/oncall/handover-automation.png" alt="The Handover Automation section on an On-Call team page" style="width:80%;" >}}
25+
{{< img src="incident_response/on-call/automations/handover-automation.png" alt="The Handover Automation section on an On-Call team page" style="width:80%;" >}}
2626

2727
Handover automations run automatically when on-call duty passes from one person to another. They handle tasks that teams typically manage with custom scripts, such as notifying other systems about who's on-call, updating internal chat channels, or triggering downstream workflows.
2828

@@ -73,27 +73,27 @@ For example, you can use this action to:
7373

7474
Posts a handover summary to a Slack channel showing who is handing off to whom for each selected schedule. You can also include an AI-generated shift summary.
7575

76-
{{< img src="service_management/oncall/handover-automation-slack-message.png" alt="Example Slack handover message showing shift change details" style="width:80%;" >}}
76+
{{< img src="incident_response/on-call/automations/handover-automation-slack-message.png" alt="Example Slack handover message showing shift change details" style="width:80%;" >}}
7777

7878
#### Update channel topic
7979

8080
Updates a Slack channel topic when a shift changes. Use numbered variables (`{{1}}`, `{{2}}`, and so on) in a customizable template to reference responders in schedule order. For example, `On-call: {{1}} (backup: {{2}})` resolves to the primary and secondary on-call responders when the shift changes.
8181

82-
{{< img src="service_management/oncall/handover-automation-slack-channel-topic.png" alt="Configuration form for the Slack Update channel topic automation" style="width:80%;" >}}
82+
{{< img src="incident_response/on-call/automations/handover-automation-slack-channel-topic.png" alt="Configuration form for the Slack Update channel topic automation" style="width:80%;" >}}
8383

8484
Channel topics have a character limit. The UI validates the template before saving.
8585

8686
#### Send a direct message
8787

8888
Sends a direct message to the incoming on-call responder when their shift begins.
8989

90-
{{< img src="service_management/oncall/handover-automation-slack-direct-message.png" alt="Configuration form for the Slack Send a direct message automation" style="width:80%;" >}}
90+
{{< img src="incident_response/on-call/automations/handover-automation-slack-direct-message.png" alt="Configuration form for the Slack Send a direct message automation" style="width:80%;" >}}
9191

9292
#### Update user group
9393

9494
Updates the members of a Slack user group to match the current on-call responders for the selected schedules.
9595

96-
{{< img src="service_management/oncall/handover-automation-slack-update-group.png" alt="Configuration form for the Slack Update user group automation" style="width:80%;" >}}
96+
{{< img src="incident_response/on-call/automations/handover-automation-slack-update-group.png" alt="Configuration form for the Slack Update user group automation" style="width:80%;" >}}
9797

9898
**Note**: This action requires `usergroups:read` and `usergroups:write` permissions on the Datadog Slack app. If these permissions are missing, the UI displays a warning with a link to enable them.
9999

@@ -103,19 +103,19 @@ Updates the members of a Slack user group to match the current on-call responder
103103

104104
Posts a handover summary to a Microsoft Teams channel showing who is handing off to whom for each selected schedule. You can also include an AI-generated shift summary.
105105

106-
{{< img src="service_management/oncall/handover-automation-ms-teams-message.png" alt="Configuration form for the Microsoft Teams Send message automation" style="width:80%;" >}}
106+
{{< img src="incident_response/on-call/automations/handover-automation-ms-teams-message.png" alt="Configuration form for the Microsoft Teams Send message automation" style="width:80%;" >}}
107107

108108
#### Update channel description
109109

110110
Updates a Microsoft Teams channel description when a shift changes. Use numbered variables (`{{1}}`, `{{2}}`, and so on) in a customizable template to reference responders in schedule order. For example, `On-call: {{1}} (backup: {{2}})` resolves to the primary and secondary on-call responders when the shift changes.
111111

112-
{{< img src="service_management/oncall/handover-automation-ms-teams-channel-topic.png" alt="Configuration form for the Microsoft Teams Update channel description automation" style="width:80%;" >}}
112+
{{< img src="incident_response/on-call/automations/handover-automation-ms-teams-channel-topic.png" alt="Configuration form for the Microsoft Teams Update channel description automation" style="width:80%;" >}}
113113

114114
#### Send a direct message
115115

116116
Sends a direct message to the incoming on-call responder when their shift begins.
117117

118-
{{< img src="service_management/oncall/handover-automation-ms-teams-direct-message.png" alt="Configuration form for the Microsoft Teams Send a direct message automation" style="width:80%;" >}}
118+
{{< img src="incident_response/on-call/automations/handover-automation-ms-teams-direct-message.png" alt="Configuration form for the Microsoft Teams Send a direct message automation" style="width:80%;" >}}
119119

120120
## Troubleshooting
121121

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

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ In Datadog On-Call, escalation policies ensure that Pages are promptly addressed
1313
Datadog creates a default escalation policy when you [onboard a Team to On-Call][1].
1414

1515
## Create a new escalation policy
16-
{{< img src="service_management/oncall/escalation_policy_2.png" alt="A sample escalation policy." style="width:100%;" >}}
16+
{{< img src="incident_response/on-call/escalation_policies/escalation_policy_2.png" alt="A sample escalation policy." style="width:100%;" >}}
1717

1818
1. Go to [**On-Call** > **Escalation Policies**][2].
1919
1. Select [**+ New Escalation Policy**][3].
@@ -24,13 +24,13 @@ Datadog creates a default escalation policy when you [onboard a Team to On-Call]
2424
1. Select one of the following notification methods: `Notify All`, `Round Robin`. See [Escalation policy notification types](#escalation-policy-step-notification-types) for details.
2525
1. Specify how many minutes the recipient has to acknowledge the Page before it is escalated to the next tier.
2626
For example, the following will notify the current on-call user when a Page is triggered. It will escalate to Jane Doe if John does not acknowledge the Page within 5 minutes.
27-
{{< img src="service_management/oncall/escalation_policy_2_steps_v2.png" alt="An escalation policy configured to notify the scheduled on-call user and escalate to Jane Doe if the Page is not acknowledged after 5 minutes." style="width:100%;" >}}
27+
{{< img src="incident_response/on-call/escalation_policies/escalation_policy_2_steps_v2.png" alt="An escalation policy configured to notify the scheduled on-call user and escalate to Jane Doe if the Page is not acknowledged after 5 minutes." style="width:100%;" >}}
2828
1. Set how many times to repeat the steps if no one acknowledges the Page.
2929
1. Select whether Datadog should automatically update the Page status to **Resolved** after executing all rules and repeats.
3030

3131
## Escalation policy step notification types
3232
In each step of an escalation policy, you can keep the standard `Notify All` behavior or opt-in for `Round Robin`.
33-
{{< img src="service_management/oncall/escalation_policy_notification_type.png" alt="Notification type selector in Escalation Policy creation" style="width:100%;" >}}
33+
{{< img src="incident_response/on-call/escalation_policies/escalation_policy_notification_type.png" alt="Notification type selector in Escalation Policy creation" style="width:100%;" >}}
3434

3535
### Notify all (default)
3636
Notify all targets of the step at the same time.
@@ -58,7 +58,7 @@ If you want the Page to go to the next target in the round robin, use only one r
5858
In each step of an escalation policy, you can notify individual users, entire teams, or whoever is on-call in a schedule.
5959

6060
### Schedules
61-
{{< img src="service_management/oncall/escalation_policy_notify_schedule.png" alt="A sample escalation policy step that notifies a schedule." style="width:100%;" >}}
61+
{{< img src="incident_response/on-call/escalation_policies/escalation_policy_notify_schedule.png" alt="A sample escalation policy step that notifies a schedule." style="width:100%;" >}}
6262

6363
Escalation policies can notify whoever is on-call according to a predefined schedule. The system checks the schedule and notifies the person or group that is actively on-call during the incident. Using schedules is beneficial for:
6464

@@ -68,10 +68,10 @@ Escalation policies can notify whoever is on-call according to a predefined sche
6868

6969
If no one is on-call for a given schedule, the escalation step gracefully skips and the process moves forward without delays or interruptions. The UI indicates a skipped escalation.
7070

71-
{{< img src="service_management/oncall/escalation_policy_schedule_skipped.png" alt="A sample escalation policy indicating a skipped escalation due to no one being on-call." style="width:100%;" >}}
71+
{{< img src="incident_response/on-call/escalation_policies/escalation_policy_schedule_skipped.png" alt="A sample escalation policy indicating a skipped escalation due to no one being on-call." style="width:100%;" >}}
7272

7373
### Users
74-
{{< img src="service_management/oncall/escalation_policy_notify_user.png" alt="A sample escalation policy that specifies a user in the escalation policy." style="width:100%;" >}}
74+
{{< img src="incident_response/on-call/escalation_policies/escalation_policy_notify_user.png" alt="A sample escalation policy that specifies a user in the escalation policy." style="width:100%;" >}}
7575

7676
You can include specific users in an escalation policy to ensure key individuals are always notified in the event of a Page. Common use cases for directly paging a user are:
7777

@@ -80,7 +80,7 @@ You can include specific users in an escalation policy to ensure key individuals
8080
- Routing alerts to a backup responder if the primary contact is unavailable.
8181

8282
### Teams
83-
{{< img src="service_management/oncall/escalation_policy_notify_team.png" alt="A sample escalation policy that notifies an entire Team." style="width:100%;" >}}
83+
{{< img src="incident_response/on-call/escalation_policies/escalation_policy_notify_team.png" alt="A sample escalation policy that notifies an entire Team." style="width:100%;" >}}
8484

8585
Common use cases for paging an entire Team are:
8686

content/en/incident_response/on-call/guides/migrate-your-opsgenie-resources-to-on-call.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ The migration follows a six-step wizard-style process in Datadog. Complete all s
4949
1. If you have multiple regions configured, select your OpsGenie account's region from the dropdown.
5050
1. Datadog loads all your OpsGenie teams in a searchable, paginated list. Select the team to migrate, then select **Next**. A preview pane shows the team's members and settings.
5151

52-
{{< img src="service_management/oncall/import-opsgenie-team-2.png" alt="OpsGenie team list with a preview pane showing the selected team's members and settings" style="width:95%;" >}}
52+
{{< img src="incident_response/on-call/guides/migrate-your-opsgenie-resources-to-on-call/import-opsgenie-team-2.png" alt="OpsGenie team list with a preview pane showing the selected team's members and settings" style="width:95%;" >}}
5353

5454
**Note**: If a team was previously imported, Datadog indicates this.
5555

@@ -61,7 +61,7 @@ The migration follows a six-step wizard-style process in Datadog. Complete all s
6161
- Map to a different Datadog team that you select.
6262
- Create a new team. Enter a team name to create a Datadog team based on the structure and members of the OpsGenie team.
6363

64-
{{< img src="service_management/oncall/map-opsgenie-team-to-datadog-team-2.png" alt="Mapping options for assigning an OpsGenie team to an existing or new Datadog team" style="width:95%;" >}}
64+
{{< img src="incident_response/on-call/guides/migrate-your-opsgenie-resources-to-on-call/map-opsgenie-team-to-datadog-team-2.png" alt="Mapping options for assigning an OpsGenie team to an existing or new Datadog team" style="width:95%;" >}}
6565

6666
1. When the mapping is correct, select **Next**.
6767

@@ -70,7 +70,7 @@ The migration follows a six-step wizard-style process in Datadog. Complete all s
7070
1. Browse your OpsGenie escalation policies. You can filter policies by team.
7171
1. Select an escalation policy to import. The wizard displays the full policy details, including rules, recipients, and schedules.
7272

73-
{{< img src="service_management/oncall/import-opsgenie-escalation-policy.png" alt="OpsGenie escalation policy list with policy details shown for the selected policy" style="width:95%;" >}}
73+
{{< img src="incident_response/on-call/guides/migrate-your-opsgenie-resources-to-on-call/import-opsgenie-escalation-policy.png" alt="OpsGenie escalation policy list with policy details shown for the selected policy" style="width:95%;" >}}
7474

7575
### Step 4: Map users
7676

content/en/incident_response/on-call/guides/migrate-your-pagerduty-resources-to-on-call.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ By rebuilding your on‑call setup from only current, relevant PagerDuty data, y
3030
1. Visit the [On-Call Teams list][2] and select **Add Team to On‑Call** > **Import team from PagerDuty**. Datadog loads all your teams from PagerDuty.
3131
1. Pick the team to migrate and choose **Next**. A preview pane shows the team's members and settings.
3232

33-
{{< img src="service_management/oncall/pagerduty_migration_import_team.png" alt="UI that lists PagerDuty teams and shows a preview of the selected team" style="width:95%;" >}}
33+
{{< img src="incident_response/on-call/guides/migrate-your-pagerduty-resources-to-on-call/pagerduty_migration_import_team.png" alt="UI that lists PagerDuty teams and shows a preview of the selected team" style="width:95%;" >}}
3434

3535
### Map the team and its members
3636

@@ -40,7 +40,7 @@ By rebuilding your on‑call setup from only current, relevant PagerDuty data, y
4040

4141
- **Create a new team**: Enter a team name when prompted. Datadog builds the team using the structure and members from your PagerDuty team.
4242

43-
{{< img src="service_management/oncall/pagerduty_migration_map_users.png" alt="UI for mapping PagerDuty users to Datadog users or inviting new users" style="width:95%;" >}}
43+
{{< img src="incident_response/on-call/guides/migrate-your-pagerduty-resources-to-on-call/pagerduty_migration_map_users.png" alt="UI for mapping PagerDuty users to Datadog users or inviting new users" style="width:95%;" >}}
4444

4545
1. Handle unmapped users:
4646

@@ -59,13 +59,13 @@ Choose a template to define how alerts reach the team:
5959
- **Alert priority**: route alerts based on their priority and impact.
6060
- **Start from scratch**: customize routing rules to fit your team's workflows.
6161

62-
{{< img src="service_management/oncall/pagerduty_migration_select_routing_rule_template.png" alt="UI with routing‑rule templates such as 'All alerts to escalation policy', 'Business hours', and 'Alert priority'" style="width:95%;" >}}
62+
{{< img src="incident_response/on-call/guides/migrate-your-pagerduty-resources-to-on-call/pagerduty_migration_select_routing_rule_template.png" alt="UI with routing‑rule templates such as 'All alerts to escalation policy', 'Business hours', and 'Alert priority'" style="width:95%;" >}}
6363

6464
### Reuse escalation policies and schedules
6565

6666
When you edit routing rules, you can import existing PagerDuty escalation policies and schedules instead of recreating them.
6767

68-
{{< img src="service_management/oncall/pagerduty_migration_migrate_escalation_policies_and_schedules.png" alt="UI for selecting existing PagerDuty escalation policies and schedules" style="width:95%;" >}}
68+
{{< img src="incident_response/on-call/guides/migrate-your-pagerduty-resources-to-on-call/pagerduty_migration_migrate_escalation_policies_and_schedules.png" alt="UI for selecting existing PagerDuty escalation policies and schedules" style="width:95%;" >}}
6969

7070
Datadog will automatically apply the imported configurations. You can change the policies and schedules at any time.
7171

0 commit comments

Comments
 (0)