This is archived documentation for v0.0.39. Go to the latest version.
Create an on-call schedule calendar
Create a primary calendar and an optional override calendar to schedule on-call shifts for team members.
In the Scheduling section of Grafana OnCall, click + Create schedule.
Give the schedule a name.
Create a new calendar in your calendar service and locate the secret iCal URL. For example, in a Google calendar, this URL can be found in Settings > Settings for my calendars > Integrate calendar.
Copy the secret iCal URL. In OnCall, paste it into the Primary schedule for iCal URL field. The permissions you set when you create the calendar determine who can modify the calendar.
Click Create Schedule.
Schedule on-call times for team members.
Use the Grafana username of team members as the event name to schedule their on-call times. You can take advantage of all of the features of your calendar service.
Create overlapping schedules (optional).
When you create schedules that overlap, you can prioritize a schedule by adding a level marker. For example, if users AliceGrafana and BobGrafana have overlapping schedules, but BobGrafana is the primary contact, you would name his event
[L1] BobGrafana, AliceGrafana maintains the default
[L0]status, and would not receive notifications during the overlapping time. You can prioritize up to and including a level 9 prioritization, or
Create an override calendar (optional)
You can use an override calendar to allow team members to schedule on-call duties that will override the primary schedule. An override option allows flexibility without modifying the primary schedule. Events scheduled on the override calendar will always override overlapping events on the primary calendar.
Create a new calendar using the same calendar service you used to create the primary calendar.
Be sure to set permissions that allow team members to edit the calendar.
In the scheduling section of Grafana OnCall, select the primary calendar you want to override.
Enter the secret iCal URL in the Overrides schedule iCal URL field and click Update.
Related Oncall resources
Getting started with Grafana OnCall for on-call management
This webinar goes over initial Grafana OnCall configuration, setting up an on-call management process, grouping, alert rendering, and organizing runbooks.
Unified alerting and on-call management in Grafana
In this webinar, we’ll demo the Grafana 8 unified alerting system, and introduce Grafana OnCall, our on-call management tool to resolve incidents faster.
Reducing resolution time (MTTR) with the Grafana Stack: Metrics, logs, tracing, & on-call management
See a live demo of Grafana OnCall, and how to correlate your metrics, logs, and traces to reduce you /MTTR using Grafana’s “single pane of glass” approach.