Schedule
The schedule tab displays your current on-call status and upcoming on-call schedule. It shows at-a-glance how long you're on-call, which groups and shifts you're currently on-call for, and when you are next on-call.
Your current on-call status is displayed at the top of the schedule window.
Next On-Call
If you're not currently on-call, the status displays when you're next on-call and the start time of the shift.
Currently On-Call
If you are currently on-call, the status displays the length of time that you'll remain on-call and the time at which your on-call status ends.
The Shifts list highlights which shifts you're currently on-call for:
The Filter By selector can be used to display shifts based on your position in the escalation order.
Select to view shifts using one of the following filters:
Primary On-Call |
Displays only shifts where you are in the Primary On-Call position. |
Primary and Secondary On-Call |
Displays shifts where you are in Primary On-Call position and shifts where you are in Secondary On-Call. |
All Shifts |
Displays all of your scheduled shifts, regardless of where you are in the escalation order, and includes any shifts where the your device is a member. |
The shift filter can be used to screen out shifts where a user may not have true on-call responsibilities, such as when only their device is a member of the group, or if they are part of a 24x7 broadcast group or a rotational group with large escalations.
Primary On-Call and Primary and Secondary On-Call status is based on time delays in the escalation order for a group, not the user's position in the list of users in the group. Multiple users may have primary or secondary escalation positions in a group.
The daily schedule lists the shifts you are assigned to, including when each shift begins and ends, whether the shift spans multiple days, and highlights the shifts and days you're currently on-call for:
The Scheduled Absences button displays how many temporary absences you have scheduled. Click the button to view the details or click Add Absence to add a new absence.
For more information about managing your temporary absences, see Set a temporary absence.
On-call reminders
Using on-call reminders, you can have xMatters send a notification to your push or email devices to remind you when you have an upcoming on-call shift. You can set up to six reminders to act as a virtual snooze button for anywhere from one minute to two weeks before your shifts. Reminder notifications ignore device timeframes, don't require a response, and won't count towards performance report data.
- On the Schedule tab of your user profile, click Calendar Settings > On-Call Reminders.
- In the On-Call Reminders dialog box, click the Enable On-Call Reminders toggle.
- Select the shifts you want to receive reminders for:
- Primary On-Call: Receive reminders only for shifts where you are in the primary on-call position.
- Primary and Secondary On-Call: Receive reminders only for shifts where you are in the primary or secondary on-call position.
- All Shifts: Receive reminders for all of your on-call shifts. (You will not receive reminders for any broadcast groups you belong to.)
- To select the device or devices that you want to receive reminders on, click in the field to display a list of available devices and select the check box beside the ones you want to include.
- The default reminder is for 15 minutes before your shift, but you can modify it to any time you choose. To add another reminder, click Add On-Call Reminder and set the number and units fields to configure the reminder.
- Click Save to accept the settings and close the dialog box.
You must have at least one device and one reminder configured to save your changes. To remove or cancel all reminders, turn reminders off by toggling the Enable On-Call Reminders option at the top of the dialog box.
As we continue to improve and refine this feature, be aware that on-call reminders may not experience the same level of reliability as our standard notification services.
A few limitations to keep in mind:
- 24x7 shifts: On-call reminders do not apply to 24x7 shifts without escalation delays. These are typically used as broadcast groups with everyone on-call so they can be reached at once, and we don't think it would make sense to remind you about these every day.
- Exception: On-call reminders are sent for 24x7 shifts that contain an escalation delay after at least one user (meaning there are primary and secondary on-call users) and there's a shift rotation.
- Minimum shift recurrence: Shifts must reoccur at least once every 90 days for on-call reminders to apply.
- Shift rotations: On-call reminders are not sent for shifts with event-based rotations, although they do apply to shifts with schedule and shift-based rotations.
- Dynamic teams: Members of dynamic teams do not receive on-call reminders.
- Updates to shifts: If you make changes to your groups or shifts, it may take up to 15 minutes for the system to update your on-call reminders.
Share on-call calendar
If you need to share your on-call schedule outside of xMatters (for example, if you want an external scheduling system to have access to it) you can download an ICS file or create a URL link to share your user calendar.
- On the Schedule tab of your user profile, click Calendar Settings > Share Calendar.
- From the drop-down menu, select which shifts you want to include in the shared calendar.
- Do one of the following:
- Click Download to download an ICS file of the calendar to your local machine.
- Toggle on Share Live Calendar Link to create a URL link to the calendar. (When sharing is enabled, anyone with the link can view the calendar and any changes made to it. Once disabled, the link is no longer valid.)
- Click Close.