배포 기록 및 보기

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

이 짧은 비디오(4분 30분)에서 배포 마커의 작동 방식을 확인하십시오.

배포 추적 옵션

New Relic REST API v2 를 사용하여 새 배포를 기록하고 과거 배포 목록을 검색할 수 있습니다. 또한 일부 APM 에이전트에는 배포를 자동으로 기록하는 에이전트별 방법이 있습니다.

Slack 을 New Relic과 통합하거나 간단한 웹훅을 사용하여 APM에서 모니터링하는 애플리케이션의 배포를 실시간으로 팀에 알릴 수 있습니다. Slack은 선택한 Slack 채널에 형식이 지정된 일반 JSON을 게시할 수 있는 웹훅 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를 사용합니다.
• 이동 : 에이전트별 방법이 없습니다. REST API를 사용합니다.
• 자바 : 자바 에이전트 jar 를 호출합니다.
• .NET : PowerShell 및 REST API를 사용합니다.
• Node.js : 에이전트별 메서드가 없습니다. REST API를 사용합니다.
• PHP : PHP 스크립트 를 사용합니다.
• Python : newrelic-admin 스크립트의 record-deploy 하위 명령을 사용합니다.
• Ruby : Capistrano 조리법 을 사용하십시오.

배포 팀에 알림

REST API를 사용하여 배포가 기록된 후 선택적으로 배포를 웹훅 엔드포인트에 알릴 수 있습니다.

웹훅의 대상은 Slack 인스턴스가 될 수 있습니다. 웹훅을 사용하여 Slack 채널에 대한 배포 알림을 설정하려면:

1. Slack 계정에 관리자로 로그인한 다음 App directory > Manage > Apps 으로 이동합니다.
2. New Relic 앱을 검색한 다음 구성 추가 를 선택합니다.
3. Post to channel 에서 기존 Slack 채널을 선택하거나 새 채널을 추가한 다음 구성 추가 .
4. 옵션 목록에서 웹훅 URL을 복사합니다.
5. one.newrelic.com > ( 사용자 메뉴 ) > Account settings > Integrations > Deploy notifications > Webhook 으로 이동합니다.
6. Slack 웹훅 URL을 붙여넣고 저장합니다.
7. 선택 사항: 테스트 메시지를 보냅니다.

배포 세부정보 보기

배포 정보를 구성한 후 세부 정보를 보고 드릴다운할 수 있습니다.

1. one.newrelic.com > All capabilities > APM & services > (앱 선택) > Events > Deployments 으로 이동합니다.
2. 자세한 정보를 드릴다운하려면 New Relic의 표준 사용자 인터페이스 기능 을 사용하십시오.
3. 특정 이벤트에 대한 세부 정보를 보려면 해당 날짜 링크를 선택하십시오.
4. 이 배포에 대한 오류 페이지를 보려면 오류 링크를 선택하십시오.
5. 해당하는 경우 특정 배포에 대한 세부 정보를 보려면 로그 변경 또는 보고서 변경 을 선택합니다.

변경 로그 에는 배포를 기록 할 때 changelog 매개변수를 통해 제공된 모든 세부정보가 포함됩니다. 변경 보고서 는 배포 전후의 상위 10개 트랜잭션의 동작을 표시합니다.

배포 후 성능 보기

개별 배포에 대한 배포 페이지 링크는 이벤트 섹션에서 선택한 앱의 요약 페이지에 나타납니다. 14일보다 짧은 기간의 경우 차트의 파란색 세로 막대는 배포를 나타냅니다. 배포에 대한 요약 정보를 보려면 파란색 막대 위로 마우스를 가져갑니다.