변경 추적 기능을 사용하면 모니터링하려는 변경 사항을 지정하여 해당 변경 사항이 고객과 시스템에 어떤 영향을 미치는지 확인할 수 있습니다. GraphQL 또는 CLI를 사용하여 모니터링할 변경 사항을 지정할 수 있지만 Jenkins의 파이프라인을 사용하여 변경 사항을 기록할 수도 있습니다.
파이프라인은 사용자가 지정한 빌드를 호출하고 추가 환경 변수도 빌드 프로세스에 전달합니다. 그러면 배포에 필요한 데이터가 뉴렐릭의 차트들에 표시됩니다. 변경 추적 UI에서 결과를 확인하고, 이 정보를 사용하여 변경 사항이 상태에 미치는 영향을 이해할 수 있습니다.
전제 조건
Jenkins 플러그인을 설치하려면 다음이 필요합니다.
- Jenkins 1.580.1 이상
- Jenkins 관리자 권한
Jenkins 플러그인 설치
Jenkins를 열고 Manage Jenkins, Plugins으로 이동합니다.
Available plugins를 클릭한 다음
newrelic-deployment-notifier를 검색합니다. Install을 클릭합니다.설치 진행 상황이 포함된 새 페이지가 나타납니다. 플러그인을 다시 시작할 필요가 없습니다.
빌드 후 작업 생성
Jenkins 빌드 작업 구성에서 뉴렐릭 배포 알림(New Relic Deployment Notifier)을 빌드 후 작업으로 추가하려면:
Jenkins 작업 설정에서
Post-build Actions section
으로 이동하여
Add post-build action
을 클릭한 다음,
New Relic Deployment Notifications
를 선택합니다.
사용자 API 키를 위한 사용자 이름/비밀번호 크리덴셜을 생성합니다. 비밀번호를 키로 입력합니다.
드롭다운 메뉴 목록에서 원하는 엔터티를 선택합니다.
필수 항목인
Version또는Revision값과 선택적 값들을 추가합니다.${BUILD_NUMBER}같이 이러한 필드에 환경 변수를 사용할 수 있습니다.
필드
설명
설명
추적 중인 사항에 대한 설명을 삽입합니다.
Revision
배포에 대한 개정입니다. 여기서는
${BUILD_NUMBER}가 좋은 값이 될 수 있습니다.Changelog
배포에서 발생한 변경 사항 목록에 대한 참조입니다.
Commit
커밋 ID를 참조하는 해시입니다.
Deeplink
Jenkins 작업 또는 배포에 대한 다른 참조의 딥 링크입니다.
EntityGuid
배포에 참조된 애플리케이션 엔터티입니다. ( 애플리케이션 GUID에 대한 추가 정보 참조)
DeploymentType
배포되고 있는 배포의 유형입니다.
GroupId
변경 사항 클러스터를 참조하는 식별자입니다.
Timestamp
Unix Epoch 긴 형식의 선택적 타임스탬프입니다. 제공되지 않은 경우 요청을 받은 시간(Unix Epoch 이후의 밀리초)으로 설정됩니다.
버전
배포되고 있는 버전입니다. 여기서는
${BUILD_NUMBER}가 좋은 값이 될 수 있습니다.User
배포를 수행하는 사용자입니다. Tip: Build User Vars 플러그인을 설치하면 Jenkins 사용자에 관한 환경 변수를 확보할 수 있으며, 확보된 변수를 이 필드에서 사용할 수 있습니다. (예:
${BUILD_USER})
(선택사항) 이 Jenkins 작업이 여러 엔터티에 영향을 미치는 경우 알림 수신에도 추가할 수 있습니다. 더 많은 앱을 추가하려면 Add another notification 버튼을 클릭합니다.
다음 단계는?
추적하려는 변경 사항을 지정한 후 뉴렐릭 UI에서 해당 변경 사항의 효과를 분석할 수 있습니다. 보다 자세한 내용은 뉴렐릭에서 변경 사항을 보고 분석하는 방법을 참조하십시오.
플러그인 제거
Plugins
페이지에서
Installed plugins
를 클릭합니다.
newrelic-deployment-notifier를 검색합니다.빨간색
X를 클릭합니다.