Create Jira issues from Monta alerts

This article is for operators who track their work in Jira Cloud. You connect the Jira app from the Application Marketplace in Hub. Monta then creates one Jira issue for each open alert. An alert that already has an open issue is left alone.

What you need

• A Jira Cloud site and an Atlassian account that can create issues in the project you want to use.
• The key of that Jira project, for example OPS.
• Access to the Application Marketplace in Hub.
• Alert rules in Hub. The rules decide which alerts open. The Jira app only delivers them. See How do I use Alert monitoring in Monta Hub?.
• Pop-ups allowed for Hub in your browser. Atlassian asks for your consent in a new window.

Connect Jira

1. In Hub, select Admin > Developers > Application Marketplace.
2. Open the Jira app.
3. Select Connect Jira.
4. In the Atlassian window, sign in and choose the Jira site that Monta may use. Approve the request.
5. Return to Hub. The app shows Connected and the address of your Jira site.

You do not paste an API token. If you grant more than one Jira site, a site menu appears next to Disconnect. Use it to switch sites.

Choose the project and issue type

Under Settings, set the following:

1. In Project key, enter the key of the Jira project that should receive the issues. Use capital letters, for example OPS.
2. In Issue type, pick a type from the list. The list shows the issue types of that project in Jira. The default is Task.
3. Select Create issues automatically.
4. Select Save settings.

If Jira cannot return the list of issue types, you can type the issue type name instead. The name must exist in the project, or Jira rejects the issue.

To change which alerts open, select Open alert rules. This opens the Alert monitoring settings page in Hub.

What happens after you connect

• Every 5 minutes, the app checks your open alerts.
• Each open alert without an open Jira issue gets a new issue. The title starts with "Monta alert:", followed by the alert title.
• The issue description holds the alert type, the reason it opened when there is one, the number of issues and charging stations, and a link to the alert in Hub.
• Each check creates up to 50 issues. If more alerts are waiting, the next checks create the rest.
• An alert whose issue is still open in Jira never gets a second issue. If you close the issue in Jira while the alert is still open, the app creates a new one.
• Issues are created only by the automatic check. You cannot create one by hand from Hub.

Below the settings, the app shows the time of the last automatic check and how many issues it created. Each created issue links to Jira.

Disconnect Jira

1. In Hub, open the Jira app in the Application Marketplace.
2. Select Disconnect.

The card then shows Not connected, and no new issues are created. Issues that already exist stay in Jira.

Fix common problems

The Connect Jira window does not open

Allow pop-ups for Hub in your browser, then select Connect Jira again.

No issues appear in Jira

Check that Create issues automatically is selected and saved. Check that a project key is set and that your alert rules have opened at least one alert.

I do not see the Jira app

If you do not see the Jira app in the Application Marketplace, contact Monta support.