Onboard a Team

This page is not yet available in Spanish. We are working on its translation.
If you have any questions or feedback about our current translation project, feel free to reach out to us!

On-Call is not supported for your selected Datadog site ().

Teams are the central organizational unit of Datadog On-Call. Pages are sent to a Team, and the Team’s schedules or escalation policies route the Page to an appropriate Team member.

On-Call Teams are an extension of Datadog Teams. On-Call Teams are listed on the Teams overview page, alongside Teams that do not perform on-call duties. Datadog recommends that you use existing Teams for your On-Call configuration whenever possible, as this increases your On-Call Team’s discoverability.

Onboard a new or existing Team

  1. Go to On-Call > Teams and select Set Up Team.

  2. Create a new Team, select an existing Datadog Team, or import team configurations from PagerDuty or Opsgenie.

    • Team Name: Enter a name for your Team. Datadog recommends that you do not use acronyms here, unless the acronym is already widely used in your organization.
    • Handle: The handle used to page the Team throughout the Datadog platform. You can change your Team’s handle at any time.
    • Members: Add your Team’s members, including those who do not perform on-call duties.
    • Description: Provide a description of your Team’s responsibilities. For example: Our team is responsible for [primary responsibility]. We ensure [key objectives or activities], operating [operational hours or conditions].

    Select an existing Datadog Team from the drop-down menu.

  3. Add a default escalation policy.

    Setup view of a new escalation policy. Notifies three proposed schedules.

    • Datadog automatically proposes Interrupt Handler, Primary, and Secondary schedules for your Team. You can define these schedules in the next step.
    • You can also notify an existing schedule owned by another Team.

    See Escalation Policies for more details.

  4. Define the schedules created in the previous step.

    Setup view of a new schedule.

    • Schedule Time Zone: Select the time zone you want to operate your schedule in. Other settings, such as handoff times, adhere to this selection.
    • Schedule Rotations: Add your desired rotations. See Schedules for more details.

Next steps

Configure your monitors, incidents, or other resources to send Pages to your On-Call Team. See Send a Page.

Ensure that your On-Call Team members have set up their Profile Settings.

Further Reading

Additional helpful documentation, links, and articles: