FireHydrant can create tickets in Jira for each of your incidents, with linked tickets for actions performed during the incident and for follow-ups to be performed later. This way, all actions scheduled or proposed during an incident are tracked in your existing workflows. This helps project managers to easily estimate and schedule follow-up work.
Note: To configure FireHydrant’s Jira Server integration requires a Jira administrator and a user with a FireHydrant owner role. FireHydrant recommends creating the Jira Server integration using a generic system admin Jira account to prevent potential problems from a Jira admin’s departure and subsequent account decommissioning.
Setting up Jira Server (On-Prem) integration
Identify or create an admin user in Jira with access to the projects you want to be available in FireHydrant. FireHydrant recommends using a generic Jira Server admin account instead of a named individual to avoid problems if that individual were to depart the organization.
From FireHydrant left navigation bar, select Integrations. Locate and add the Jira Server (on premise) integration, using the username and password from the previous step. You also need your Jira server URL and authorization access from FireHydrant's NAT IP address (188.8.131.52) if there are network restrictions.
Jira webhook configuration
To see updates to your Jira tickets reflected in FireHydrant, you can add a webhook to Jira.
In the FireHydrant left nav, click Integrations. Click to edit your Jira Server (on premise) configuration. From the Jira Server integration page, copy the webhook URL.
Follow the instructions for setting up a webhook in Jira using the URL you copied from FireHydrant.
Note: In order for FireHydrant users to be able to create tickets in Jira projects configured in FireHydrant, they will need to have corresponding permissions in Jira to access the projects.
Next you’ll want to configure how FireHydrant should interact with your Jira Server projects. From the FireHydrant’s Jira integration configuration, navigate to the Projects section. From here you can define the default behavior on a per project basis, for example the default issue type for FireHydrant incidents and follow-up actions and relationships between linked issues.
Removing a configured project
Note: To avoid unexpected problems, before you delete a configured Jira project, ensure that you have accounted for any Runbook steps and linked incidents and action items that reference the project.
To remove a configured Jira project from the integration, go to the Jira Server integration settings. Under Projects click Edit next to the project you wish to remove, then select Delete Permanently. Confirm the action.
Configuring Jira custom field mappings
If you have Jira custom fields that you wish to populate with FireHydrant incident data, please refer to the custom field configuration document.
Setting a default project
Next configure a default project for your organization. This will act as a fallback in the event that a FireHydrant Jira ticket creation request request cannot communicate with the specified Jira project. To set a default project go to Organization > Account Overview. From the Account Overview page, choose to Edit the Organization section. On the Default project for tickets entry select a default project, then click Save organization.
If in the future you disconnect this integration, you will need to reconfigure the default project if you decide to reenable it.
Creating Jira incident tickets from a Runbook
Note: The default behavior is to allow only a single top-level incident ticket per FireHydrant incident. There is no limitation on linked action items tickets. If your organization requires multiple top-level incident tickets per incident, please create a support ticket to request that this functionality be enabled for your organization.
In order to trigger a Jira Server issue creation from a new incident, you'll need to add a Runbook step and specify the Jira project destination.
From the Runbook step menu navigate to Jira Server and select Create a Jira Server Issue. Select the Jira project destination from the configured project list, and optionally adjust the default populated fields.
Now you're ready to create action items in FireHydrant and sync them to Jira.
Troubleshooting integration issues
You can check the health status of a Jira Server integration from the Jira Server integration configuration tab. Choose to edit the integration, then review the Connection Health section on the configuration details.