Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Open source

Web-based on-call schedules

Grafana OnCall allows you to map out recurring on-call coverage and automate the escalation of alert notifications to on-call users. Configure and manage on-call schedules directly in the Grafana OnCall plugin to easily customize rotations with a live schedule preview, reference teammates’ time zones, and add overrides.

This topic provides an overview of key components and features.

Schedule settings

Schedule settings are initially configured when a new schedule is created and can be updated at any time by clicking the gear icon next to an existing schedule.

Available schedule settings:

  • Slack channel: Choose a primary Slack channel to send notifications about on-call shifts, such as unassigned on-call shifts.
  • Slack user group: Choose a Slack user group to receive current on-call updates.
  • Notification frequency: Specify whether or not to send shift notifications to scheduled team members.
  • Action for slot when no one is on-call: Define how your team is notified when an empty shift causes a gap in on-call coverage.
  • Current shift notification settings: Select how users are notified when their on-call shift begins.
  • Next shift notification settings: Specify how users are notified of upcoming shifts.

Schedule view

The schedule view is a detailed calendar representation of your on-call schedule. It contains three interactive weekly calendars and a 24-hour on-call status bar for visualizing who’s on-call and what time it is for your teammates.

Understand your schedule view:

  • Final schedule: The final schedule provides a combined view of rotations and overrides
  • Rotations: The rotations calendar represents all recurring on-call rotations for a given schedule.
  • Overrides: The override calendar represents temporary adjustments to the recurring on-call schedule. Any events on this calendar will take precedence over the rotations calendar.

Schedule quality report

The schedule view features a quality report that provides a score for your schedule based on rotations, overrides and shift swaps. It’s calculated based on these key factors:

  • Gaps (amount of time when no one is on-call)
  • Balance (uneven distribution of on-call shifts between team members)

Quality score is a numeric value between 0 and 100. The higher the score, the better the schedule quality. Web UI uses the following scale to show the quality score:

  • 0-20: Bad
  • 20-40: Low
  • 40-60: Medium
  • 60-80: Good
  • 80-100: Great

To improve quality score:

  • Minimize the amount of time when no one is on-call.
  • Ensure users in the schedule have a similar amount of on-call time.

Depending on the quality score, the report can also provide:

  • Percentage of time when no one is on-call. E.g. “29% not covered” means that 29% of the time no one is on-call for the schedule. 24/7/365 coverage is considered ideal, so reducing this number will improve the overall schedule quality.
  • List of overloaded users. A user is considered overloaded if they have more on-call time than average for the schedule. E.g. “+15% avg” in quality report means that user has 15% more on-call time than average for the schedule. A perfectly balanced schedule is considered ideal, so reducing this number will improve the overall schedule quality.

Note: The next 52 weeks (~1 year) are taken into account when generating the quality report.

Schedule export

Export on-call schedules from Grafana OnCall to your preferred calendar app with a one-time secret iCal URL. The schedule export allows you to view on-call shifts alongside the rest of your schedule.