Onboard a Team

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.

    • 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.

    • 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:

    Datadog On-CallDOCUMENTATION more more