# Slackgenie

Slackgenie is a background job that continually updates a certain Slack User Group
via an Opsgenie schedule. User Groups usually end in **-support** i.e _delivery-support_.
The goal of Slackgenie is to allow members of a team to focus on heads-down work
while the "On-call" member triages interrupts.

All alerts are delivered as Slack notifications. They do not come through when users
in the group are in Do Not Disturb. Multiple people can be in the rotation at once.

## How to add a new rotation

- Create a Slack User Group and add the team members you want in the rotation.
- Update the [slackgenie config](https://sourcegraph.com/github.com/sourcegraph/background-jobs/-/blob/slackgenie/config.yaml) to include the new User Group.
- Under the Teams tab in Opsgenie, select Add Team.
- On the page for your new team, use the On-call tab to update the rotation with participants from your Slack User Group.
- Use the Integration tab to connect the rotation to Slack.
- **Ensure rotation is working** Check the buildkite job [here](https://buildkite.com/sourcegraph/background-jobs-slackgenie) to ensure the rotation is working

### Helpful tips

- You can override an Opsgenie schedule manually via "Take on-call for an hour" in the Opsgenie UI
  or messaging the Opsgenie slackbot.


<section class="h0Wrapper headingWrapper"><section class="h1Wrapper headingWrapper"><h1 id="slackgenie"><a class="anchor" aria-hidden tabindex="-1" href="#slackgenie"><span class="icon icon-link"></span></a>Slackgenie</h1>
<p>Slackgenie is a background job that continually updates a certain Slack User Group
via an Opsgenie schedule. User Groups usually end in <strong>-support</strong> i.e <em>delivery-support</em>.
The goal of Slackgenie is to allow members of a team to focus on heads-down work
while the “On-call” member triages interrupts.</p>
<p>All alerts are delivered as Slack notifications. They do not come through when users
in the group are in Do Not Disturb. Multiple people can be in the rotation at once.</p>
<section class="h2Wrapper headingWrapper"><h2 id="how-to-add-a-new-rotation"><a class="anchor" aria-hidden tabindex="-1" href="#how-to-add-a-new-rotation"><span class="icon icon-link"></span></a>How to add a new rotation</h2>
<ul>
<li>Create a Slack User Group and add the team members you want in the rotation.</li>
<li>Update the <a href="https://sourcegraph.com/github.com/sourcegraph/background-jobs/-/blob/slackgenie/config.yaml">slackgenie config</a> to include the new User Group.</li>
<li>Under the Teams tab in Opsgenie, select Add Team.</li>
<li>On the page for your new team, use the On-call tab to update the rotation with participants from your Slack User Group.</li>
<li>Use the Integration tab to connect the rotation to Slack.</li>
<li><strong>Ensure rotation is working</strong> Check the buildkite job <a href="https://buildkite.com/sourcegraph/background-jobs-slackgenie">here</a> to ensure the rotation is working</li>
</ul>
<section class="h3Wrapper headingWrapper"><h3 id="helpful-tips"><a class="anchor" aria-hidden tabindex="-1" href="#helpful-tips"><span class="icon icon-link"></span></a>Helpful tips</h3>
<ul>
<li>You can override an Opsgenie schedule manually via “Take on-call for an hour” in the Opsgenie UI
or messaging the Opsgenie slackbot.</li>
</ul></section></section></section></section>