アラートとアプライド・インテリジェンスの通知統合は、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 トークン: アトラシアンアカウントから生成されたものです。
宛先を保存する前に、 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の課題が作成され、リンクが表示されます。
NewRelicをServiceNowITSMと統合し、ServiceNowインシデントを自動的に作成、更新、解決します。
役割
統合の一環として、ServiceNowのインシデントテーブルからフィールドを取得し、その他のオプション値も取得します。以下のパーミッションが必要です。
テーブル
sys_dictionary
、sys_choice
、sys_user
、およびtask
の読み取り権限。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ウェイ・シンク
双方向の統合を設定するには
two-way integration
トグルをオンにします。この XML ファイル を開いてダウンロードすると、ビジネスルールのトリガーとなるイベントが New Relic One に戻ってきます。
ServiceNowのサイドバーメニューで、 System Definition> Business Rules を選択します。
いずれかのコラムヘッダーのメニューアイコンをクリックし、 Import XML を選択し、ダウンロードしたXMLファイルをアップロードします。
宛先が保存されると、NewRelicAPIキーは
api_key_credentials
に保持されます。キーは、NewRelicへのコールバックREST呼び出しの一部としてヘッダーで送信されます。ワークフローとの同期
ServiceNowのインシデントの状態が解決済みに変更されると、New Relicの問題のクローズがトリガーされます。
New Relic Issueの確認は、Servicnowのインシデントの状態がオープンから変更されたときに発生します。
メッセージテンプレートの設定
接続が成功すると、ServiceNowのインシデントテーブルのカラムがアカウントから取得され、自動的にServiceNowインスタンスにマッピングされます。
開始しやすいように、必須フィールドと推奨フィールドにはデフォルト値が事前に入力されています。
サポートされているフィールドにカスタム値を追加する場合、課題ペイロードから動的な値を追加するか、独自の値を書き込むことができます。
不要なフィールドを削除して、独自のフィールドを追加できます。
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です。 対象となるアプリケーションのエンドポイントで、必要に応じて認証やカスタムヘッダーも含まれます。
承認メカニズム(オプション):。
basic authentication
、OAuth 2.0
、またはbearer token
にすることができます。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 のインシデントを自動的に作成、更新、確認、解決することができます。
PagerDutyと統合する方法は2つあります。
REST API キーを使用したアカウントレベルの統合(推奨) : 統合は完全に自動化されており、双方向の同期をサポートし、単一の New Relic デスティネーションに複数の PagerDuty サービスを定義することができます。
イベントAPIキーを使用したサービス統合:単一のサービス統合はサービスレベル統合キーを使用し、一意のPagerDutyサービスごとに個別のNewRelic宛先が必要です。
アカウントレベルの統合
統合は完全に自動化されており、双方向の同期をサポートし、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に同期されます。
重要
特定のサービスでIntelligentAlertGroupingを使用しているPagerDutyEventIntelligenceまたはDigitalOperationsのお客様の場合、NewRelicに返送されるPagerDutyインシデントに不一致が生じる可能性があることに注意してください。New Relicのワークフローとの同期
PagerDuty のインシデントが解決されると、New Relic issue の閉鎖がトリガーされます。
PagerDuty のインシデントが承認されると、New Relic のインシデントの承認がトリガーされます。
メッセージテンプレートの設定
メッセージテンプレートを設定するには
デスティネーションを選択します。この段階で新しい目的地を作ることができます。
PagerDutyのサービスを選択します。
ユーザーを選択します。選択したユーザーに代わって、New Relic がノートを投稿します。
なお、PagerDuty Alertsのカスタム詳細は自動的に入力されます。
テスト通知の送信
デフォルトのフィールド値でテスト通知をクリックすることで、PagerDutyのインシデントがどのように表示されるかを確認できます。成功すると、インシデントが作成され、リンクが表示されます。
サービス統合
この統合では、NewRelicでインシデントを作成するサービスにNewRelicPagerDuty統合を設定する必要があります。
PagerDuty のサービスに New Relic のインテグレーションを作成します。
Services Service Directory にアクセスし、統合を追加したいサービスを選択します。
Integrations タブを選択 Add another integration.
PagerDuty のデスティネーションを作成するには、Integration method タブで以下の情報を入力します。