FireHydrant logo

FireHydrant Plugin

View FireHydrant service incidents for your components directly in Backstage.

Created by FireHydrant

Available on Roadie

Set up Backstage in minutes with Roadie

FireHydrant in Backstage

Installation steps

Install the front-end plugin.

cd packages/app
yarn add @backstage/plugin-firehydrant

Add the FireHydrant card to the entity page.

// packages/app/src/components/catalog/EntityPage.tsx
import { FirehydrantCard } from '@backstage/plugin-firehydrant';
const overviewContent = (
  <Grid container spacing={3} alignItems="stretch">
    <Grid item md={6}>
      <FirehydrantCard />
    <Grid item md={6}>

Add proxy configuration to the app-config.yaml.

# app-config.yaml
  target: ''
  changeOrigin: true
    Authorization: Bearer fhb-d31e7e53c9c1bceba710eb17b4547549

Found a mistake? Update these instructions.

Things to know is an incident management tool with a variety of reliability management features including its own service catalog. Backstage components can be added to the FireHydrant service catalog.

Create service on

Typically, Backstage components are linked to external services like by adding annotations to the component’s catalog-info.yaml. The FireHydrant plugin does not require an annotation. Instead, the Backstage component is added to the service catalog following a very specific naming convention: component-type:namespace/component-name.

For example, a component of type Component, in the default namespace, named backstage-sample-service would need to be added to the service catalog as Component:default/backstage-sample-service. Here is what that component would loook like in the Backstage catalog:

Sample component in Backstage

And here is what the Matching component would look like in the service catalog:

Matching component in

Obtaining a FireHydrant Authorization Token

Backstage needs an authorization token to authenticate to the API. This token is obtained by created a new bot configuration on

Create bot on, step 1

Add the authorization token directly to app-config.yaml or refer to it from an environment variable.

Set up Backstage in minutes with Roadie