デプロイメントの記録と表示

アプリのデプロイは危険なイベントになる可能性があります。アプリが破損および不適切なデプロイメントが原因である場合がよくあります。New Relicを使用すると、デプロイメントを追跡できるため、デプロイメントをアプリのパフォーマンスの変化に関連付けできます。デプロイメントを追跡すると、APMチャートとダッシュボードに表示されるデプロイメントマーカーが作成されます。

この短いビデオ（4分30秒）で、デプロイメントマーカーがどのように機能するかをご覧ください。

デプロイメント追跡のオプション

New Relic REST API v2を使用すると、新しいデプロイメントを記録し、過去のデプロイメントリストを取得できます。さらに、一部のAPMエージェントには、デプロイメントを自動的に記録するエージェント固有の方法があります。

New Relicでスラックインテグレーション、または単純なwebhookを使用して、APMがモニターしているアプリケーションのデプロイメントをチームにリアルタイムで通知できます。スラックは、選択されたスラックチャネルにフォーマットされて表示される汎用JSONを投稿できるwebhook URLを提供します。

記録された後に、New Relic UIでデプロイメントを表示できる場所がいくつかあります。

• APM概要、サービス概要、エンティティの概要ページのアクティビティフィード。
• APMパフォーマンスチャートでは、チャートマーカー（ピンヘッド付きの縦線）として表示されます。
• ダッシュボードチャートでは、チャートマーカーとして表示されます。
• パフォーマンスの概要については、デプロイメントページに表示されます。

REST APIによるデプロイメントの記録

New Relic REST API v2を使用して、デプロイメントを記録、過去のデプロイメントのリストを取得できます。

• このドキュメントの例では、コマンドラインツールとしてcurlを使用しています。ただし、RESTリクエストには任意の方法を使用できます。デプロイメントの作成および表示は、APIエクスプローラーでもできます。
• JSONは、要素名とコンテンツにダブルクォート"を使用します。シングルクォート'の使用は、エラーの原因となります。

curl -X POST "https://api.newrelic.com/v2/applications/$APP_ID/deployments.json" \
     -H "Api-Key:$API_KEY" \
     -i \
     -H "Content-Type: application/json" \
     -d \
'{
  "deployment": {
    "revision": "REVISION",
    "changelog": "Added: /v2/deployments.rb, Removed: None",
    "description": "Added a deployments resource to the v2 API",
    "user": "datanerd@example.com",
    "timestamp": "2019-10-08T00:15:36Z"
  }
}'

Invoke-WebRequest -Uri https://api.newrelic.com/v2/applications/YOUR_APP_ID/deployments.json -Method POST -Headers @{'Api-Key'='$API_KEY'} -ContentType 'application/json' -Body '{
    "deployment": {
    "revision": "REVISION",
    "changelog": "Added: /v2/deployments.rb, Removed: None",
    "description": "Added a deployments resource to the v2 API",
    "user": "datanerd@example.com",
    "timestamp": "2019-10-08T00:15:36Z"
}
}'

$encoding = [System.Text.Encoding]::GetEncoding("ASCII")
$data ='{
"deployment": {
    "revision": "REVISION",
    "changelog": "Added: /v2/deployments.rb, Removed: None",
    "description": "Added a deployments resource to the v2 API",
    "user": "datanerd@example.com",
    "timestamp": "2019-10-08T00:15:36Z"
}
}'
$postData = $encoding.GetBytes($data)
$request = [System.Net.WebRequest]::Create('https://api.newrelic.com/v2/applications/$APP_ID/deployments.json')
$request.Method = 'POST'
$request.Headers.add('Api-Key','$API_KEY')
$request.ContentType='application/json'
$stream = $request.GetRequestStream()
$stream.Write($postData,0,$postData.Length)
$request.GetResponse()

curl -X GET "https://api.newrelic.com/v2/applications/$APP_ID/deployments.json" \
     -H "Api-Key:$API_KEY" \
     -i

curl -X GET "https://api.newrelic.com/v2/applications/9999999/deployments.json" \
     -H "Api-Key:ABCDEFGHIJKLMNOPQRSTUVWXabcdefghijklmnopqrstuvwx" \
     -i

HTTP/1.1 200 OK
ETag: "ABCDEFGHIJKabcdefghijk0123456789"
Cache-Control: max-age=0, private, must-revalidate
Content-Type: application/json
{
  "deployments": [
    {
      "id": 1234567,
      "revision": "1234123412341234123412341234123412341234",
      "changelog": "Fixed the bugs for real this time",
      "description": "Example description two",
      "user": "Data Nerd",
      "timestamp": "2016-02-24T10:09:27-08:00",
      "links": {
        "application": 9999999
      }
    },
    {
      "id": 2345678,
      "revision": "7890789078907890789078907890789078907890",
      "changelog": "Think I fixed all the bugs",
      "description": null,
      "user": "Dren Atad",
      "timestamp": "2014-10-22T12:23:47-07:00",
      "links": {
        "application": 9999999
      }
    }
  ],
  "links": {
    "deployment.agent": "/v2/applications/{application_id}"
  }
}

New Relicエージェントを使用したデプロイメントの記録

一部のエージェントには、デプロイメントを記録する追加メソッドがあります。

• 全セグメント: New Relic REST API v2を使用します。
• C: SDK固有のメソッドではありません。REST APIを使用します。
• Go: エージェント固有のメソッドではありません。REST APIを使用します。
• Java：Javaエージェントjarを呼び出します。
• .NET: PowerShellとREST APIを使用します。
• Node.js：エージェント固有のメソッドではありません。REST APIを使用します。
• PHP: PHPスクリプトを使用します。
• Python：newrelic-adminスクリプトのrecord-deployサブコマンドを使用します。
• Ruby: Capistranoレシピを使用します。

チームにデプロイメントを通知

REST APIを使用してデプロイメントを記録した後、オプションでデプロイメントのwebhookエンドポイントに通知できます。

webhookの宛先は、スタックインスタンスにできます。webhookを使用して、スラックチャネルのデプロイメント通知を設定する場合は、以下の手順に従います。

1. スラックアウカントにアドミンとしてログインしてから、アプリディレクトリ > 管理 > アプリの順に進みます。
2. New Relicアプリを検索してから、設定を追加を選択します。
3. チャネルへ投稿から、既存のスラックチャネルを選択または新しいチャネルを追加してから、設定を追加を選択します。
4. オプションのリストから、webhookのURLをコピーします。
5. one.newrelic.com >（user menu）> Account settings > Integrations > Deploy notifications > Webhookに移動します。
6. スラックwebhook URLをペーストしてから、保存します。
7. オプション: テストメッセージを送信します。

デプロイメント詳細の表示

デプロイメント情報を設定すると、詳細を表示してドリルダウンできます。

1. one.newrelic.com > All capabilities > APM & services >（アプリを選択）> Events > Deploymentsの順に移動します。
2. New Relicの標準的なユーザーインタフェース機能のいずれかを使用して、詳細情報にドリルダウンします。
3. 特定のイベントの詳細を表示するには、そのdateリンクを選択します。
4. このデプロイメントのエラーページを表示するには、errorリンクを選択します。
5. 特定のデプロイメントの詳細を表示するには（該当する場合）、Change logまたはChange reportを選択します。

Change logには、デプロイメントの記録時にchangelogパラメーターから提供された詳細が含まれます。Change reportには、デプロイメント前後の上位10件のトランザクションの動作が表示されます。

デプロイメント後のパフォーマンスの表示

各デプロイメントのデプロイメントページリンクは、イベントセクションで選択したアプリのSummaryページに表示されます。期間が14日未満の場合、チャート上の青い縦棒はデプロイメントを示します。デプロイメントに関する概要情報を表示するには、マウスを青色の縦棒に合わせます。