New Relic のアラートと Jira の双方向連携の動作を確認してみた

　New Relicで検知したアラートは、メールやSlack、Jira、PagerDuty 等に連携することができます。今回はアラートの情報を Jira に双方向で連携した際の動作について紹介します。

# 今回のポイント
この記事で紹介しているポイントは、次の２つです。
1. **New Relic のアラートと Jira の双方向に連携させる方法を知る**
 Jira連携の双方向連携（Two-way sync）を設定する方法を紹介します。
2. **双方向連携（Two-way sync）を有効にした際、どのような動作になるのかがわかる**
 JiraとNew Relicでの操作がどのように反映されるのかを紹介します。

:::note info
最新のアップデートの詳細はこちら
[New Relic アップデート一覧
](https://newrelic.com/jp/blog/nerdlog/new-relic-update  "New Relic アップデート一覧")
:::

:::note info
無料のアカウントで試してみよう！
[New Relic フリープランで始めるオブザーバビリティ！](https://qiita.com/ktst79/items/5ee74b34e6adb8a7a6fa)
:::

# New Relic のアラートと Jira の双方向に連携させる方法
　New Relic で検知したアラートの通知先や通知情報の設定は、New Relic Alerts の Destinations で設定が可能です。詳細な設定の手順はこちらのブログを参考にしてください。
 
https://newrelic.com/jp/blog/how-to-relic/new-alert-notification-settings#toc--destinations-

　Destination の設定で **Two-way integration** のトグルをオンにするだけで有効化されます。

https://docs.newrelic.com/jp/docs/alerts/get-notified/notification-integrations/#jira
 
![Two-way.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/17f23835-42d2-53ee-be59-8b9fa0ef2010.png)

有効化して保存すると Destinetions の一覧画面で下記のように Two-way integration が表示されます。
![list.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/78df2c3e-b0a4-ebbc-5f7b-26a081133533.png)

# 双方向連携（Two-way sync）を有効にした際の動作
　Jira と New Relic 連携の Two-way sync は、New Relic 上の issue のステータスとJiraの課題のステータスが同期する機能です。双方向に同期できるため、どういった変更を行なった際にどのように動作するのかを確認していきます。
 
https://docs.newrelic.com/jp/docs/alerts/get-notified/notification-integrations/#two-way-sync-workflows

New Relic のアラートが連携された際の Jira の課題の初期表示は、下記のように「 **To Do** 」になっています。
![Jira-issue.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/76b51bc2-6926-940d-b827-41235d205373.png)

## New Relic で変更した場合
### Acknowledge を選択
　New Relic の Issue で Acknowledge を選択する際の動作です。
<img width="500" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/d05069a3-0350-9d25-2592-adbe4fc2e54d.png"></br>
選択するとステータスが変更されます。
<img width="500" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/544061cd-9138-1946-afb5-4c2e9fe9e7be.png">

Jira の課題を見るとステータスは変更されず、「 **To Do** 」のままです。
![Jira課題-Acknowledge.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/76b51bc2-6926-940d-b827-41235d205373.png)

###  Close Issue を選択
　New Relic の Issue で Close Issue を選択する際の動作です。
<img width="500" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/c34b43d6-3e35-21bb-d8dc-d164e518b4f0.png"></br>
選択するとステータスが変更されます。
<img width="500" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/ca8dcd16-bd24-c15b-6abe-8076bc2a6f8c.png">

Jira の課題のステータスは変更されて、「 **完了** 」に変更されています。
Closeした担当者は未割り当てのままになっています。
![Jira課題-Close.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/f2070581-87a9-332c-6321-da5c8d6d3cf3.png)

## Jira で変更した場合
### 進行中 に変更
　Jira の 課題 で ステータスを「 **進行中** 」に変更した際の動作です。
<img width="500" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/3501f31c-f988-6ebc-4cfa-b1d8f25ac560.png">

New Relic の Issue の詳細を見るとステータスが変更されています。
![NewRelicIssue-Acknowledge.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/20093768-c4c9-2cba-14d6-32f0c5f624e7.png)

###  完了 を選択
　Jira の 課題 で ステータスを「 **完了** 」に変更した際の動作です。
<img width="500" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/5d03f296-48be-b995-5cec-b52ec557f29f.png">

New Relic の Issue の詳細を見るとステータスが「 **Close** 」に変更されています。
![NewRelicIssue-Done.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/b79c5cd1-8d81-2d21-022a-bac7592eb4df.png)


## まとめ
### ステータス変更の動作
双方向連携（Two-way sync）のステータス変更状況は下記の通りです。
* **New Relic 上で変更**
Acknowledge : ❌ **Jira に反映されない**
Close : Jira のステータスが **Done になる**
* **Jira 上で変更**
進行中 : New Relic のステータスが **Acknowledged になる**
完了 : New Relic のステータスが **Closed になる**

### どう運用するのが良いか
　今回の動作で New Relic 上での変更が Jira に反映されていないことがわかるため、ステータスは Jira 上で変更する運用が良さそうです。New Relic の Issue 画面からJira の画面でリンクされているので New Relic から Jira の課題ページを表示することができます。NotifiedのJiraのアイコンにカーソルを合わせるとツールチップでリンク情報が表示されて **Open in jira** から課題ページが表示できます。
![JiraOpen.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/f1ce1b2c-0116-5108-5d5c-41387b11d736.png)


# 最後に
　New Relic で検知したアラートを管理して対応していくことはシステムの運用上大変重要です。通知後にJira等のツールをどのように活用していくかを実際の動作と合わせて検討することで運用効率を向上させることができます。

　New Relicでは、**新しい機能やその活用方法**について、QiitaやXで発信しています！
**無料でアカウント作成**も可能なのでぜひお試しください！

:::note info
New Relic株式会社の[X(旧Twitter)](https://x.com/NewRelicJapan) や [Qiita OrganizationOrganization](https://qiita.com/organizations/newrelic)では、
新機能を含む活用方法を公開していますので、ぜひフォローをお願いします。
:::

:::note info
無料のアカウントで試してみよう！
[New Relic フリープランで始めるオブザーバビリティ！](https://qiita.com/ktst79/items/5ee74b34e6adb8a7a6fa)
:::
[![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/535230/66d6a010-e4fe-4004-a09b-c01eaad5a614.png)](https://newrelic.com/jp/contact-sales)