New Relic の Errors inbox と Jira を連携させてエラーのトラッキングを効率化！

　New Relic の APM や Browser 等で検知したエラーまとめて管理できる Errors inbox と Jira を連携させることでエラーを捕捉し、簡単にチケットを作成して修正に取り掛かることができます。今回は Errors inbox の情報を Jira に連携する方法について紹介します。

# 今回のポイント
この記事で紹介しているポイントは、次の２つです。
1. **New Relic の Errors inbox の情報を Jira に連携する方法がわかる**
 New Relic の Errors inbox と Jira を連携させてアプリケーションで発生したエラーの対応チケットを作成する方法を紹介します。
2. **Jira と連携する情報のカスタマイズ方法がわかる**
 Jira へ連携されるフォーマットをカスタマイズしてエラーの対応チケットの内容をわかりやすくする方法を紹介します。

:::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 の Errors inbox の情報を Jira に連携する方法
## 連携の準備
　New Relic の Errors inbox と Jira を連携させるには、事前に下記2つの準備が必要です。
　1. Jiraの認証情報の設定： destinationの設定
　2. 連携内容の設定： Templateの設定

### New Relic の Destination の設定
　Destination の設定は、New Relic の Alert で使用する destination と同じ設定を使用できるため、Alert ですでに設定している場合は新しく設定する必要がありません。

https://docs.newrelic.com/jp/docs/alerts/get-notified/notification-integrations/#set-up-jira

　Errors inbox で新しく destination を追加する際は、Errors inbox の画面に表示されている Jira のアイコンから **Add JIRA Workspace** を選択すると destination の設定画面が表示されます。
![APM.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/8e42c555-72df-aded-dc8f-481b4f8ca55e.png)

![destination.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/4326e7d1-32e9-7965-4882-c49002753bce.png)

下記の項目を入力した設定してください。
**Name:** 宛先を識別するための名称
**URL:** 連携先の Jira 環境 URL
**Username:** ユーザーの電子メールアドレス
**API token:** Atlassian アカウントで発行したAPIトークン

APIトークンを発行する手順は、[こちらのドキュメント](https://support.atlassian.com/ja/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)を参考にしてください。

https://support.atlassian.com/ja/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/

### Template の設定
　次に連携用のTemplateを作成していきます。Jira のアイコンから **Add New Template** を選択すると設定画面が表示されます。
![Template作成.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/a90c355f-64c0-221a-14ef-9c58e91b96b8.png)

　destination から順で選択していく形式で、選択すると Project や Issue type 等の情報をJiraの環境から取得してくるので選択しましょう。要約や説明等のカスタマイズについては、後ほど紹介します。
![template詳細.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/ca4bed4f-6ac3-5965-efa4-a3b78fa13a6c.png)

デフォルトでNew Channelが入力されているチャネル名は、Template選択時のTemplate名になるため識別できる名称をつけておいた方が良いです。
![チャネル名.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/76777acd-92a2-b70b-ace0-4f068e5fef48.png)
![チャネル名_選択.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/2aba662a-181f-bfac-8f37-915878d57da7.png)

設定ができたら **Send test notification** でテスト送信を行います。連携に問題がなければ、下記のようにJiraにチケットが作成されます。

![Jira.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/2c7bc12c-703b-d633-6072-8e97cdf3a462.png)

ここまで確認して設定が保存できたら準備は完了です。

## Error Group の情報を Jira に連携してみる
　Errors inbox の Jira連携は、アラートとは異なりError Groupが作成されて自動的に Jira のチケットが作成させるわけではありません。どの Error Group の対応を行うのか Errors inbox で**自分で選んで対応するためのチケットを作成する**必要があります。
### 情報を連携してJiraのチケットを作成する
Errors inbox の Jira のアイコンから作成済み Template を選択します。
![Templateの選択.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/d9e4cff0-47e2-dde8-7c6a-92052dbcaff1.png)

Jiraにチケットを作成するための確認画面が表示されるので内容に問題がなければ **Confirm** を選択します。
![チケット作成の確認.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/767b81da-d5ba-a327-2eaa-1de890843e10.png)

これだけで Jira のチケットが作成されます。

### 連携状況の確認
　実際に作成されたチケットを確認していきましょう。連携できるとJiraのアイコンがグレーから青に変わります。
![連携ステータス.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/bad9068b-2f10-1798-e782-fe0aeeb4605b.png)
このアイコンを選択するとJiraのチケットへのリンクが表示されるため、わざわざJiraの画面を開いてき表されたチケットを探す必要はありません。
![チケットへのリンク.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/8b143761-8bbc-d1d6-fa22-98b9d3a54ee6.png)
リンクからJiraのチケットを開くとTemplateで設定した内容に合わせてチケットが作成されています。
![作成されたチケットの確認.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/c5cb2ecc-788c-14b9-1624-7b8129d28b33.png)

連携の準備からチケットの作成・確認まではこれで終了です。

### 注意！
　New Relic Alert と Jira の連携には双方向に連携する仕組みが用意されていますが、**Errors inbox の Jira連携では双方向の連携に対応していません。**

https://qiita.com/MarthaS/items/8444b66dd5093c6531df

:::note alert
 そのため、Error Group のステータスを **Resolve** に変更しても Jira のステータスが**完了**になることはないし、Jira のステータスを**完了**にしても Error Group のステータスが **Resolve** になることはありません。
:::

## Jira と連携のカスタマイズ方法
　連携をカスタマイズする方法は大きく2つあります。この2つの方法についてそれぞれ紹介します。
1. 変数を使って連携する情報をリッチにする方法
1. Jiraのカスタムフィールドを使って情報にアクセスしやすくする方法
### 変数を使って情報をリッチにする
Errors inbox の連携でも変数を使用することができます。

https://docs.newrelic.com/jp/docs/alerts/get-notified/message-templates/

要約や説明に `{{` を入力すると補完機能で設定可能な変数が表示されます。Alertに比べると少ないですが、Error Group に関連した情報を設定することが可能です。
![変数.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/39ed04f1-e317-109e-5b74-94a93f1707e7.png)

また、Handlebarsの構文にも対応しているため、簡単な条件指定も設定が可能になっています。


### Jiraのカスタムフィールドを使って情報にアクセスしやすくする
　Jira のカスタムフィールドを使ってカスタマイズする方法も有効です。以前リンクをURLとして認識させるためにカスタムフィールドのデータ型を使って対応する方法を紹介しています。

https://qiita.com/MarthaS/items/28f0cb95e2a3435bb844

Error Group のリンク情報は、とても長いためこの方法を使ってワンクリックでアクセスできるようにしておくのが良いです。
![ErrorGroupLink.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/65af5e50-e7eb-60f2-5c89-e06beff5e7f1.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)