Application Real-Time Monitoring Service (ARMS) のアラート管理では、Jira アカウント認証情報または OAuth を使用して Jira チケットシステムを統合できます。この統合により、アラートがトリガーされると自動的に Jira 課題が作成され、アラートと課題のステータスが双方向で同期されます。
ARMS での Jira インテグレーションの設定
ARMS コンソール にログインします。左側のナビゲーションウィンドウで、 を選択します。
統合 ページで、統合の通知 タブをクリックし、[JIRA] をクリックします。
統合の追加 ウィザードで、次の手順を実行します。
基本情報 ページで、インテグレーション名と Jira インスタンスの URL を入力します。[Verification method] を [Log on with Jira account] に設定し、Jira のユーザー名とパスワードを入力します。必要に応じて説明を追加し、テスト接続 をクリックします。
[Connection Succeeded] メッセージが表示されたら、次へ をクリックします。
説明接続に失敗した場合は、Jira の URL、ユーザー名、またはパスワードが正しくない可能性があります。設定を修正し、テスト接続 を再度クリックしてください。
アラートソースの設定 ページで、次の表に従ってアラート同期設定を構成し、保存 をクリックします。
パラメータ
説明
例
プロジェクト
アラートがトリガーされたときに課題が作成される Jira プロジェクトです。
Integrated monitoring, management, and control project
タイプ
アラートに対する Jira 課題タイプです。
タスク
サブタスク
改善
新機能
バグ
エピック
ストーリー
バグ
課題のクローズステータス
Jira 課題をクローズ済みとしてマークするステータスです。課題がこのステータスに達すると、以降のアラート操作は同期されなくなります。利用可能なステータス:
To Do
In Progress
In Review
Done
説明Done を選択することを推奨します。別のステータスを選択した場合、課題のステータスが Done に変更された後も、アラート操作は対応する Jira 課題に同期されます。
Done
優先度
アラートの重要度レベルを Jira 課題の優先度にマッピングします。
重要アラートの重要度レベルに対してマッピングを設定しない場合、そのレベルのアラートは Jira に同期されません。
アラートの重要度レベルは、Jira に最初にプッシュされたときにのみ、このマッピングに基づいて同期されます。ARMS アラート管理でアラートの重要度レベルを後から変更しても、Jira 課題には同期されません。
P1: Hightest
P2: High
P3: Medium
P4: Low
P5: Lowest
設定を保存すると、統合の通知 タブに新しい Jira インテグレーションが表示されます。リストには、[Name]、[インテグレーションキー]、[Type]、[Creation time] などの情報が表示されます。[Actions] 列からインテグレーションを管理できます。
Jira へのアラートのプッシュ
Jira インテグレーションを設定した後、次の 3 つの方法でアラートを Jira にプッシュできます。
方法 1
通知ポリシーを設定することで、アラートがトリガーされたときに Jira で自動的に課題が作成されます。
左側のナビゲーションペインで、 を選択します。
通知ポリシー ページで、通知ポリシーの作成 をクリックするか、既存の通知ポリシーを編集します。
アラートが生成されたとき セクションで、[Contacts] を指定します。少なくとも 1 つの連絡先または連絡先グループを選択する必要があります。
重要Jira は、通知ポリシーの最初の連絡先のメールアドレスまたはユーザー名と一致するユーザーに課題を割り当てます。
通知ポリシーの最初の連絡先に Jira で対応するユーザーがいない場合、アラートは Jira に同期されません。
[Ticket system] で、作成した Jira インテグレーションを選択します。必要に応じて他のパラメータを設定します。詳細については、「通知ポリシー」をご参照ください。
保存 をクリックします。
設定が完了すると、この通知ポリシーに一致するアラートが Jira にプッシュされます。
方法 2
アラート送信履歴 ページから、既存のアラートを手動で Jira にプッシュして課題を作成できます。
左側のナビゲーションペインで、 を選択します。
アラート送信履歴 ページで、右上隅でオペレーターを選択して Jira 課題担当者として設定し、対象のアラート名をクリックします。
重要Jira は、選択されたオペレーターのメールアドレスまたはユーザー名と一致するユーザーに課題を割り当てます。
オペレーターに Jira で対応するユーザーがいない場合、アラートは Jira に同期できません。
アラート詳細ページで、右上隅の
アイコンをクリックし、アラートのプッシュ をクリックします。表示されたダイアログボックスで、[Ticket system] で作成した Jira インテグレーションを選択し、確認 をクリックします。
アラートが正常にプッシュされると、アラート詳細ページに対応する Jira 課題へのリンク (AL-6 など) が表示されます。
方法 3
DingTalk グループでアラートカードを受信した場合、カードから直接対応するアラートを Jira にプッシュできます。
DingTalk グループからアラートをプッシュしたユーザーが、Jira の課題担当者になります。
オペレーターは、DingTalk グループのアラートカードで携帯電話番号を紐付けた連絡先である必要があります。詳細については、「アラートの処理」をご参照ください。
Jira ユーザーのメールまたはユーザー名が ARMS 連絡先のメールまたは名前と一致する場合、その連絡先はその Jira ユーザーにマッピングされます。
オペレーターに Jira で対応するユーザーがいない場合、アラートは Jira に同期できません。
DingTalk グループで受信したアラートカードで、アラートのプッシュ をクリックし、作成した Jira インテグレーションを選択します。
アラートカードで、アラート名をクリックします。アラート詳細パネルで、設定 をクリックし、[Push ticket] をクリックして、作成した Jira インテグレーションを選択します。
アラートが正常にプッシュされると、アラート詳細ページに対応する Jira 課題へのリンクが表示されます。
[同期対象のアラート操作]
設定が完了すると、ARMS アラート管理での次のアラート操作が Jira チケットシステムと同期されます。
アラート送信履歴 ページでの操作:
アラートの担当: Jira 課題担当者を更新します。
説明アラートを担当するユーザーは、Jira に対応するユーザーアカウントがある必要があります。
アラートへのコメント: Jira 課題にコメントを追加します。
アラートの解決: Jira 課題に解決内容をコメントとして追加します。
DingTalk グループのアラートカードでの操作:
アラートの担当: Jira 課題担当者を更新します。
アラートを担当するユーザーは、Jira に対応するユーザーアカウントがある必要があります。
Jira のアクションの ARMS への同期
ARMS アラート管理で、統合 ページに移動し、統合の通知 タブをクリックして、Jira インテグレーションのインテグレーションキーをコピーします。
Jira チケットシステムにサインインします。Jira ページの右上隅にある設定アイコンをクリックし、OsType をクリックします。
管理者パスワードを入力し、確認 をクリックして、システム設定ページに移動します。
OsType ページの左側のナビゲーションペインで、 を選択します。
WebHooks ページで、[+ Create a webhook] をクリックします。
Create a webhook ページで、[URL] を
http://alerts.aliyuncs.com/api/jira/receiver/{token}/${project.key}/${issue.key}に設定します。{token} を手順 1 の Jira インテグレーションキーに置き換えます。[Name] を
ARMS Alert Managementに設定し、[Status] を [Enabled] に変更します。[Issue related events] セクションで、[All issues] を選択します。[Issue] 列で、[created]、[updated]、[deleted] を選択します。[Comment] 列で、[created]、[updated]、[deleted] を選択します。必要に応じて他のパラメータを設定します。詳細については、「Jira 公式ドキュメント」をご参照ください。次に、新規作成 をクリックします。
これらの手順が完了すると、次の Jira 課題操作が ARMS アラート管理と同期されます。
課題担当者の変更: 対応するアラートの担当者が更新されます。
課題へのコメントの追加: 対応するアラートにコメントが追加されます。