Application Real-Time Monitoring Service:OAuth を使用して Jira と ARMS を統合する

ステップ 1: Jira を構成する

1. コマンドラインインターフェイス (CLI) で次の OpenSSL コマンドを実行して、Rivest–Shamir–Adleman (RSA) 公開鍵と RSA 秘密鍵を生成します。

   説明

   この操作はファイルシステムの任意の場所で行うことができ、作成されたファイルは現在の場所に保存されます。

   1. 1024 ビットの秘密鍵を生成します。

      openssl genrsa -out jira_privatekey.pem 1024

   2. X509 証明書を作成します。

      openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365

   3. 秘密鍵 (PKCS8 形式) を jira_privatekey.pcks8 ファイルに解凍します。

      openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8

   4. 証明書から公開鍵を抽出して jira_publickey.pem ファイルに保存します。

      openssl x509 -pubkey -noout -in jira_publickey.cer  > jira_publickey.pem

2. アプリケーションリンクを作成します。

   1. Jira にログインし、Jira ページの右上隅にある設定アイコンをクリックして、[アプリケーション] をクリックします。

      

   2. [アプリケーション] タブで、[アプリケーションリンク] をクリックします。

   3. [アプリケーションリンクの構成] セクションで、URL を入力し、[新しいリンクを作成] をクリックします。

      説明

      URL は使用されません。ランダムな URL を入力できます。例: http://alerts.console.aliyun.com/。

   4. [アプリケーション URL の構成] ダイアログボックスで、警告を無視して [続行] をクリックします。

      

   5. [アプリケーションのリンク] ダイアログボックスで、アプリケーションの種類 を 汎用アプリケーション に設定し、コンシューマーキー を AlertOauthKey に設定し、受信リンクの作成 を選択し、その他のパラメーターを指定して、[続行] をクリックします。

      

   6. [アプリケーションのリンク] ダイアログボックスで、次のパラメーターを構成し、[続行] をクリックします。

      パラメーター	値
      コンシューマーキー	AlertOauthKey
      コンシューマー名	alertmanager
      公開鍵	ステップ 1 で生成された公開鍵。 jira_publickey.pem ファイルの内容です。

      

      しばらくすると、[アプリケーションリンクの構成] ページで新しいアプリケーションリンクを表示できます。

   7. アプリケーションリンクの [アクション] 列にある アイコンをクリックし、[alertmanager の構成] ダイアログボックスで、[受信認証] をクリックします。

      

   8. ステータス パラメーターに 未構成 と表示されている場合は、コンシューマーキー、コンシューマー名、および 公開鍵 を指定し、[保存] をクリックします。

   9. [キャンセル] をクリックします。

ステップ 2: Jira と ARMS を統合する

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

2. [統合] ページで、[通知統合] タブをクリックし、[JIRA] をクリックします。

3. [統合の追加] ウィザードで、次の情報に基づいてパラメーターを構成します。

   1. [基本情報] ウィザードページで、次のパラメーターを設定し、[確認コードを取得] をクリックします。

      Jira の確認ページに自動的にリダイレクトされます。

      パラメーター	値
      名前	Jira 統合の名前。
      説明	Jira 統合の説明。
      URL	Jira によって提供される URL。
      検証	検証 を Oauth に設定します。
      コンシューマーキー	AlertOauthKey
      秘密鍵	ステップ 1 で生成された秘密鍵。 jira_privatekey.pcks8 ファイルの内容です。

   2. [JIRA へようこそ] ページで、[許可] をクリックします。

      

   3. [アクセス承認済み] ページで、確認コードを取得します。

      

   4. [統合の追加] ウィザードページに戻り、確認コード パラメーターに取得した確認コードを入力し、[アクセストークンを取得] をクリックします。

      

   5. アクセストークンが取得されました。 というメッセージが表示されたら、[次へ] をクリックします。

   6. [アラートソースの構成] ウィザードページで、次のパラメーターを設定し、[保存] をクリックします。

      パラメーター	説明	例
      プロジェクト	アラートに関する情報が同期される Jira プロジェクトを指定します。	統合監視、管理、および制御プロジェクト
      タイプ	Jira の課題タイプ。有効な値： タスク サブタスク 改善 新機能 バグ エピック ストーリー	バグ
      アラートが無効になっているときの課題のステータス。	課題が解決されたときの Jira 課題のステータス。Jira 課題が指定された状態になると、Jira 課題は解決済みとして識別されます。課題に対応するアラートに対する操作は、課題に同期されません。有効な値： 実行予定 進行中 レビュー中 完了 説明 完了 を選択することをお勧めします。別の値を選択し、課題のステータスが完了に変更された場合でも、課題に対応するアラートに対する操作は引き続き課題に同期されます。	完了
      優先度	アラートの重大度レベルと Jira の課題の優先度のマッピング。 重要 アラートの重大度レベルが課題の優先度にマッピングされていない場合、この重大度レベルのアラートは Jira に同期されません。 アラートが Jira に初めてプッシュされると、重大度レベルは構成したマッピングに基づいて同期されます。重大度レベルが同期された後、重大度レベルのみを変更した場合、変更に関する情報は Jira に同期されません。	P1: 最高 P2: 高 P3: 中 P4: 低 P5: 最低

   構成が完了すると、[通知統合] タブに作成された Jira 統合が表示されます。

Jira にアラートをプッシュする

Jira 統合を追加した後、次の 3 つの方法のいずれかを使用して Jira にアラートをプッシュできます。

方法 1

アラートが生成されたときに Jira で課題を作成する通知ポリシーを構成します。

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

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

3. 通知ポリシー編集ページの [アラートがトリガーされた場合] セクションで、連絡先 パラメーターを指定します。少なくとも 1 つの連絡先または連絡先グループを選択する必要があります。

   重要

   • Jira は、通知ポリシーで指定された最初の連絡先と同じメールアドレスまたは名前 (ユーザー名) を持つユーザーを検索し、そのユーザーを、作成された課題のハンドラーとして設定します。

   • Jira が、通知ポリシーで指定された最初の連絡先に一致するユーザーを見つけられない場合、アラートは Jira にプッシュされません。

4. チケットシステム に作成した Jira 統合を選択します。必要に応じてその他のパラメーターを構成します。詳細については、「通知ポリシーを作成および管理する」をご参照ください。

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

   この方法では、通知ポリシーに一致するアラートが Jira にプッシュされます。

方法 2

[アラートイベント履歴] ページで、アラートを Jira にプッシュし、Jira で課題を作成します。

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

2. [アラート送信履歴] ページの右上隅で、Jira 課題のハンドラーをアラートに関連付け、表示するアラートの名前をクリックします。

   重要

   • Jira は、オペレーターと同じメールアドレスまたは名前 (ユーザー名) を持つユーザーを検索し、そのユーザーを、作成された課題のハンドラーとして設定します。

   • Jira が一致するユーザーを見つけられない場合、アラートは Jira にプッシュされません。

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

4. 表示されるダイアログボックスで、チケットシステム ドロップダウンリストから作成した Jira 統合を選択し、[OK] をクリックします。

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

方法 3

アラートが生成され、指定した DingTalk グループチャットでアラートカードを受信した後、アラートカードを使用してアラートを Jira にプッシュできます。その後、対応する課題が Jira に作成されます。

• DingTalk グループで受信したアラートカードで、[アラートのプッシュ] をクリックし、作成した Jira 統合を選択します。

• アラートカードでアラートの名前をクリックします。アラートの詳細パネルで、[設定] をクリックし、[アラートのプッシュ] をクリックして、作成した Jira 統合を選択します。

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

同期できるアラート関連の操作

上記の手順を完了すると、ARMS のアラートに対する次の操作が Jira に同期されます。

[アラート送信履歴] ページの次の操作は Jira に同期されます。

• アラートを要求する: 要求者は Jira の課題のハンドラーになります。

  説明

  要求者には、Jira に一致するユーザーアカウントが必要です。

• アラートにコメントする: コメントは Jira の課題のコメントに同期されます。

• アラートを解決する: 解決策は Jira の課題のコメントに同期されます。

アラートカードの次の操作は Jira に同期されます。

アラートを要求する: 要求者は Jira の課題のハンドラーになります。

Jira の操作をアラートに同期する

1. ARMS の [統合] ページで、[通知統合] タブをクリックして、Jira の統合キーを取得します。

   

2. Jira チケッティングシステムにログインします。右上隅にある設定アイコンをクリックし、[システム] をクリックします。

   

3. 管理者パスワードを入力し、[OK] をクリックして、システム構成ページに移動します。

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

5. Webhook ページで、[+ Webhook を作成] をクリックします。

   

6. 表示されるページで、URL を http://alerts.aliyuncs.com/api/jira/receiver/{token}/${project.key}/${issue.key} に設定します。{token} は、ステップ 1 で取得した Jira 統合キーに置き換えます。

   

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

   上記の手順を完了すると、Jira の課題に対する次の操作が ARMS のアラート管理に同期されます。

   • 課題のハンドラーを変更する: 対応するアラートのハンドラーが変更されます。

   • 課題にコメントする: コメントは、対応するアラートのコメントに追加されます。