Skip to main content

JIRA Software Integration Workflow

The bidirectional JIRA Software integration keeps critical information synchronized between Moogsoft Enterprise and JIRA Software.

If enabled, this integration allows you to:

  • Create a JIRA issue from an open Situation in Moogsoft Enterprise.

  • Add comments in a Situation Room for them to appear on the linked JIRA issue and vice versa.

  • Change the status of a Situation to change the status of the linked JIRA issue and vice versa.

Note

It is not possible to create a Situation from a JIRA issue.

Create a JIRA issue from a Situation

You can create a JIRA issue from a Situation in Moogsoft Enterprise as follows:

  1. Open a Situation view such as Open Situations.

  2. Right-click on the Situation you want to create a JIRA issue from.

  3. Click Tools and Open JIRA Ticket in the drop-down menu.

  4. Click OK on the response status pop-up window to continue.

After completing these steps, a new issue appears in JIRA. You can create multiple issues from the same Situation but the latest issue replaces the previous issue associated with the Situation. Each new issue has the default summary 'New ticket has been opened for Moogsoft Enterprise Situation [<sig_id>]' and the description 'Created from Moogsoft Enterprise Situation <sig_id>'. This contains a hyperlink back to the Situation in Moogsoft Enterprise.

If you enable auto-assign when installing the integration, the logged in user automatically becomes the assignee for any new JIRA issues created from Situations. Your username must match exactly in Moogsoft Enterprise and JIRA for this feature to work.

Create a JIRA issue from an alert

You can create a JIRA issue from an alert in Moogsoft Enterprise as follows:

  1. Open an alert view such as Open Alerts or select the Alerts tab in a Situation Room.

  2. Right-click on the alert you want to create a JIRA issue from.

  3. Click Tools and Open JIRA Ticket in the drop-down menu.

  4. Click OK on the response status pop-up window to continue.

After completing these steps, a new issue appears in JIRA. You can only create a single issue from each alert. Each new issue has the default summary 'New issue has been opened for Moogsoft Enterprise Alert [<alert_id>]' and the description 'Created from Moogsoft Enterprise Alert <alert_id>'.

Change a JIRA issue or Situation status

When you change the status of a Situation in Moogsoft Enterprise, the status of the associated issue in JIRA changes and vice versa.

If you close a Situation, the integration marks the associated JIRA issue as 'Done'. If you change the status of a JIRA issue to 'Done', the integration also closes the associated Situation.

The default status mapping for the integration is as follows:

Moogsoft Enterprise

JIRA Software

Opened

To Do

Resolved

Done

Closed

Done

Bidirectional comments

When you add a comment to a Situation Room, the same comment appears on the associated JIRA issue and vice versa. Any new comment is prefixed by the commenter's username. For example, if a user called 'Operator' makes a comment, it appears in JIRA as "operator: <comment text>".

If you add a journal entry when you close a Situation this also appears as a new comment on the associated JIRA issue.