Slack Commands

Running incidents and executing Runbooks can be done directly in Slack, where your team is already accustomed to working. This article details the complete list of FireHydrant bot's Slack commands.

Multiple command aliases can be used to execute FireHydrant Slack bot commands:

  • /fh
  • /firehydrant
  • /incident

For this article, we will utilize /fh.

Specific commands can be run anywhere, while others can only be run in an active incident channel. We will denote these contexts as general vs. incident commands.

General Commands

These commands can be run anywhere within Slack and at any time, including within incident channels.

Help

/fh
/fh help   # aliases to /fh

In the help menu, you can preview commands, understand what a command does, and then use a quick action button to run it.

New Incident

/fh new [incident name]

Running this command will open up the declare incident modal where you can quickly fill out any required fields and get your incident management process kicked off.

Example Slack declaration modal. These fields [can be customized](doc:incident-fields)

Example Slack declaration modal. These fields can be customized

New Resolved Incident

/fh create-resolved

Creates an incident that does not fire off any automation or Runbooks and starts in a Resolved state.

The intended use case is for logging retroactive incidents that occurred in the past. For more information, visit Retroactive Incidents.

Link Slack and FireHydrant accounts

/fh link

Initiates an authorization process to link your Slack account to your FireHydrant account.

If the user's Slack email address matches the email in FireHydrant, we will automatically link the accounts when the user is created in FireHydrant. Otherwise, we will prompt for permissions when the user attempts to execute Slackbot commands.

πŸ“˜

Note:

Slack accounts must be linked with FireHydrant accounts for FireHydrant to pull users into incident channels automatically as well as notify them of updates via DMs.

View On-Call Schedules

/fh on-call [service | functionality]
/fh oncall [service | functionality]    # aliases to /fh on-call

Running this command lets you pull up any on-call schedules for components in your service catalog.

πŸ“˜

Note:

This will only work if the Service or Functionality is linked to or imported from a service in your alerting provider. Read more about importing and linking components.

Page Services and Functionalities

/fh page service [service name]

Pages the on-call user/team for a Service*.

/fh page functionality [functionality name]

Pages the on-call user/team for a Functionality*.

πŸ“˜

*Note:

These commands will only work if the Service or Functionality is linked to or imported from a service in your alerting provider. Read more about importing and linking components.

View Service Information

/fh service [service name]

Pulls up information for the Service as defined in the Service Catalog. Information can include owning and responding teams, external links, the latest known changes, service dependencies, and more.

Switch organizations

/fh switch org

For companies with multiple Organizations connected to a single Slack workspace, users in more than one organization can run this command to choose which org they want their commands to run against.

Manage the Incident

These are incident commands that can only be run inside an incident channel for an ongoing incident.

Incident Commands

Edit Incident

/fh edit      # edit the incident
/fh tags      # aliases to /fh edit

Running this command will open up a modal for the current incident, allowing you to edit any data about the incident, including the description, severity, tags, or other fields.

Incident Update

/fh update      # post an update
/fh add note    # aliases to /fh update
/fh post        # aliases to /fh update

Running this command allows you to update your stakeholders about the status of your incident, including updating your milestones and publishing update notes to internal or public status pages.

Incident Status

/fh status

Running this command gives you a quick overview of the incident, including the latest update, the responding team, any incident data, relevant links, and quick actions.

Related Incidents

/fh related

Add and mark related incidents. To read more about this, visit Related Incidents.

Restrict Incident

/fh restrict     # converts incident to private
/fh private      # aliases to /fh restrict

Running this command will open up a modal that walks you through converting the current incident into a private incident. A private channel will be created for this new incident unless the current channel is already private.

Resolve Incident

/fh resolve      # redirects to /fh update

Resolving an incident sets its status to resolved, and allows you to post a resolution note to active status pages. A resolved incident continues to collect chat messages even after resolution. To re-open an incident, you must go to the command center.

In Slack, this command redirects to the /fh update modal, but presets the Milestone to Resolved.

Start Retrospective

/fh start retro

Running this command opens up a modal that helps you get started on your retro by ensuring that you have the description and customer impact fields completed.

πŸ“˜

Note:

This command will only work if the incident has already been resolved.

Add External Link

/fh add link

Running this command will open a modal where you can add an external link to the incident.

Connected Workflows

View Runbooks

/fh runbooks

Running this command gives you a quick view of which Runbooks have run for the incident, allowing you to see what steps have run already.

Add Runbook to Incident

/fh add runbook

Running this command opens up a modal to attach another Runbook to the current incident.

πŸ“˜

Note:

If a Runbook has already been added, it will not appear in the search results.

View Tasks

/fh tasks all

Running this command shows any tasks added to the incident and allows you to create and edit tasks.

View Follow-Ups

/fh follow-ups

Running this command shows any follow-ups added to the incident and allows you to edit tickets.

Add Status Page to Incident

/fh add status-page

Running this command allows you to publish this incident to any status pages configured for your organization.

Add Service to Incident

/fh add service/f

Running this command allows you to add any affected components from your Service Catalog to your incident with the ability to set the status per component.

Add Environment to Incident

/fh add environment

Running this command allows you to add any affected components from your Service Catalog to your incident with the ability to set the status per component.

Add Functionality to Incident

/fh add functionality

Running this command allows you to add any affected components from your Service Catalog to your incident with the ability to set the status per component.

Add Task to Incident

/fh add task

Running this command allows quickly adding a new task for the current incident.

Add Task List to Incident

/fh add task-list

Running this command lets you quickly add a task list to the current incident.

Add Follow-up to Incident

/fh add follow-up
/fh add followup   # alias
/fh follow-up      # alias
/fh followup       # alias

Running this command allows quickly adding a new follow-up ticket for the current incident.

People

Assign Team to Incident

/fh assign team

Running this command allows you to quickly assign a team to the incident. FireHydrant will use any associated on-call schedules and default roles to ensure that the right team members get assigned roles for the incident.

Assign Role to Incident

/fh assign role

Assign roles to users.

Running this command allows you to assign any FireHydrant user a role in the incident. If the user has linked their Slack account to their FireHydrant account, they will automatically be pulled into the Slack channel. FireHydrant will also send the user a direct message informing them.

Update Role Assignments for Incident

/fh update roles

Running this command allows you to update assigned or unassigned roles for FireHydrant users in the incident.

Page

/fh page

Create a page or add responders to your alerting provider's existing page. Send a page to individuals, teams, or escalation policies in your alerting tool.

Custom Commands

In FireHydrant, you can create custom commands that return templated replies or make HTTP requests to external systems. If you have any custom commands, they will also show up on the list of commands when you run /fh help.

To learn more, see Command Extensions.