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.
Was this page helpful?
Related resources from Grafana Labs
![Getting started with the Grafana LGTM Stack](/static/assets/featured/getting-started-with-grafana-lgtm-stack-amer_featured.png?w=200 200w, /static/assets/featured/getting-started-with-grafana-lgtm-stack-amer_featured.png?w=400 400w)
![Intro to Kubernetes monitoring in Grafana Cloud](/media/webinar/Screenshot-2024-02-12-at-4.09.30-PM.png?w=200 200w, /media/webinar/Screenshot-2024-02-12-at-4.09.30-PM.png?w=400 400w)
![Building advanced Grafana dashboards](/media/webinar/AMER_buildadv_notxt.png?w=200 200w, /media/webinar/AMER_buildadv_notxt.png?w=400 400w)