On-Call

This product is not supported for your selected Datadog site. ().
Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.

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

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.

Concepts

  • Pages represent something to get alerted for, such as a monitor, incident, or security signal. A Page can have a status of Triggered, Acknowledged, or Resolved.
  • Teams are groups configured within Datadog to handle specific types of Pages, based on expertise and operational roles.
  • Routing rules allow Teams to finely adjust their reactions to specific types of incoming events. These rules can set a Page’s urgency level and route Pages to different escalation policies depending on the event’s metadata.
  • Escalation policies determine how Pages are escalated within or across Teams.
  • Schedules set timetables for when specific Team members are on-call to respond to Pages.

How it works

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.

Notification that mentions an On-Call Team.

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.

A sample escalation policy.

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.

A sample schedule, with multiple layers for JP, EU, and US business hours.

Granular access control

Use granular access controls to limit the roles, teams, or users that can access On-Call resources. By default, access to On-Call schedules, escalation policies, and team routing rules is unrestricted.

Granular access controls are available for the following On-Call resources:

  • Schedules: Control who can view, edit, and override schedules
  • Escalation policies: Control who can view and edit escalation policies
  • Team routing rules: Control who can view and edit team routing rules

Supported resources and permissions

On-Call resourceViewerOverriderEditor
SchedulesCan view schedulesCan view schedules and override shiftsCan view, edit schedules, and override shifts
Escalation policiesCan view escalation policies-Can view and edit escalation policies
Team routing rulesCan view team rules-Can view and edit team rules

Restrict access to On-Call resources

To restrict access to an On-Call resource:

  1. Navigate to the specific On-Call resource (schedule, escalation policy, or team routing rules).
  2. Click Manage.
  3. Select Permissions from the dropdown menu.
  4. Click Restrict Access.
  5. Select one or more roles, teams, or users from the dropdown menu.
  6. Click Add.
  7. Select the level of access you want to associate with each of them from the dropdown menu next to their name:
    • Viewer: Read-only access to view the resource
    • Overrider (schedules only): Can view and create schedule overrides
    • Editor: Full access to view and modify the resource
  8. Click Save.

Note: To maintain your edit access to the resource, Datadog requires you to include at least one role that you are a member of before saving.

Start using Datadog On-Call

To preserve incident history, Datadog On-Call does not support deletion of resources like Pages, escalation policies, or schedules. To test On-Call without affecting your production environment, create a trial organization as a sandbox.

To get started with On-Call, onboard an On-Call Team and ensure that all Team members configure their On-Call profile settings to receive notifications.


Further Reading