Jira アカウントまたは Open Authorization (OAuth) を使用して、Jira を Application Real-Time Monitoring Service (ARMS) のアラート管理サブサービスと統合できます。このトピックでは、Jira アカウントを使用して Jira とアラート管理を統合する方法について説明します。この方法では、ARMS でアラートが生成されると、Jira に課題チケットが作成されます。アラートステータスと課題ステータスを同期できます。
Jira と ARMS を統合する
ARMS console にログインします。左側のナビゲーションペインで、 を選択します。
統合ページで、通知の統合タブをクリックし、JIRA をクリックします。
統合の追加ウィザードで、以下の情報に基づいてパラメータを設定します。
基本情報の手順で、統合名と Jira インスタンス URL を入力し、検証方法パラメータをJira アカウントでログインに設定し、Jira インスタンスのユーザー名とパスワードを入力し、必要に応じて統合の説明を追加して、接続テストをクリックします。
接続成功メッセージが表示されたら、次へをクリックします。
説明接続に失敗した場合は、指定した URL、ユーザー名、またはパスワードが無効です。パラメータを変更し、接続テストをもう一度クリックします。
アラートソースの設定の手順で、アラート同期の以下のパラメータを設定し、保存をクリックします。
パラメータ
説明
例
プロジェクト
アラートに関する情報が同期される Jira プロジェクトを指定します。
統合監視、管理、制御プロジェクト
タイプ
Jira の課題タイプ。有効な値:
タスク
サブタスク
改善
新機能
バグ
エピック
ストーリー
バグ
アラートが無効になっている場合の課題のステータス
課題が解決されたときの Jira 課題のステータス。Jira 課題が指定された状態にある場合、Jira 課題は解決済みとして識別されます。課題に対応するアラートに対する操作は、課題に同期されません。有効な値:
実行予定
処理中
レビュー中
完了
説明完了を選択することをお勧めします。別の値を選択し、課題のステータスが「完了」に変更された場合でも、課題に対応するアラートに対する操作は引き続き課題に同期されます。
完了
優先度
アラートの重大度レベルと Jira の課題の優先度のマッピング。
重要アラートの重大度レベルが課題の優先度にマッピングされていない場合、この重大度レベルのアラートは Jira に同期されません。
アラートが Jira に初めてプッシュされると、設定したマッピングに基づいて重大度レベルが同期されます。重大度レベルが同期された後、重大度レベルのみを変更した場合、変更に関する情報は Jira に同期されません。
P1:最高
P2:高
P3:中
P4:低
P5:最低
設定が完了すると、通知の統合タブで作成された Jira 統合を表示できます。
Jira にアラートをプッシュする
Jira 統合を追加した後、次の 3 つの方法のいずれかを使用して Jira にアラートをプッシュできます。
方法 1
アラートが生成されたときに Jira に課題を作成する通知ポリシーを設定します。
左側のナビゲーションペインで、 を選択します。
通知ポリシーページで、通知ポリシーの作成をクリックするか、既存の通知ポリシーを編集します。
通知ポリシー編集ページのアラートがトリガーされた場合セクションで、連絡先パラメータを指定します。少なくとも 1 つの連絡先または連絡先グループを選択する必要があります。
重要Jira は、通知ポリシーで指定された最初の連絡先と同じメールアドレスまたは名前(ユーザー名)を持つユーザーを検索し、そのユーザーを作成された課題の担当者として設定します。
Jira が通知ポリシーで指定された最初の連絡先に一致するユーザーを見つけられない場合、アラートは Jira にプッシュされません。
チケットシステムに作成した Jira 統合を選択します。必要に応じて他のパラメータを設定します。詳細については、通知ポリシーを作成および管理するを参照してください。
保存をクリックします。
この方法では、通知ポリシーに一致するアラートが Jira にプッシュされます。
方法 2
アラートイベント履歴ページで、アラートを Jira にプッシュし、Jira に課題を作成します。
左側のナビゲーションペインで、 を選択します。
アラート送信履歴ページの右上隅で、Jira 課題の担当者をアラートに関連付け、表示するアラートの名前をクリックします。
重要Jira は、オペレーターと同じメールアドレスまたは名前(ユーザー名)を持つユーザーを検索し、そのユーザーを作成された課題の担当者として設定します。
Jira が一致するユーザーを見つけられない場合、アラートは Jira にプッシュされません。
アラートの詳細ページで、右上隅のアイコンをクリックし、アラートのプッシュをクリックします。
表示されるダイアログボックスで、チケットシステムドロップダウンリストから作成された Jira 統合を選択し、OK をクリックします。
アラートがプッシュされると、アラート詳細ページでアラートに対応する Jira 課題へのリンクを表示できます。
方法 3
アラートが生成され、指定した DingTalk グループチャットでアラートカードを受信した後、アラートカードを使用してアラートを Jira にプッシュできます。その後、対応する課題が Jira に作成されます。
アラートをプッシュしたオペレーターが、Jira に作成された課題の担当者になります。
オペレーターは、DingTalk グループのアラートカードに携帯電話番号がバインドされている連絡先です。詳細については、履歴アラートを表示するトピックの「アラートを処理する」セクションを参照してください。
Jira が ARMS で指定した連絡先と同じメールアドレスまたはユーザー名を持つユーザーを見つけた場合、連絡先は Jira のユーザーと一致します。
Jira が一致するユーザーを見つけられない場合、アラートは Jira にプッシュされません。
DingTalk グループで受信したアラートカードで、アラートのプッシュをクリックし、作成した Jira 統合を選択します。
アラートカードのアラート名をクリックします。アラートの詳細パネルで、設定をクリックし、アラートのプッシュをクリックして、作成した Jira 統合を選択します。
アラートがプッシュされると、アラートの詳細ページでアラートに対応する Jira 課題へのリンクを見つけることができます。
同期できるアラート関連の操作
上記の手順を完了すると、ARMS のアラートに対する次の操作が Jira に同期されます。
アラート送信履歴ページの次の操作は Jira に同期されます。
アラートの要求:要求者が Jira の課題の担当者になります。
説明要求者には、Jira に一致するユーザーアカウントが必要です。
アラートへのコメント:コメントは Jira の課題のコメントに同期されます。
アラートの解決:解決策は Jira の課題のコメントに同期されます。
アラートカードの次の操作は Jira に同期されます。
アラートの要求:要求者が Jira の課題の担当者になります。
要求者には、Jira に一致するユーザーアカウントが必要です。
Jira の操作をアラートに同期する
ARMS の統合ページで、通知の統合タブをクリックして、Jira の統合キーを取得します。
Jira チケッティングシステムにログインします。右上隅にある設定アイコンをクリックし、システムをクリックします。
管理者パスワードを入力し、OK をクリックしてシステム設定ページに移動します。
システム ページの左側のナビゲーション ウィンドウで、Webhook をクリックします。
Webhook ページで、+ Webhook を作成をクリックします。
表示されるページで、URL を
http://alerts.aliyuncs.com/api/jira/receiver/{token}/${project.key}/${issue.key}
に設定します。{token} は、手順 1 で取得した Jira 統合キーに置き換えます。必要に応じて他のパラメータを設定します。詳細については、Jira のドキュメントを参照してください。次に、作成をクリックします。
上記の手順を完了すると、Jira の課題に対する次の操作が ARMS のアラート管理に同期されます。
課題の担当者を変更する:対応するアラートの担当者が変更されます。
課題にコメントする:コメントは対応するアラートのコメントに追加されます。