배포 기록 및 보기

앱 배포는 위험한 이벤트가 될 수 있습니다. 앱이 중단되고 잘못된 배포가 원인인 경우가 많습니다. New Relic을 사용하면 배포를 추적할 수 있으므로 배포와 앱 성능의 변화를 연관시킬 수 있습니다. 배포를 추적하면 APM 차트 및 대시보드에 표시되는 배포 마커가 생성됩니다.

이 짧은 영상(4:30분)에서 배포 마커가 작동하는 방식을 확인하세요.

배포 추적 옵션

You can record new deployments and retrieve a list of past deployments with either the New Relic REST API v2 or NerdGraph. Use NerdGraph: the REST API v2 deployment endpoints reach end of life on July 31, 2027. Additionally, some APM agents offer agent-specific methods to automatically record deployments.

Slack 을 New Relic과 통합하거나 간단한 웹훅을 사용하여 APM에서 모니터링하는 애플리케이션의 배포를 실시간으로 팀에 알릴 수 있습니다. Slack은 선택한 Slack 채널에 형식이 지정된 일반 JSON을 게시할 수 있는 웹훅 URL을 제공합니다.

배치가 기록된 후 New Relic UI에서 배치를 볼 수 있는 곳이 몇 군데 있습니다.

• APM 요약 , 서비스 요약 및 엔티티 요약 페이지 의 활동 피드에서.
• APM 성능 차트에서 차트 마커(핀 머리가 있는 수직선)로 표시됩니다.
• 차트 표식으로 대시보드 차트에서.
• 요약 성능에 대한 배포 페이지에서.

REST API로 배포 기록

New Relic REST API v2를 사용하여 배포를 기록하고 과거 배포 목록을 가져올 수 있습니다.

• 이 문서의 예제에서는 curl 을(를) 명령줄 도구로 사용합니다. 하지만 REST requests를 보내는 데 어떤 방법이든 사용할 수 있습니다. API Explorer를 사용하여 배포를 생성하고 확인할 수도 있습니다.
• JSON은 요소 이름과 콘텐츠에 큰따옴표 " 를 사용합니다. 작은따옴표 ' 를 사용하면 오류가 발생합니다.
• 이 예제에서는 사용자 키 또는 REST API 키 에 사용할 수 있는 X-Api-Key 사용합니다. 사용자 키는 이제 REST API에 액세스하는 기본 방법이며, 이를 사용할 때 Api-Key 헤더를 사용할 수 있습니다.

$
curl -X POST "https://api.newrelic.com/v2/applications/$APP_ID/deployments.json" \
>
     -H "X-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 @{'X-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('X-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 "X-Api-Key:$API_KEY" \
>
     -i

$
curl -X GET "https://api.newrelic.com/v2/applications/9999999/deployments.json" \
>
     -H "X-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 에이전트를 사용하여 배포 기록

일부 에이전트에는 배포를 기록하는 추가 방법이 있습니다.

• All agents: Use the New Relic REST API v2.
• C: No SDK-specific methods. Use the REST API.
• Go: No agent-specific methods. Use the REST API.
• Java: 잔류 에이전트 jar를 호출합니다.
• .NET: PowerShell 및 REST API를 사용합니다.
• Node.js: No agent-specific methods. Use the REST API.
• PHP: PHP 스크립트를 사용하십시오.
• Python: newrelic-admin 스크립트의 record-deploy 하위 명령을 사용합니다.
• Ruby: Capistrano 레시피나 newrelic deployments 명령을 사용하세요. 자세한 내용은 여기에서 확인하세요.

배포 세부정보 보기

배포 정보를 구성한 후 UI에서 세부 정보를 보고 드릴다운할 수 있습니다. 팁을 보려면 변경 추적 문서 New Relic에서 변경 사항을 보고 분석하는 방법을 참조하세요.

배포에 대해 팀에 알리기

REST API 또는 최신 GraphQL API를 사용하여 배포를 추적하는지 여부에 관계없이 웹후크를 사용하여 팀 구성원에게 알릴 수 있습니다. 자세한 내용은 변경 사항 추적 웹훅 지침을 참조하세요.