변경 추적 기능을 사용하면 모니터링할 변경 사항을 지정하여 변경 사항이 고객과 시스템에 미치는 영향을 확인할 수 있습니다.
GraphQL 또는 CLI를 사용하여 모니터링할 변경 사항을 지정할 수 있지만 Jenkins의 파이프라인을 사용하여 변경 사항을 기록할 수도 있습니다.
파이프라인은 지정한 빌드를 호출하고 추가 환경 변수를 빌드 프로세스에 전달합니다. 이것은 New Relic 전체의 차트에 표시하기 위해 배포에 필요한 데이터를 채웁니다. 변경 내용 추적 UI에서 결과를 볼 수 있으며 이 정보를 사용하여 변경 사항이 엔터티 상태에 미치는 영향을 이해할 수 있습니다.
시작하기 전에 Jenkins 버전 2.222.4 이상을 사용하고 있는지 확인하세요.
플러그인 관리
변경 추적 배포를 기록하려면 Jenkins 인스턴스에서 쉽게 추가하거나 제거할 수 있는 특수 플러그인이 필요합니다.
Jenkins 관리자로 다음 단계를 완료하십시오.
플러그인 추가
중요
아래의 플러그인 설치 단계에서는 Jenkins를 다시 시작해야 합니다.
플러그인을 추가하려면:
여기에서 플러그인을 다운로드하고 다운로드 중에 파일 이름이 변경된 경우 파일 이름을
newrelic-deployment-notifier.hpi로 변경하십시오.팁
이것은 플러그인의 임시 다운로드 위치입니다. Jenkins에서 직접 다운로드할 수 있게 되면 알려드리겠습니다.Jenkins를 열고 Jenkins 관리를클릭합니다.
플러그인 관리 를 클릭합니다.
고급 을 클릭합니다.
플러그인 배포아래에서 파일 선택을 클릭하고
newrelic-deployment-notifier.hpi파일을 업로드합니다.설치를 완료하려면 실행 중인 작업이 없는지 확인한 다음 Jenkins를 다시 시작하십시오. 설치가 완료되고 실행 중인 작업이 없을 때 Jenkins 다시 시작
플러그인 제거
Plugin Manager를 사용하여 플러그인을 제거하려면:
설치됨 을 클릭합니다.
검색 상자에 배포를 입력하고 New Relic Deployment Notifier Plugin 을 선택한 다음 롤백 기호를 클릭하여 이전 버전으로 롤백합니다.
X 아이콘을 클릭하여 제거할 수도 있습니다.
파이프라인 생성 및 실행
빌드를 실행할 때 Jenkins에 배포 세부 정보를 전달할 파이프라인 스크립트를 생성하려면 다음 단계를 따르세요. Jenkins 파이프라인은 함께 연결된 단계 목록입니다. 다음 두 가지 방법 중 하나로 Jenkins 파이프라인을 생성할 수 있습니다.
Jenkinsfile를 생성하고 소스 코드 저장소의 루트에 넣습니다.- Jenkins의 파이프라인 스크립트 기능 사용
각 단계는 단계 목록으로 구성되며 이 부분의 단계 중 하나(마지막 단계일 가능성이 높음)는 NewRelicDeploymentNotifier 를 호출하여 성공적인 빌드에 대한 마커를 배치하는 것입니다.
우리가 만든 플러그인은 GUID를 매개변수로 사용합니다. Environment 섹션에서 GUID를 변수로 식별하고 후속 단계에서 변수로 사용할 수 있습니다. 빌드는 단계 및 단계 목록에 배치하여 호출됩니다.
파이프라인 탭으로 이동하고 하단에서 파이프라인 구문 을 클릭합니다.
샘플 단계 드롭다운을 클릭하고 일반 빌드 단계 단계 를 선택합니다.
Build Step 아래에서 New Relic Deployment Notifications 를 선택합니다.
다음 필드를 작성하십시오.
들
설명
API 키
New Relic에서 배포 작업을 수행하기 위한 API 자격 증명. 자격 증명은 사용자 이름과 암호를 사용하여 Jenkins에서 새 자격 증명을 생성하여 생성할 수 있습니다. 사용자 이름에 대한 식별자와 비밀번호에 대한 API 키를 지정하십시오.
애플리케이션 ID
이는 REST API에 대한 호출에만 사용됩니다. GraphQL 엔드포인트에 대한 호출을 생성하는 경우 이를 포함하지 마십시오.
설명
추적 중인 항목에 대한 설명을 삽입합니다.
개정
배포에 대한 개정입니다.
변경 로그
배포에서 발생한 변경 사항 목록에 대한 참조입니다.
저지르다
커밋 ID를 참조하는 해시입니다.
딥링크
Jenkins 작업 또는 배포에 대한 기타 참조에 대한 딥 링크.
배포 ID
배포 ID를 참조하는 식별자입니다.
EntityGuid
배포와 관련된 애플리케이션 엔터티입니다( 애플리케이션 GUID에 대한 추가 정보 참조).
배포 유형
수행 중인 배포 유형입니다.
그룹 ID
배포 클러스터를 참조하는 식별자입니다.
시간소인
Unix Epoch 긴 형식의 선택적 타임스탬프입니다. 제공되지 않은 경우 요청을 받은 시간으로 설정합니다. 이 시간은 Unix Epoch 이후의 밀리초 수입니다.
버전
배포 중인 항목의 버전에 대한 필수 필드입니다.
사용자
배포를 수행하는 사용자입니다. 이것은 자유 형식 필드입니다. Jenkins에서는 커밋에 이름을 지정하거나 "Jenkins 자동 배포"와 같은 이름을 지정하는 것이 좋습니다.
파이프라인 스크립트 생성 을 클릭합니다.
스크립트를 복사하고 기본 파이프라인 페이지로 돌아가 파이프라인 스크립트에 붙여넣습니다.
파이프라인 스크립트를 실행하여 New Relic에서 배포 마커를 생성합니다.
팁
여전히 New Relic REST API에 요청을 보내려면 EntityGuid 를 삭제하고 applicationID 을 추가할 수 있습니다.
이 파이프라인 스크립트를 GitHub로 이동
GitHub에 파이프라인 스크립트를 저장할 수 있습니다. 파이프라인 스크립트를 검색하려면 Jenkins에서 애플리케이션을 생성할 때 GitHub 리포지토리의 위치를 지정할 수 있습니다.
애플리케이션 GUID에 대한 추가 정보
현재 GUID는 파이프라인에 동적으로 할당할 수 없습니다. New Relic에서 엔터티 GUID를 찾아야 합니다( New Relic 엔터티에 대해 알아보기 참조). 그런 다음 파이프라인 스크립트에서 이 값을 하드코딩하여 해당 엔터티에 대한 배포 알림을 보고합니다. 이 정보는 민감하지 않으며 공개적으로 저장될 수 있습니다.
애플리케이션을 업데이트하는 데 사용되는 자격 증명은 잘못된 배포 마커 전송을 완화해야 합니다. 또한 자격 증명은 Jenkins의 ID로 참조되므로 소스 코드 저장소에 저장할 필요가 없습니다.
장애 발생 여부를 감지하는 방법
파이프라인 구문 오류는 파이프라인을 중단시킵니다. 파이프라인 구문 분석 오류(누락된 빌드 단계 등)는 파이프라인을 중지합니다. 적절한 파이프라인 스크립트를 구성하려면 Jenkins 도구를 사용하여 이러한 문제를 해결해야 합니다. Jenkins의 WYSIWYG 파이프라인 구문 도구를 사용하면 New Relic 배포 알림을 적절하게 구성하는 데 도움이 될 수 있습니다.
플러그인이 오류를 감지하면 파이프라인을 중단해서는 안 됩니다. 예외 및 스택 추적을 기록한 다음 계속됩니다. 이렇게 하면 애플리케이션을 빌드하고 배포할 때 중단을 방지할 수 있습니다.
무엇 향후 계획
추적할 변경 사항을 지정한 후 New Relic UI에서 해당 변경 사항의 영향을 분석할 수 있습니다. 자세한 내용 은 New Relic에서 변경 사항을 보고 분석하는 방법을 참조하십시오.