Application Real-Time Monitoring Service:Integrate Jira by using account credentials

Configure the Jira integration in ARMS

1. Log on to the ARMS console. In the left-side navigation pane, choose Alert Management > Integrations.

2. On the Integrations page, click the Notification Integration tab, and then click JIRA.

3. In the Add Integration wizard, complete the following steps:

   1. On the Basic Information page, enter an integration name and the Jira instance URL. Set Verification method to Log on with Jira account, and enter the Jira username and password. Optionally, add a description, and then click Test Connectivity.

   2. After the Connection Succeeded message appears, click Next.

      Note

      If the connection fails, your Jira URL, username, or password may be incorrect. Correct the settings and click Test Connectivity again.

   3. On the Alert Source Configuration page, configure the alert synchronization settings as described in the following table, and then click Save.

      Parameter	Description	Example
      Project	The Jira project where issues are created when an alert is triggered.	Integrated monitoring, management, and control project
      Type	The Jira issue type for the alert. Task Subtask Improvement New feature Bug Epic Story	Bug
      Issue closed status	The status that marks a Jira issue as closed. Once an issue reaches this status, subsequent alert operations are no longer synchronized to it. Available statuses: To Do In Progress In Review Done Note We recommend that you select Done. If you select a different status, alert operations will still be synced to the corresponding Jira issue even after its status changes to Done.	Done
      Priority	Maps alert severity levels to Jira issue priorities. Important If you do not configure a mapping for an alert severity level, alerts of that level will not be synced to Jira. The alert's severity level is synchronized based on this mapping only when it is first pushed to Jira. Subsequent changes to the alert severity level in ARMS Alert Management are not synchronized to the Jira issue.	P1: Hightest P2: High P3: Medium P4: Low P5: Lowest

   After you save the configuration, you can view the new Jira integration on the Notification Integration tab. The list displays information such as the Name, Integration key, Type, and Creation time. You can manage the integration from the Actions column.

Push alerts to Jira

After configuring the Jira integration, you can push alerts to Jira in three ways:

Method 1

Set up a notification policy to automatically create an issue in Jira when an alert is triggered.

1. In the left-side navigation pane, choose Alert Management > Notification Policies.

2. On the Notification Policies page, click Create Notification Policy or edit an existing notification policy.

3. In the When an alert is triggered, section, specify the Contacts. You must select at least one contact or contact group.

   Important

   • Jira assigns the issue to a user whose email address or username matches that of the first contact in the notification policy.

   • If the first contact in the notification policy does not have a corresponding user in Jira, the alert will not be synced to Jira.

4. For Ticket system, select the Jira integration that you created. Configure other parameters as required. For more information, see Notification policies.

5. Click Save.

   After you complete the configuration, alerts that match this notification policy are pushed to Jira.

Method 2

From the Alert Sending History page, you can manually push an existing alert to Jira to create an issue.

1. In the left-side navigation pane, choose Alert Management > Alert Sending History.

2. On the Alert Sending History page, select an operator in the upper-right corner to act as the Jira issue handler, and then click the name of the target alert.

   Important

   • Jira assigns the issue to a user whose email address or username matches that of the selected operator.

   • If the operator does not have a corresponding user in Jira, the alert cannot be synced to Jira.

3. On the alert details page, click the icon in the upper-right corner, and then click Push Alerts.

4. In the dialog box that appears, for Ticket system, select the Jira integration you created and click Confirm.

   After the alert is pushed successfully, a link to the corresponding Jira issue, such as AL-6, appears on the alert details page.

Method 3

When you receive an alert card in a DingTalk group, you can push the corresponding alert to Jira directly from the card.

• On the alert card you receive in the DingTalk group, click Push Alerts and select the Jira integration that you created.

• On the alert card, click the alert name. In the alert details panel, click Settings, click Push ticket, and select the Jira integration that you created.

After the alert is pushed successfully, a link to the corresponding Jira issue appears on the alert details page.

Supported alert operations for synchronization

Once configured, the following alert operations in ARMS Alert Management are synchronized with the Jira ticket system.

Operations on the Alert Sending History page:

• Claim alert: Updates the Jira issue handler.

  Note

  The user who claims the alert must have a corresponding user account in Jira.

• Comment on alert: Adds the comment to the Jira issue.

• Resolve alert: Adds the resolution as a comment to the Jira issue.

Operations on the alert card in a DingTalk group:

Claim alert: Updates the Jira issue handler.

Sync Jira actions back to ARMS

1. In ARMS Alert Management, navigate to the Integrations page, click the Notification Integration tab, and copy the integration key for your Jira integration.

2. Log on to your Jira ticket system. In the upper-right corner of the Jira page, click the settings icon, and then click OsType.

3. Enter your administrator password and click Confirm to go to the system configuration page.

4. In the left-side navigation pane of the OsType page, choose Alerts > Webhook.

5. On the Webhooks page, click + Create a webhook.

6. On the Create a webhook page, set the URL to http://alerts.aliyuncs.com/api/jira/receiver/{token}/${project.key}/${issue.key}. Replace {token} with the Jira integration key from Step 1.

   Set Name to ARMS Alert Management and change the Status to Enabled. In the Issue related events section, select All issues. Under the Issue column, select created, updated, and deleted. Under the Comment column, select created, updated, and deleted.

7. Configure other parameters as required. For more information, see the official Jira documentation. Then, click Create .

   After completing these steps, the following Jira issue operations are synchronized with ARMS Alert Management.

   • Changing the issue handler: The handler of the corresponding alert is updated.

   • Adding a comment to an issue: A comment is added to the corresponding alert.