중요 이전 배포 마커 대신 태킹 변경 기능을 사용하는 것이 좋습니다. 배포 마커 기능을 사용해 왔다면 계속 사용할 수 있지만 변경 사항 태킹 기능은 APM뿐만 아니라 브라우저와 모바일에서도 사용할 수 있습니다.
앱 배포는 위험한 이벤트가 될 수 있습니다. 앱이 중단되고 잘못된 배포가 원인인 경우가 많습니다. New Relic을 사용하면 배포를 추적할 수 있으므로 배포와 앱 성능의 변화를 연관시킬 수 있습니다. 배포를 추적하면 APM 차트 및 대시보드에 표시되는 배포 마커가 생성됩니다.
이 짧은 비디오(4분 30분)에서 배포 마커의 작동 방식을 확인하십시오.
배포 추적 옵션 New Relic REST API v2 를 사용하여 새 배포를 기록하고 과거 배포 목록을 검색할 수 있습니다. 또한 일부 APM 에이전트에는 배포를 자동으로 기록하는 에이전트별 방법이 있습니다.
Slack 을 New Relic과 통합하거나 간단한 웹훅을 사용하여 APM에서 모니터링하는 애플리케이션의 배포를 실시간으로 팀에 알릴 수 있습니다. Slack은 선택한 Slack 채널에 형식이 지정된 일반 JSON을 게시할 수 있는 웹훅 URL을 제공합니다.
배치가 기록된 후 New Relic UI에서 배치를 볼 수 있는 곳이 몇 군데 있습니다.
APM 요약 , 서비스 요약 및 엔티티 요약 페이지 의 활동 피드에서.APM 성능 차트에서 차트 마커(핀 머리가 있는 수직선)로 표시됩니다. 차트 표식으로 대시보드 차트에서. 요약 성능에 대한 배포 페이지에서. 팁 배포 마커는 아직 브라우저 애플리케이션에서 사용할 수 없지만 곧 이를 지원하는 새 API를 출시할 예정입니다. 제한된 미리 보기에 참여하는 방법에 대해 자세히 알아보려면 이 등록 양식 을 통해 문의하십시오. 또한 릴리스 버전으로 오류에 태그를 지정하는 방법은 브라우저 릴리스 를 참조하십시오.
REST API로 배포 기록 New Relic REST API v2를 사용하여 배포를 기록하고 과거 배포 목록을 가져올 수 있습니다.
이 문서의 예에서는 curl
를 명령줄 도구로 사용합니다. 그러나 모든 방법을 사용하여 REST 요청을 할 수 있습니다. API 탐색기 를 사용하여 배포를 만들고 볼 수도 있습니다. JSON은 요소 이름과 콘텐츠에 큰따옴표 "
를 사용합니다. 작은따옴표 '
를 사용하면 오류가 발생합니다. POST로 배포 기록 새 배포를 기록하려면 API 키 가 포함된 POST
요청을 배포 엔드포인트로 보냅니다. 페이로드를 JSON 형식으로 연결합니다( 문자 제한 및 JSON 매개변수 참조). revision
을 제외한 모든 페이로드 매개변수는 선택사항입니다.
예를 들어:
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"
}
}'
PowerShell로 배포 기록 PowerShell로 배포를 기록하려면 API 키 가 포함된 POST
요청을 배포 엔드포인트로 보냅니다. 페이로드를 JSON 형식으로 연결합니다( 문자 제한 및 JSON 매개변수 참조). revision
을 제외한 모든 페이로드 매개변수는 선택사항입니다.
이 예에서는 PowerShell 버전 3 이상을 사용합니다.
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"
}
}'
이 예에서는 PowerShell 버전 2(.NET Framework 3.5 이상 필요)를 사용합니다.
$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()
GET으로 배포 목록 보기 앱의 모든 과거 배포 목록을 검색하려면 API 키 가 포함된 GET
요청을 배포 엔드포인트로 보냅니다. GET 요청은 JSON 페이로드를 사용하지 않습니다.
예를 들어:
curl -X GET "https://api.newrelic.com/v2/applications/$APP_ID /deployments.json" \
-H "Api-Key:$API_KEY " \
-i
GET의 샘플 출력 이 예에서는 앱 ID 9999999
에 대한 배포 목록을 요청합니다.
curl -X GET "https://api.newrelic.com/v2/applications/9999999/deployments.json" \
-H "Api-Key:ABCDEFGHIJKLMNOPQRSTUVWXabcdefghijklmnopqrstuvwx" \
API는 다음 배포 목록을 반환합니다.
ETag: "ABCDEFGHIJKabcdefghijk0123456789"
Cache-Control: max-age=0, private, must-revalidate
Content-Type: application/json
"revision": "1234123412341234123412341234123412341234",
"changelog": "Fixed the bugs for real this time",
"description": "Example description two",
"timestamp": "2016-02-24T10:09:27-08:00",
"revision": "7890789078907890789078907890789078907890",
"changelog": "Think I fixed all the bugs",
"timestamp": "2014-10-22T12:23:47-07:00",
"deployment.agent": "/v2/applications/{application_id}"
글자 수 제한 및 JSON 매개변수 JSON 페이로드에는 다음 매개변수가 포함될 수 있습니다.
중요 Emojis 및 일부 비 라틴 언어 글리프와 같은 UTF-8 4바이트 문자는 배포 텍스트에 사용할 수 없습니다.
매개변수
데이터 형식
설명
revision
문자열, 최대 127자
필수 . 요약 페이지 및 배포 페이지에 표시되는 이 배포의 고유 ID입니다. 모든 문자열이 될 수 있지만 일반적으로 버전 번호 또는 Git 체크섬입니다.
changelog
문자열, 최대 65535자
선택 사항 . (선택한 배포) > Change log 를 선택하면 배포 페이지에 표시되는 이 배포에서 변경된 사항에 대한 요약입니다.
description
문자열, 최대 65535자
선택 사항 . 요약 페이지 및 개별 배포를 선택할 때 배포 페이지에 표시되는 이 배포에 대한 상위 수준 설명입니다.
user
문자열, 최대 31자
선택 사항 . 요약 페이지 및 배포 페이지에 표시되는 배포와 연결할 사용자 이름입니다.
timestamp
ISO 8601
선택 사항 . 배포가 발생했을 때 두 번째로 떨어졌습니다. 지정하지 않으면 API 호출이 수신된 시점에 배포가 기록됩니다. 타임스탬프 요구 사항:
UTC 시간이어야 합니다. 가장 최근 배포 타임스탬프 이후여야 합니다. 미래에 있을 수 없습니다. ISO8601 형식이어야 합니다. 예: "2019-10-08T00:15:36Z"
.
New Relic 에이전트를 사용하여 배포 기록 일부 에이전트에는 배포를 기록하는 추가 방법이 있습니다.
배포 팀에 알림 REST API를 사용하여 배포가 기록된 후 선택적으로 배포를 웹훅 엔드포인트에 알릴 수 있습니다.
웹훅의 대상은 Slack 인스턴스가 될 수 있습니다. 웹훅을 사용하여 Slack 채널에 대한 배포 알림을 설정하려면:
Slack 계정에 관리자로 로그인한 다음 App directory > Manage > Apps 으로 이동합니다. New Relic 앱을 검색한 다음 구성 추가 를 선택합니다. Post to channel 에서 기존 Slack 채널을 선택하거나 새 채널을 추가한 다음 구성 추가 .옵션 목록에서 웹훅 URL을 복사합니다. one.newrelic.com > ( 사용자 메뉴 ) > Account settings > Integrations > Deploy notifications > Webhook 으로 이동합니다.Slack 웹훅 URL을 붙여넣고 저장합니다. 선택 사항: 테스트 메시지를 보냅니다. 팁 웹훅, Slack 채널 및 기타 경고 알림 옵션을 사용할 수도 있습니다.
배포 세부정보 보기 중요 이 섹션과 다음 섹션에서는 현재 배포 마커 UI를 사용하는 방법에 대해 설명합니다. UI에 제한된 미리 보기에 있다는 파란색 배너가 표시되면 새 UI에 액세스할 수 있습니다. 이 경우 이러한 새 지침 으로 전환하십시오.
배포 정보를 구성한 후 세부 정보를 보고 드릴다운할 수 있습니다.
one.newrelic.com > All capabilities > APM & services > (앱 선택) > Events > Deployments 으로 이동합니다.자세한 정보를 드릴다운하려면 New Relic의 표준 사용자 인터페이스 기능 을 사용하십시오. 특정 이벤트에 대한 세부 정보를 보려면 해당 날짜 링크를 선택하십시오. 이 배포에 대한 오류 페이지를 보려면 오류 링크를 선택하십시오. 해당하는 경우 특정 배포에 대한 세부 정보를 보려면 로그 변경 또는 보고서 변경 을 선택합니다. 변경 로그 에는 배포를 기록 할 때 changelog
매개변수를 통해 제공된 모든 세부정보가 포함됩니다. 변경 보고서 는 배포 전후의 상위 10개 트랜잭션의 동작을 표시합니다.
배포 후 성능 보기 개별 배포에 대한 배포 페이지 링크는 이벤트 섹션에서 선택한 앱의 요약 페이지에 나타납니다. 14일보다 짧은 기간의 경우 차트의 파란색 세로 막대는 배포를 나타냅니다. 배포에 대한 요약 정보를 보려면 파란색 막대 위로 마우스를 가져갑니다.
팁 APM 요약 페이지에서 비교 대상 옵션을 사용하여 동일한 데이터를 비교할 기간을 선택할 수도 있습니다. 비교 대상 을 활성화하면 UI에 배포 마커가 표시되지 않습니다.