Running incidents and executing Runbooks can be done directly in Slack where your team is already accustomed to working. This article includes a list of FireHydrant's Slack commands.
There are a number of aliases that can be used to execute slack bot commands. The different aliases are:
- /firehydrant
- /fh
- /incident
For the purpose of this article, we will utilize /firehydrant.
Help
/firehydrant helpProvides help text and a list of available commands.
New Incident
/firehydrant new [incident name]Opens a dialog box asking for additional information to kick off a new incident. Here you can select the impacted environments and severity if known. Clicking Open from this dialog box creates a new Slack channel where all of your messaging is captured and sent to FireHydrant.
On-call
/firehydrant on-callAllows you to see who's on-call for a particular service.
Link
/firehydrant linkSends a prompt for you to link your Slack account with your FireHydrant account.
Edit Incident
/firehydrant editAllows you to edit the details of the incident. These details include the name, customer impact, description, infrastructure impacted, severity, and more.
Update Incident
/firehydrant updateAllows you to change the incident milestone and component status. From this section, you can also include a comment about why you are changing the status. If you have active status pages, you can post your update to the status pages as well.
Add Note
/firehydrant add note [note text]Adds a note to the incident.
One way to think of notes are as pieces of information that are more important than normal chat messages. You can search a FireHydrant incident timeline and filter specifically by the content in a note (or notes) as opposed to typical chat messages. Adding a note gives you the option to publish the note to your status pages, but you aren't able to modify component statuses or milestones like you can with the update command.
Add Impact
/firehydrant add impactThis opens a text box where you can specify the available services, environments, and functionalities that are affected by a specific incident.
Task Management
/firehydrant add taskAssign a task to an incident/fh tasks
View and manage tasks assigned to you
/fh tasks [@username]
View and manage tasks assigned to somebody else
/fh tasks unassigned
View and manage unassigned tasks
/fh tasks all
View and manage all tasks assigned to the incident
Add Action Item
/firehydrant add action-itemAllows you to Adds an action-item to the incident.
Note:
- ⚠ Starting March 2022, we will be separating out how we manage tasks and follow ups. Going forward, instead of treating tasks and follow ups as one action item command, we will be separating these into separate commands and experiences. Learn more about how Tasks in Slack work.
- If you are using our Jira or Clubhouse integrations, a subsequent ticket on the respective service will also be created and linked to the original incident ticket.
List Action Items
/firehydrant action-itemsLists out all the action items of the incident.
⚠ Starting March 2022, we will be separating out how we manage tasks and follow ups. Going forward, instead of treating tasks and follow ups as one action item command, we will be separating these into separate commands and experiences. Learn more about how Tasks in Slack work.
Add Runbook
/firehydrant add runbookAllows you to add a Runbook to the incident.
Note: If a Runbook has already been added, it will not appear in the search bar.
Runbooks
/firehydrant runbooksLists out all the Runbooks that are currently attached to the incident. This will also allow you to open a Runbook and execute steps right from Slack.
Page a Service
/firehydrant page service [service]Pages a service from PagerDuty or Opsgenie. These services must also be either linked with or imported from either PagerDuty or Opsgenie.
Assign Role
/firehydrant assign roleAssigning a role to someone with a linked Slack account sends that a direct message to that user, via Slack, informing them that they have been assigned a role to an active incident.
Assign a Team
/firehydrant assign teamAssigning a team sends a direct message to each team member via Slack and adds them into the channel. Each team member's Slack account must be linked to their FireHydrant account.
Incident Status Report
/firehydrant statusDisplays a summary of the incident.
Incident Tags
/firehydrant tagsAllows you to update, add, or remove tags from an incident.
Resolve an Incident
/firehydrant resolveThis closes an incident and sets its status to resolved. A resolved incident continues to collect chat messages even after resolution; however, no commands pertaining to the incident can be executed. To re-open an incident, you must go to the command center.
