Connecting to Jira
To set up Magic Suite apps to connect to your Jira system:
- From the Admin menu, click Connections
- Click the Create button
- Enter a name (e.g. "Jira Production" or "Jira Test") and optionally, a description
- From the Type drop-down, select a Connection type of Jira
- Set the URL field to your Jira hostname, for example https://myjira.com
- If authenticating using a Personal Access Token (recommended):
- Leave the User name field blank
- Set the Password field to the Personal Access Token
- If authenticating using Username/Password:
- Set the User name field to the username to connect with
- Set the Password field to the password
You may now:
- Use
[Jira.XXX:]macros - Set up multiple Jira Connections and choose the default via the Admin => Macro Defaults page, or use a
[Jira.Connection:]macro in your templates / Report Studio when developing and testing macros. - Automatically manage incidents in Jira using AlertMagic
Automatic Merlin investigation
A Jira Connection can ask Merlin to investigate new tickets, and to post what it finds as a comment on each one. It is off unless you switch it on. Add a MerlinAutoInvestigate section to the Connection's Configuration:
{
"MerlinAutoInvestigate": {
"Enabled": true,
"ProjectKey": "HULL",
"Jql": "labels = meraki",
"DailyCap": 20
}
}
- Enabled - set to true to switch it on. Anything else leaves it off.
- ProjectKey - the Jira project whose tickets Merlin may investigate.
- Jql - a Jira query that narrows which tickets are investigated, for example those with a particular label. Merlin only looks at tickets that match it.
- DailyCap - the most tickets this Connection will have investigated in a day.
Panoramic Data must also have switched automatic investigation on for your environment; if nothing happens, ask support. Merlin posts as the Connection, so the Connection must be able to comment (clear its Read Only checkbox). The comment says in its first line that it is an automatic Merlin analysis. Merlin only reads your Meraki and LogicMonitor data; it never changes anything. See Configuring Merlin for your Tenant for the limits that apply.