APM アプリケーション エンティティのデプロイメントを記録した後、Webhook を使用してそれらの変更についてチームに常に通知できます。これらは、変更追跡機能を使用してデプロイメントを記録するか、古い REST API を使用して記録するかに関係なく使用できます。
必要な権限
変更追跡通知設定には特定の権限が必要です。
- Webhook の
create
へ:Applied intelligence > Destinations
およびApplied intelligence > Channels
に対するModify
権限。 - Webhook の
view
とtest
へ:Applied intelligence > Destinations
とApplied intelligence > Channels
に対するView
権限。 - Webhook の
modify
へ:Applied intelligence > Destinations
とApplied intelligence > Channels
に対するView
権限、およびApplied intelligence > Destinations
に対するModify
。 - Webhook の
delete
へ:Applied intelligence > Destinations
およびApplied intelligence > Channels
に対するDelete
権限。
Webhook の宛先 URL を取得する
デプロイメント データをさまざまな Webhook 宛先に送信できます。Webhook URL を取得するには、使用しているツールの指示に従ってください。URL を取得したら、次のセクションの手順を実行して Webhook 通知を構成します。
Slack を使用している場合は、ここの手順に従って従来の New Relic アラート アプリを設定します。
- Slackアウカントに管理者としてログインしてから、Appsに進みます。
- New Relic Alertsを検索し、そのタイルをクリックします。
- New Relic Alertsリストで、New Relicアイコンの下にあるConfigurationボタンをクリックします。
- New Relic Alertsの見出しの下にあるConfigurationタブをクリックします。
- Configuration [設定] タブで、鉛筆アイコンをクリックします。
- Webhook URLセクションまでスクロールダウンし、Copy URLをクリックします。
追跡された変更に対する Webhook 通知を構成する
New Relic UI に Webhook URL を挿入します。
デプロイメント通知設定画面に移動します: one.newrelic.com > (ユーザーメニュー) > Administration > Integrations > Deploy notifications。
Webhook URL を Webhook URL フィールドに貼り付け、 Save [保存]をクリックします。
Send a test request [テスト リクエストの送信]をクリックして、人工データを含むサンプル ペイロードを Webhook URL に送信します。
Toggle this webhook [この Webhook を切り替えます] で、トグルをスライドして Webhook 通知を無効または再度有効にすることができます。
Webhook 通知構成を完全に削除するには、 Delete this webhook [この Webhook を削除する] をクリックします。
通知ペイロード構造
デプロイ通知が有効になって変更の追跡を開始すると、Webhook はタイプapplication/x-www-form-urlencoded
のペイロードを持つPOST
リクエストを受信します。キーと値は、キーと値の間に =
記号を入れて、 &
で区切られたキーと値のタプルにエンコードされます。キーと値の両方の英数字以外の文字は URL エンコードされます。
デプロイメントおよびデプロイされた APM アプリケーション エンティティの属性に基づいて、次のキーと値が送信されます。
鍵 | 価値 |
---|---|
作成日 | ISO 8601 形式の展開のタイムスタンプ |
アプリケーション名 | APM アプリケーション エンティティの名前 |
アカウント名 | APM アプリケーション エンティティを所有するアカウントの名前 |
changelog | デプロイメントに含まれる変更のリスト |
description | 導入の説明 |
revision | 導入されたソフトウェアのバージョン |
デプロイメント URL | APM アプリケーション エンティティの展開 UI へのリンク |
デプロイメント済み | アプリケーションをデプロイしたユーザー |