アラートとアプライド・インテリジェンスの通知統合は、New Relic からの通知を送信するために使用できる特定のサービスとプラットフォームです。
統合内容
それぞれの具体的な通知機能の統合についてはこちらをご覧ください。
New RelicとAtlassian Jira(Cloud)を統合し、Jiraの課題を自動的に作成、更新、クローズすることができます。
アクセス権限
Jira API-Token
から必要なパーミッションは、 BROWSE_PROJECTS
, ASSIGN_ISSUES
, CLOSE_ISSUES
, CREATE_ISSUES
, EDIT_ISSUES
, RESOLVE_ISSUES
, TRANSITION_ISSUES
, USER_PICKER
, ADD_COMMENTS
です。
双方向の同期トグルを有効にするには、提供された Jira API-Key
が Admin
ロールを持っている必要があります。
Jiraのデスティネーションを設定する
Jiraの課題を作成し、JiraとNew Relicが更新情報を共有し、同期をとるようにします。
Jiraのデスティネーションを作成するには、以下の情報を入力します。
デスティネーション名: デスティネーションを識別するためのカスタム名。
Jiraアカウントのエンドポイント: 送信先のURLです。
ユーザー名: ユーザーの電子メールアドレスです。
API トークン: アトラシアンアカウントから生成されたものです。
重要
New Relic は現在、 Atlassian-Jira Classic (企業が管理する)プロジェクトをサポートしています。.
宛先を保存する前に、 Test connection ボタンを使って接続をテストすることをお勧めします。
2ウェイ・シンク
双方向の同期はワークフローに適用されます。これを有効にするには、 2-way integration トグルをオンにします。
オンにすると、選択したプロジェクトについて、後の段階で Jira アカウントに Jira Webhook が作成されます。Webhook には、New Relic へのアクセス詳細 (URL および API キー) が含まれます。
NewRelicのワークフローとの同期
New Relic 課題のクローズは、JIRA 課題のステータスが完了に変わったときに発生します。
JIRA 課題のステータスが進行中に変更されると、New Relic 課題の確認が行われます。
メッセージテンプレートの設定
Jira課題のテンプレートを設定するには、以下の手順で行います。
デスティネーションを選択します。この段階で新しい目的地を作ることができます。
接続先への接続が成功したら、プロジェクトを選択し、使用したいJiraの課題タイプを選択します。
課題タイプが選択されると、設定されたプロジェクトのフィールドがアカウントから取得され、Jiraインスタンスに自動的にマッピングされます。
お客様にご利用いただくために、必須項目、推奨項目、値を自動的に入力しています。必須項目は必ず値を設定してください。任意のフィールドは、その右側にある
X
マークを使って、追加または削除することができます。Jiraのメッセージテンプレートです。
テスト通知の送信
デフォルトのフィールド値でテスト通知をクリックすると、JIRA課題がどのように表示されるかを確認できます。
成功すると、JIRAの課題が作成され、リンクが表示されます。
New RelicとServiceNow Incident-Managementを統合し、ServiceNowのインシデントを自動的に作成、更新、解決することができます。
役割
統合の一環として、ServiceNowのインシデントテーブルからフィールドを取得し、その他のオプション値も取得します。以下のパーミッションが必要です。
sys_dictionary
,sys_choice
,sys_user
, andtask
のテーブルに対する読み取り権限を持つ。Read/Write permission to
incident
.caller
カラムのユーザーを取得するには、sys_user
テーブルの読み取り権限が必要です。ロール
personalize_choices
,personalize_dictionary
,rest_service
,itil
は、上記のパーミッションを持っています。双方向の統合を可能にするためには、
api_key_credentials
テーブルに対する読み取り/書き込み権限が必要です。credentials_admin
とdiscovery_admin
のロールがこれを提供します。デスティネーションの設定
ServiceNowのデスティネーションを作成するには、以下の情報を入力します。
デスティネーション名: デスティネーションを識別するためのカスタム名。
ドメイン: 送信先のURLです。
User-name: ユーザーの名前です。
パスワード: ユーザーのパスワードです。
デスティネーションを保存する前に、 Test connection ボタンをクリックして、接続をテストすることをお勧めします。
2ウェイ・シンク
双方向の統合を設定するには
2ウェイ統合
トグルをオンにします。この XML ファイル を開いてダウンロードすると、ビジネスルールのトリガーとなるイベントが New Relic One に戻ってきます。
ServiceNowのサイドバーメニューで、 System Definition> Business Rules を選択します。
いずれかのコラムヘッダーのメニューアイコンをクリックし、 Import XML を選択し、ダウンロードしたXMLファイルをアップロードします。
宛先が保存されると、New Relic API キーが
api_key_credentials
に保持されます。このキーは、New Relic へのコールバック REST 呼び出しの一部としてヘッダーで送信されます。ワークフローとの同期
ServiceNowのインシデントの状態が解決済みに変更されると、New Relicの問題のクローズがトリガーされます。
New Relic Issueの確認は、Servicnowのインシデントの状態がオープンから変更されたときに発生します。
メッセージテンプレートの設定
接続が成功すると、ServiceNowのインシデントテーブルのカラムがアカウントから取得され、自動的にServiceNowインスタンスにマッピングされます。
お客様にご利用いただくために、必須項目、推奨項目、値を自動的に入力しています。必須項目は必ず値を設定してください。任意のフィールドは、その右側にある
X
マークを使って、追加または削除することができます。ServiceNow-Incidentテンプレートのフィールドを選択、編集または削除します。
テスト通知の送信
Test notification をクリックすると、デフォルトのフィールド値を持つServiceNowインシデントが表示されます。成功すると、インシデントが作成され、リンクが表示されます。
Slackのチャンネルに通知メッセージを送信します。
前提条件
Slack ワークスペースには、 New Relic アプリケーション がインストールされている必要があります。このアプリケーションをユーザーが個別にインストールするには、ワークスペースの管理者による承認が必要です。
Slackの宛先を設定する
ワンクリックSlack認証 をクリックしてSlackのランディングページに移動し、OAuth2認証プロセスを続行します。必要なワークスペースにサインインしていない場合は、Slack にリダイレクトされてサインインします。
ワークスペース名を追加するか、関連するワークスペースを選択して、 「続ける」 をクリックします。
選択したワークスペースにサインインしている場合、New Relic が指定されたアクションを実行することを許可します。
Allow をクリックすると、目的のページに戻ります。
Slackのメッセージ設定
宛先(ワークスペース)と、メッセージを送信するslackチャンネルを選択します。必要なワークスペースにあらかじめ定義された送信先がない場合は、新しい送信先を作成することができます。なお、プライバシー保護のため、プライベート・チャンネルを選択するには、ユーザーが一度認証を受ける必要があります。
テスト通知の送信
あらかじめ定義された例のペイロードを持つテスト通知をチャンネルに送信することができます。これにより、選択したslackチャンネルにメッセージが作成されます。
Webhook Notifierを使って、任意のエンドポイントに通知メッセージを送信します。
Webhookの宛先を設定する
Webhookの宛先を作成するには、以下のものが必要です。
デスティネーション名: 固有のデスティネーション名。
URLです。 対象となるアプリケーションのエンドポイントで、必要に応じて認証やカスタムヘッダーも含まれます。
Authorization mechanism (Optional):.
ベーシック認証
またはベアラートークン
とすることができます。Webhookイベントテンプレートの設定
Webhookの宛先をリストから選び、
HTTP-POST
リクエストを設定します。リクエスト設定では、以下のことが求められます。
テンプレートの名前を設定します。
あらかじめ設定されている目的地を目的地リストから選択するか、新しい目的地を作成します。
カスタムヘッダーの追加(オプション)。
リクエストのペイロードを設定します。
Webhookペイロードのカスタマイズ
デフォルトのペイロードを使用することも、必要なデータを含むようにカスタマイズすることもできます。 variablesメニュー から変数を選び、 handlebars構文 を適用して、Webhookを充実させます。
リクエストのcontent-typeはデフォルトでJSONであることに注意してください。したがって、ペイロードはJSONである必要があります。 使用例 を参照してください。
右側の プレビュー セクションには、テンプレートがレンダリングされた後に予想されるペイロードが表示されます。ペイロードが有効なJSONを形成していない場合は、エラーが表示され、テンプレートを保存することはできません。
Webhookペイロードが有効なJSONに適合していれば、定義したWebhook宛先にテスト通知を送信できます。
テスト通知を送信して、すべてが正しく接続されていることを確認することをお勧めします。
ユーザーにメールで通知を送る。
メール送信先の設定
メールの送信先を手動で作成する必要はありません。ワークフローの起動時や更新時に自動的にメール送信先が作成されます。
メール設定
1人または複数の受信者を追加します。
New Relic アカウントを持つユーザーは、名前やメールアドレスを検索する際にオートコンプリートで見つけることができます。
New Relic アカウントやメール配信リストを持っていないユーザーを追加するには、そのユーザーの完全なメールアドレスを入力します。
すべての受信者は、宛先に変換されます。送信先ごとのメール通知は、 notifications-log で確認できます。
テスト通知の送信
テスト通知を送信して、メール通知が受信箱に届くことを確認します。
New Relic と PagerDuty を統合し、PagerDuty のインシデントを自動的に作成、更新、確認、解決することができます。
New Relic では、PagerDuty との統合に 2 つの方法があります。
REST API キーを使用したアカウントレベルの統合(推奨) : 統合は完全に自動化されており、双方向の同期をサポートし、単一の New Relic デスティネーションに複数の PagerDuty サービスを定義することができます。
Events API キーを使用したサービスレベル統合 : シングルサービス統合では、サービスレベル統合キーを使用しており、固有の PagerDuty サービスごとに個別の New Relic デスティネーションが必要となります。
アカウントレベルの統合
統合は完全に自動化されており、双方向の同期をサポートし、1つのNew Relicデスティネーションに複数のPagerDutyサービスを定義することができます。
アクセス権限
この統合には、以下のアクションを実行する権限が必要です。
この統合には、REST API キーが必要です。PagerDuty には 2 種類の REST API キーがあります。
一般アクセスキー: 上記のすべての権限が含まれており、PagerDutyの管理者とアカウント所有者が取得できます。 PagerDutyの説明書をご覧ください.
パーソナルユーザートークン: お客様のアカウントに高度な権限がある場合、固有のパーソナルREST APIキーを作成することができます。個人用REST APIキーを使用して行われたリクエストは、ユーザーのパーミッションに制限されます。ユーザートークンAPIキーを提供することを選択した場合、それが上記の必要なパーミッションを持っていることを確認してください。 PagerDutyの説明書をご覧ください.
デスティネーションの設定
PagerDuty のデスティネーションを作成するには、Integration method タブで以下の情報を入力します。
Name: 目的地を特定するためのカスタム名。
APIキー: このインテグレーションでは、REST APIキーの提供を求められます。
PagerDuty の REST API キーには、 一般アクセス と ユーザートークン の 2 種類があります。
デスティネーションを保存する前に、 Test connection ボタンをクリックして、接続をテストすることをお勧めします。
2ウェイ・シンク
双方向の同期を有効にするには、 双方向の統合 のトグルをオンにします。
オンにすると、選択した PagerDuty サービスに対して、後から PagerDuty のサブスクリプションが作成されます (See customize a message template)。Webhook には、New Relic へのアクセス詳細 (URL および New Relic API キー) が含まれます。
デフォルトでは、New Relicによって作成されたPagerDutyインシデントへの状態の変更は、NewRelicに同期されます。
重要
双方向同期は、PagerDutyインテリジェントアラートグループ化と完全には互換性がありません。関連するPagerDutyサービスのインシデントグループ化をオフにするか、NewRelicで双方向同期を無効にすることをお勧めします。New Relicのワークフローとの同期
PagerDuty のインシデントが解決されると、New Relic issue の閉鎖がトリガーされます。
PagerDuty のインシデントが承認されると、New Relic のインシデントの承認がトリガーされます。
メッセージテンプレートの設定
メッセージテンプレートを設定するには
デスティネーションを選択します。この段階で新しい目的地を作ることができます。
PagerDutyのサービスを選択します。
ユーザーを選択します。選択したユーザーに代わって、New Relic がノートを投稿します。
なお、PagerDuty Alertsのカスタム詳細は自動的に入力されます。
テスト通知の送信
デフォルトのフィールド値でテスト通知をクリックすることで、PagerDutyのインシデントがどのように表示されるかを確認できます。成功すると、インシデントが作成され、リンクが表示されます。
サービスレベルの統合
この統合には、New Relic にインシデントを作成させたいサービスに、New Relic PagerDuty の統合を設定する必要があります。
PagerDuty のサービスに New Relic のインテグレーションを作成します。
Services Service Directory にアクセスし、統合を追加したいサービスを選択します。
Integrations タブを選択 Add another integration.
右をクリックすると、 統合キー が表示され、コピーされます。
PagerDuty のデスティネーションを作成するには、Integration method タブで以下の情報を入力します。