Configuring PagerSync
Last updated
Last updated
This page shows the terminology and the setup for PagerSync.
The main things we will deal with in PagerSync are:
Slack User Groups: In Slack there is a feature that allows creating a user group with a name that contains 1 or more slack users. Messages can be sent tagging this user group and it will alert whoever is currently a member of the user group. More details on the Slack website.
PagerDuty Schedule: PagerDuty schedules are used to map out which users are on call at any given time and determine who will be notified when an incident is triggered. More details on PagerDuty website.
PagerDuty On Call Config/Team Rotation: The core feature of PagerSync is to map a slack user group to one or more PagerDuty schedules. The people from the schedule get added to the User Group as and when they go on call. This ensures that when you ping a user group to report an issue it
A team rotation maps one or more Slack User Group to one or more PagerDuty schedules.
This is done using the button Create Rotation in the Team Rotation section.
Clicking on the button opens up this modal.
Here's what each field in there means and how it behaves:
Config Name: This is a name for the config. Good options for this are things like the team name. This will help you find and manage this config later. There are no restrictions on the name.
User Group: This is a drop down with the list of user groups already present in your slack instance. Choose the appropriate user group you want to use.
Search: If you have a long list of user groups, you can search for it in the dropdown. Make sure to ensure the search string starts with @ when searching.
The last option in there is to create a new one. If you want to create a new user group choose this option and set the name for the new group in the next text area.
You can only choose 1 user group for a given config and 1 user group can only be associated with a config (1:1 mapping)
New Alias to Create: If none of the existing user groups works for you, you can create a new user group using this text box. Restrictions:
The name needs to follow the rules of Slack user group. All lower case characters, numbers, _ and -. No special characters or space.
PagerDuty Schedules: You can choose 1 or more schedules to backup up the user group. If multiple schedules are chosen then PagerSync will add the current on call persons from all the schedules to the user group. Each schedule can change individually and PagerSync seamlessly updates the user group.
Channels: If you want an announcement in the group with who is going on call for a given user group, choose the channels you want the announcement in. The announcement message will look like this:
Once you have created at least a rotation, you should be able to see the list existing.
Note: The current on call list might be empty when you initially create the configuration. It will get populated soon and refreshing the app page or navigating to another channel and coming back will show the updated value.
To edit a configuration, simply click on the edit button below the one you want to edit. This will open the same modal used to create the configuration with the values prefilled. For instance:
Click on Submit to save any changes and Cancel to discard changes.
To delete a config use the delete button right below a given configuration. It will pop open a confirmation modal box.
Click on Delete to delete the config and Cancel to cancel the operation.
