New Relic の Jira連携でアラートのリンクをカスタマイズして快適に

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

# 今回のポイント
この記事で紹介しているポイントは、次の２つです。
1. **アラートの情報をカスタマイズする方法を知る**
 通知するアラートの詳細情報をカスタマイズして連携する方法を紹介します。
2. **Jira連携でアラート内のURLをリンクとして認識させる方法がわかる**
 デフォルトで連携すると文字列そして認識される URL を 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 で検知したアラートの通知先や通知情報の設定は、New Relic Alerts の Workflows で設定が可能です。詳細な設定の手順はこちらのブログを参考にしてください。
 
https://newrelic.com/jp/blog/how-to-relic/new-alert-notification-settings#toc--workflows-

　Workflow の設定で通知メッセージのカスタマイズで使用するのが通知メッセージのテンプレートです。カスタマイズできるのは大きく2点で、アラートに関連している情報を設定できる**変数**と条件に合わせて表示内容を切り替えたり、値を置き換えたりできる**ヘルパー機能**があります。

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

　Workflowで利用できる変数は、下記のドキュメントをご確認ください。

https://docs.newrelic.com/jp/docs/alerts/get-notified/custom-variables-incident-workflows/

　**変数**と**ヘルパー機能**を使ったカスタマイズの例としてアラートが発生した時刻を指定したタイムゾーンで表示する方法があります。こちらの記事で詳細を紹介しているので参考にしてください。

https://qiita.com/ktst79/items/6edc7655b1143e993cc6

# Jira連携でアラート内のURLをリンクとして認識させる方法
## 問題点
　New Relic と Jira の連携は、アラートの通知先としてあらかじめ用意されているため設定は簡単でメッセージテンプレートを使ったカスタマイズにも対応しています。しかし、連携した Issue URL の情報を Jira 上で確認すると文字列で認識されてしまい、リンクとして機能しないためアラートの詳細ページへ飛ぶことができません。これは、Issue URL 限らず、Runbook の URL でも発生する問題です。
![issue-url-string.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/d2a8cedf-ec9d-98ca-baed-ab8d5ddaf394.png)

## 解決策
 Jira の機能を使った簡単な解決策があるため今回はその方法を紹介します。それはカスタムフィールドを使う方法です。使用できる標準のカスタムフィールドの中に **URL フィールド** というタイプがあり、設定された URL をリンクとして表示してくれます。

https://support.atlassian.com/ja/jira-cloud-administration/docs/create-a-custom-field/

## 実践
### Jira の設定_カスタムフィールドの作成
　まず前述のカスタムフィールドを作成していきます。設定から**課題**を選択し、表示された画面の左側のメニューにある**フィールド**から**カスタムフィールド**を選択します。
![Jira_1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/fcfaabba-1f7d-d1a8-16e6-ea121dc49012.png)
表示された画面で**カスタムフィールドを作成**を選択して新しいカスタムフィールドを作成します。
![Jira_2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/824decd8-07c8-d49e-3d0b-2eeb0e9ee17b.png)
フィールドタイプは、前述の通り**URLフィールド**を選択します。
![Jira_3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/61408dc4-a267-d8c9-56de-6db4189c46c3.png)
フィールド名と説明を入力してカスタムフィールドの作成は完了です。
![Jira_4.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/d0967fe8-7709-9386-d362-74e0757af6b1.png)
作成したカスタムフィールドをどの画面に表示するのか選択する必要があります。表示する画面にチェックをつけて**更新**してください。
![Jira_5.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/9a167ef7-3988-c9ae-bfa4-a443b6bc98e2.png)

### Jira の設定_カスタムフィールドの配置
　カスタムフィールドの配置は、下記のように変更が可能です。使いやすい位置に配置してください。
 
 ![customFeild.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/e530223d-bea5-ed38-294e-1c7142c95fea.gif)

　Jira側の設定はこれで完了です。

### New Relic の設定 
 New Relic のメッセージテンプレートで新しく追加したカスタムフィールドに対してURLがマッピングされるように設定していきます。Jira の Workflow 設定画面でメッセージテンプレートの編集を行います。デフォルトでは**説明**のみが表示されていますが、**+ Add another field** で連携するフィールドを新しく追加できます。ここでJiraで作成したカスタムフィールド(**Issue URL**)を選択します。
![Jira_workflow.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/f07a5011-4756-44bc-3720-bfa3918ffe68.png)

　今回は追加した Issue URL に変数 **{{issuePageUrl}}** を設定してテスト実行を行います。
![add_field.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/639c8628-1e90-d921-fbf5-a4eeddd62c97.png)

画面右下の **Send test notification** からテスト送信が可能です。

## 確認
　では連携された内容を Jira の画面上で確認してみましょう。下記のように説明に記載していたURLはリンクとして任視されていませんが、 Issue URL のカスタムフィールドではリンクとして表示されています。これでクリックするだけで New Relic の Issue 詳細画面を開くことができるようになりました。
 ![確認.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3043202/95fb83b8-fa83-522a-e17c-78e583af9072.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)
:::