Application Real-Time Monitoring Service:Jira アカウントを用いた ARMS アラート管理との連携

仕組み

ARMS アラート管理は、Jira アカウントを介して Jira インスタンスに接続します。アラートが発火すると、ARMS は指定された Jira プロジェクトにイシューを作成し、アラート重大度レベルを Jira 優先度にマッピングします。

各同期方向には、それぞれ専用の設定が必要です：

• ARMS → Jira：連携設定時に構成します。アラート操作（担当者設定、コメント追加、解決）は、関連付けられた Jira イシューへ自動的に同期されます。

• Jira → ARMS：Jira の Webhook を設定し、イシュー更新（担当者再割り当て、コメント追加）を ARMS へ送信する必要があります。

ユーザーの照合： ARMS は、メールアドレスまたはユーザー名を用いて、両システム間のユーザーを照合します。照合可能な Jira ユーザーが存在しない場合、アラートは Jira へプッシュされません。

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

• アラート管理の権限を持つ ARMS コンソールへのアクセス権限

• イシュー作成権限を持つ Jira インスタンスの URL、ユーザー名、パスワード

ステップ 1：Jira 連携の作成

1. まず、ARMS コンソール にログインします。左側ナビゲーションウィンドウで、アラート管理 > 連携 を選択します。

2. 連携 ページで、通知連携 タブをクリックし、その後 JIRA をクリックします。

3. 連携の追加 ウィザードで、以下の手順を実行します：

   1. 基本情報 ステップで、接続設定を行います：

      • 連携名と Jira インスタンスの URL を入力します。

      • 検証方法 を Jira アカウントでログイン に設定します。

      • Jira インスタンスのユーザー名とパスワードを入力します。

      • （任意）説明を追加します。

      • 接続テスト をクリックします。

   2. 接続に成功しました のメッセージが表示された後、次へ をクリックします。

      説明

      接続に失敗した場合は、URL、ユーザー名、パスワードを確認し、再度 接続テスト をクリックしてください。

   3. アラートソース設定 ステップで、アラートからイシューへのマッピングを設定します：

      パラメーター	説明	例
      プロジェクト	ARMS がアラート用にイシューを作成する Jira プロジェクト。	Monitoring Project
      タイプ	Jira のイシュータイプ。有効な値：Task、Subtask、Improvement、New feature、Bug、Epic、Story。	Bug
      アラート無効時のイシュー状態	イシューを「解決済み」とマークする Jira の状態。Jira イシューがこの状態に達すると、ARMS はそれ以降のアラート操作をイシューへ同期しなくなります。有効な値：To Do、In Progress、In Review、Done。	Done
      優先度	ARMS アラート重大度レベルを Jira イシュー優先度にマッピングします。	P1：Highest、P2：High、P3：Medium、P4：Low、P5：Lowest

      重要

      • アラート重大度レベルが Jira 優先度にマッピングされていない場合、そのレベルのアラートは Jira へプッシュされません。

      • 重大度から優先度へのマッピングは、最初のプッシュ時のみ適用されます。その後のアラート重大度の変更のみでは、Jira イシューの優先度は更新されません。

      • 解決状態として Done を選択することを推奨します。異なる値を選択した場合、イシューが後に Done へ遷移しても、ARMS は引き続きアラート操作をイシューへ同期します。

   4. 保存 をクリックします。

ステップ 2：アラートを Jira へプッシュ

連携を作成した後、以下のいずれかの方法でアラートを Jira へプッシュできます。

オプション A：通知ポリシーによる自動プッシュ

通知ポリシーを設定することで、該当するアラートが発火するたびに Jira イシューを自動作成できます。

1. 左側ナビゲーションウィンドウで、アラート管理 > 通知ポリシー を選択します。

2. 通知ポリシー ページで、通知ポリシーの作成 をクリックするか、既存のポリシーを編集します。

3. アラートがトリガーされたとき のセクションで、連絡先 パラメーターに対して、少なくとも 1 つの連絡先または連絡先グループを指定します。

   重要

   • ARMS は、ポリシー内の最初の連絡先をメールアドレスまたはユーザー名で Jira ユーザーと照合し、そのユーザーをイシューのハンドラとして割り当てます。

   • 照合可能な Jira ユーザーが存在しない場合、アラートは Jira へプッシュされません。

4. チケットシステム に作成した Jira 連携を選択します。必要に応じて他のパラメーターを設定します。「通知ポリシーの作成と管理」については、「通知ポリシーの作成と管理」をご参照ください。

5. 保存 をクリックします。

   通知ポリシーに一致するアラートは、これ以降自動的に Jira へプッシュされるようになります。

オプション B：アラート送信履歴ページからの手動プッシュ

アラートの詳細ページから個別のアラートを Jira へプッシュできます。

1. 左側ナビゲーションウィンドウで、アラート管理 > アラート送信履歴 を選択します。

2. アラート送信履歴 ページの右上隅で、アラートにハンドラを関連付け、その後アラート名をクリックします。

   重要

   • ARMS は、オペレーターをメールアドレスまたはユーザー名で Jira ユーザーと照合し、そのユーザーをイシューのハンドラとして割り当てます。

   • 照合可能な Jira ユーザーが存在しない場合、アラートは Jira へプッシュされません。

3. アラート詳細ページの右上隅にある アイコンをクリックし、アラートのプッシュ をクリックします。

4. ダイアログボックスで、チケットシステム のドロップダウンリストから Jira 連携を選択し、OK をクリックします。

アラートがプッシュされると、アラート詳細ページに該当する Jira イシューへのリンクが表示されます。

オプション C：DingTalk アラートカードからのプッシュ

DingTalk グループのアラートカードから直接アラートを Jira へプッシュできます。

以下のいずれかの方法で実行できます：

• アラートカード上で アラートのプッシュ をクリックし、Jira 連携を選択します。

• カード上のアラート名をクリックします。詳細パネルで 設定項目 > アラートのプッシュ をクリックし、Jira 連携を選択します。

アラートがプッシュされると、アラート詳細ページに該当する Jira イシューへのリンクが表示されます。

ARMS から Jira へ同期される操作

アラートを Jira へプッシュした後、以下の ARMS 操作が関連付けられたイシューへ自動的に同期されます：

ステップ 3：Jira から ARMS への同期の設定

Jira イシューの更新（担当者再割り当て、コメント追加）を ARMS へ同期するには、Jira 側で Webhook を作成します。

1. ARMS の 連携 ページで、通知連携 タブをクリックし、Jira 連携の連携キーをコピーします。

   

2. Jira インスタンスにログインします。右上隅の設定アイコンをクリックし、システム をクリックします。

   

3. 管理者パスワードを入力し、OK をクリックします。

4. システム ページの左側ナビゲーションウィンドウで、Webhooks をクリックします。

5. ＋ Webhook の作成 をクリックします。

   

6. URL を以下の値に設定します。ただし、{token} の部分は、ステップ 1 でコピーした連携キーに置き換えてください：

   http://alerts.aliyuncs.com/api/jira/receiver/{token}/${project.key}/${issue.key}

   

7. その他の Webhook パラメーターは必要に応じて設定します。詳細については、Jira Webhook ドキュメント をご参照ください。作成 をクリックします。

Webhook が有効になると、以下の Jira 操作が ARMS へ同期されます：