|
| 1 | +--- |
| 2 | +title: Migrate PagerDuty resources to Datadog On-Call |
| 3 | +further_reading: |
| 4 | +- link: "/service_management/on-call/" |
| 5 | + tag: "Documentation" |
| 6 | + text: "On-Call Documentation" |
| 7 | +- link: "/integrations/pagerduty/" |
| 8 | + tag: "Documentation" |
| 9 | + text: "PagerDuty Integration" |
| 10 | +--- |
| 11 | + |
| 12 | +## Overview |
| 13 | + |
| 14 | +Follow this migration workflow to rebuild your PagerDuty on-call structure in Datadog, team by team. It reuses your existing PagerDuty schedules and escalation policies as building blocks so you can review, tweak, or discard each resource before it goes live. |
| 15 | + |
| 16 | +By rebuilding your on‑call setup from only current, relevant PagerDuty data, you avoid bringing legacy clutter into Datadog and start with a concise, maintainable configuration. |
| 17 | + |
| 18 | +## Prerequisites |
| 19 | + |
| 20 | +1. Configure the [PagerDuty integration][1] in Datadog. |
| 21 | +1. Create a PagerDuty API key, if you don't have one already, that can read PagerDuty assets like schedules, escalation policies, and teams. |
| 22 | +1. Confirm your user has `on_call_write` and `teams_manage` permissions. |
| 23 | + |
| 24 | +## Migration steps |
| 25 | + |
| 26 | +### Select team to migrate |
| 27 | + |
| 28 | +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. |
| 29 | +1. Pick the team to migrate and choose **Next**. A preview pane shows the team's members and settings. |
| 30 | + |
| 31 | +{{< 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%;" >}} |
| 32 | + |
| 33 | +### Map the team and its members |
| 34 | + |
| 35 | +1. Select one of the following options: |
| 36 | + |
| 37 | + - **Map with another Datadog team**: Choose the appropriate Datadog team from the list. |
| 38 | + |
| 39 | + - **Create a new team**: Enter a team name when prompted. Datadog builds the team using the structure and members from your PagerDuty team. |
| 40 | + |
| 41 | + {{< 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%;" >}} |
| 42 | + |
| 43 | +1. Handle unmapped users: |
| 44 | + |
| 45 | + Datadog matches users by email address. For unmapped users you can: |
| 46 | + - Invite them to Datadog (the UI sends an email invitation), or |
| 47 | + - Skip them if they no longer need access. |
| 48 | + |
| 49 | +1. When the mapping looks correct, select **Import team**. |
| 50 | + |
| 51 | +### Configure routing rules |
| 52 | + |
| 53 | +Choose a template to define how alerts reach the team: |
| 54 | + |
| 55 | +- **All alerts to escalation policy**: forward every alert to a designated escalation policy. |
| 56 | +- **Business hours**: send alerts to the team only during specified hours and use chat channels as fallbacks. |
| 57 | +- **Alert priority**: route alerts based on their priority and impact. |
| 58 | +- **Start from scratch**: customize routing rules to fit your team's workflows. |
| 59 | + |
| 60 | +{{< 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%;" >}} |
| 61 | + |
| 62 | +### Reuse escalation policies and schedules |
| 63 | + |
| 64 | +When you edit routing rules, you can import existing PagerDuty escalation policies and schedules instead of recreating them. |
| 65 | + |
| 66 | +{{< 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%;" >}} |
| 67 | + |
| 68 | +Datadog will automatically apply the imported configurations. You can change the policies and schedules at any time. |
| 69 | + |
| 70 | +## Further reading |
| 71 | + |
| 72 | +{{< partial name="whats-next/whats-next.html" >}} |
| 73 | + |
| 74 | + |
| 75 | +[1]: https://app.datadoghq.com/integrations/pagerduty |
| 76 | +[2]: https://app.datadoghq.com/on-call/teams |
0 commit comments