アラートとアプライド・インテリジェンスの通知統合は、New Relic からの通知を送信するために使用できる特定のサービスとプラットフォームです。
統合内容
それぞれの具体的な通知機能の統合についてはこちらをご覧ください。
New RelicとAtlassian Jira(Cloud)を統合し、Jiraの課題を自動的に作成、更新、クローズすることができます。
権限
重要
この統合は、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ファイルを開いてダウンロードします。このファイルには、イベントをトリガーしてNewRelicに戻すビジネスルールが含まれています。
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ワークスペースには、 NewRelicアプリケーションがインストールされている必要があります。アプリケーションは、ユーザーが個別にインストールする前に、ワークスペース管理者によって承認される必要があります。
プライベートチャンネルには、NewRelicアプリケーションをインストールするための招待状が必要です。
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を形成していない場合は、エラーが表示され、テンプレートを保存することはできません。
ヒント
未定義のタイプエラーは、属性が最近インデックスに登録されていないか、存在しないことを示している可能性があります。エラーを修正するには、
if else
ステートメントを追加してみてください。例えば、"closed_at": {{#if issueClosedAtUtc}} {{ json issueClosedAtUtc }} {{else}}"None"{{/if}}
Webhookペイロードが有効なJSONに準拠している場合は、定義したWebhook宛先にテスト通知を送信できます。
テスト通知を送信して、すべてが正しく接続されていることを確認することをお勧めします。
ユーザーにメールで通知を送る。
メール送信先の設定
メールの宛先を手動で作成する必要はありません。電子メールの宛先を構成すると、宛先が自動的に作成されます。
メール設定
1人または複数の受信者を追加します。
New Relic アカウントを持つユーザーは、名前やメールアドレスを検索する際にオートコンプリートで見つけることができます。
New Relic アカウントやメール配信リストを持っていないユーザーを追加するには、そのユーザーの完全なメールアドレスを入力します。
すべての受信者は、宛先に変換されます。送信先ごとのメール通知は、 notifications-log で確認できます。
テスト通知の送信
テスト通知を送信して、メール通知が受信箱に届くことを確認します。
NewRelicとAWSEventBridgeを使用して、AWS Lambda、Amazon Simple Notification Service(SNS)キュー、CloudWatchLogsなどのターゲットに通知をカスタマイズして配信します。
EventBridgeの宛先を設定します
重要
New Relicは、 SaaSパートナーイベントソースとしてAWSにリストされています。
EventBridgeの宛先を作成するには、 Destinationsに移動し、 AWS EventBridgeをクリックして、次の情報を入力します。
名前:宛先名。
AWSリージョン:これはAWSリージョナルエンドポイントです。イベントソースがホストされている地域を選択します。
AWSアカウントID :AWSアカウントID。これは12桁の数字です。
イベントソースを選択してください
AWSアカウントIDを使用してEventBridgeの宛先を設定したら、新しいイベントソースを作成すると、EventBridgeで利用できるようになります。
宛先名を選択または作成します。
イベントソースを選択または作成します。
新しいイベントソースを作成すると、AWSEventBridgeアカウントに統合パートナーのイベントソースとして作成されます。
AWSアカウントでイベントソースを関連付け、ルールを作成します
イベントソースをイベントバスに関連付けます。 AWS EventBridgeコンソールで、ナビゲーションペインで[Partnerイベントソース]を選択します。
パートナーイベントソースの横にあるボタンを選択し、[イベントバスに関連付ける]を選択します。
イベントソースのステータスが[保留中]から[アクティブ]に変わり、イベントバスの名前がイベントソース名と一致するように更新されます。これで、NewRelicのイベントに一致するルールの作成を開始できます。
イベントバスのルールを作成します。New Relicから送信された通知に対応するには、New-Relicイベントをフィルタリングするイベントパターンを使用してルールを作成する必要があります。
詳細な手順については、イベントソースルールを作成する方法についてこのAWSドキュメントを使用してください。
メッセージイベントテンプレートを構成する
New RelicからEventBridgeに通知を送信する場合、メッセージテンプレートを使用してその通知をカスタマイズできます。次の手順に従って、EventBridge宛先のメッセージテンプレートを構成します。
デフォルトのテンプレートを使用することも、独自のテンプレートをカスタマイズすることもできます。
カスタマイズされたテンプレートが必要な場合は、変数メニューから変数を選択し、ハンドルバー構文を適用してイベントを充実させます。
EventBridgeAPIにはJSONが必要です。 JSONの使用例を参照してください。テンプレートプレビューには、レンダリングされたJSONが表示されます。
イベントテンプレートが有効なJSONに準拠したら、テスト通知をAWSEventBridgeに送信できます。
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.
リストでNewRelic統合を見つけてマークし、 をクリックし 。
右側をクリックして、 統合キーを表示およびコピーします。
PagerDuty のデスティネーションを作成するには、Integration method タブで以下の情報を入力します。