Linking services in other tools to FireHydrant services
FireHydrant's Service Catalog allows you to link your FireHydrant Services and Functionalities to related services in external tools like GitHub, PagerDuty, Opsgenie, or Splunk On-Call (VictorOps).
With the alerting providers, once services are linked between tools, you can enable the ability to automatically alert a default escalation policy when the service is added to an incident on FireHydrant. This also enables the ability to find who's on-call for a service and page them.
If you have a GitHub integration installed, this will allow you to see change events at a service level to quickly pinpoint service issues in an incident.
This page covers how to link existing FireHydrant Services and Functionalities. If you want to import services, see Importing Services.
Prerequisites
To link your services or functionalities, you'll need to have one of the integrations listed below configured. Integrations we currently support for linking services and functionalities are:
Linking via Web UI
-
Select a Service from the Services page or a Functionality from the Functionalities page.
-
Click Edit, and scroll down to the section titled Integration links.
Integration links in catalog item settings -
If you have installed one of the above supported integrations, you will have the option to click Configure next to the provider.
-
Once you click Configure, FireHydrant will return a list of services or repositories from the provider.
-
You can select one or more values to link to your catalog item in FireHydrant. Once you have finished selecting, scroll down and click Save edits.
-
With this Integration link you will be able to set up Automatic alerting on this service. To learn about enabling automatic alerting, see Auto-Alerting via Services.
Linking via API
You can also programmatically link Services by using the PATCH /services/{service_id}
endpoint.
The parameter of interest for this will be the external_resources
argument.
Next Steps
Now that you've linked your Services, you can further streamline your incident response.
- Learn how to automatically page a team when their Service or Functionality is impacted in an incient
- Look at the available Slack commands to see who's on-call for a particular Service or Functionality and directly page them.