There are certain scenarios where you may want to page someone directly from Slack. You may want to bring them into an existing incident so they can help triage, as an example.
With the FireHydrant Slack integration, you can page teams based on the services they own. Services that are linked to an alerting provider such as PagerDuty will have a new incident created when the page command is ran, alerting whoever is on call.
Get started with PagerDuty
To use this integration, you'll need to make sure your services are linked to PagerDuty services appropriately. To check, you can visit the service page in FireHydrant.
If you have a linked service, great! If not, you can link services to PagerDuty by following this guide.
Default User Email
You'll need to make sure you assign a default user email in your PagerDuty connection in order for FireHydrant to send requests on your behalf. This is a simple text field that must include an email for any user in your PagerDuty account. To configure it, click "Configure Integration" on the connection on the integrations page.
Teams and Services
FireHydrant allows you to map services to the team(s) that own them. In order for the paging functionality to work, you'll need to map services that have been imported / linked to the appropriate team in FireHydrant.
Visit the teams page in FireHydrant to create or modify a team, where you can then add the services you'd like to create alerts on when running the
/firehydrant page team command.
When editing or creating a team, you'll see a section to list the services that the team owns. Make sure to include the services you'd like to receive pages on PagerDuty in this list.
At the top if the team details page, you'll see the identifier that you can use when paging a team from Slack.
This identifier can then be used in Slack to page a team:
/firehydrant page team dalmatian-catchers
Note: You can change the identifier (called a slug) on the team edit page.
Once you've mapped services to a team, you can start paging the team from the Slack integration.
Paging the team
To page a team, you can type in
/firehydrant page team [team]. If you'd like include a custom incident title, you can include it as additional arguments like so:
/firehdrant page team dalcats Hey I really need some help here
If you can't remember the team identifier (who can remember all of them?), you can also run
/firehydrant page team to receive a dropdown of options for the team in Slack:
Caveat: You cannot include an incident title when using the dropdown functionality for a new alert.
Example of PagerDuty alert
Here's a screenshot of what a PagerDuty incident would look like when running this command from Slack.