GitHub Actions 와 함께 New Relic 변경 사항 추적 기능을 사용하여 변경 사항이 고객과 시스템에 미치는 영향을 모니터링할 수 있습니다. GitHub Actions를 사용하면 모니터링할 변경 사항을 지정한 다음 New Relic UI에서 결과를 볼 수 있습니다. 이를 통해 릴리스 파이프라인 동안 환경에서 변경한 사항을 추적할 수 있습니다.
입력
입력 요소는 다음과 같습니다.
열쇠 | 필수의 | 기본값 | 설명 |
---|---|---|---|
| 예 | 해당 없음 | 변경 마커를 적용할 엔터티 GUID |
| 예 | 해당 없음 | New Relic 개인 API 키 |
| 아니요 | 해당 없음 | Change tracking 페이지에 표시되는 이 변경 사항에 대한 요약입니다. |
| 아니요 | 해당 없음 | Change tracking 페이지에 표시되는 이 변경 사항에 대한 커밋 SHA |
| 아니요 | 해당 없음 | 개별 변경사항을 선택하면 Overview 페이지와 Change tracking 페이지에 표시되는 이 변경사항에 대한 대략적인 설명입니다. |
| 아니요 | 해당 없음 | 변경을 촉발한 소스에 대한 딥 링크 |
| 아니요 |
| 배포 유형입니다. 기본값인 |
| 아니요 | 해당 없음 | 다른 변경사항에 연결하기 위한 변경사항의 그룹 ID |
| 아니요 |
| New Relic 계정의 지역 |
| 예 | 해당 없음 | 최신 릴리스 태그와 같이 변경 마커에 적용할 메타데이터 |
| 예 |
| Overview 및 Deployments 페이지에 표시되는 변경 사항과 연결할 사용자 이름 |
사용 예
GitHub 비밀
다음 Github 비밀 이 설정되어 있는지 확인하십시오.
NEW_RELIC_API_KEY
- 개인 API 키NEW_RELIC_DEPLOYMENT_ENTITY_GUID
- 마커를 생성하기 위한 New Relic Entity GUID
뉴킹릭 플러그인 배포 마커 페이지를 확인하고 Use latest version 버튼을 클릭하여 사용 가능한 최신 버전을 사용하고 있는지 확인하세요.
이 예제에서도 사용되는 여러 기본 GitHub 환경 변수 가 있습니다.
최소 필수 필드
name: Change Tracking Markeron: release: types: [published]
jobs: newrelic: runs-on: ubuntu-latest name: New Relic steps: # This step builds a var with the release tag value to use later - name: Set Release Version from Tag run: echo "RELEASE_VERSION=${{ github.ref_name }}" >> $GITHUB_ENV # This step creates a new Change Tracking Marker - name: New Relic Application Deployment Marker uses: newrelic/deployment-marker-action@v2.3.0 with: apiKey: ${{ secrets.NEW_RELIC_API_KEY }} guid: ${{ secrets.NEW_RELIC_DEPLOYMENT_ENTITY_GUID }} version: "${{ env.RELEASE_VERSION }}" user: "${{ github.actor }}"
모든 입력 필드
이 예는
NEW_RELIC_API_KEY
외에도 "NEW_RELIC_DEPLOYMENT_ENTITY_GUID_<ID>
"과 같은 여러 비밀을 저장하여 여러 항목을 대상으로 지정하는 방법을 보여줍니다. 여기서<ID>
는 대상 항목의 고유 식별자입니다.
NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App123NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App456NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App789
name: Change Tracking Markeron: workflow_dispatch: release: types: [published]
jobs: newrelic: runs-on: ubuntu-latest name: New Relic steps: # This step builds a var with the release tag value to use later - name: Set Release Version from Tag run: echo "RELEASE_VERSION=${{ github.ref_name }}" >> $GITHUB_ENV # This step creates a new Change Tracking Marker for App123 - name: App123 Marker uses: newrelic/deployment-marker-action@v2.3.0 with: apiKey: ${{ secrets.NEW_RELIC_API_KEY }} guid: ${{ secrets.NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App123 }} version: "${{ env.RELEASE_VERSION }}" changelog: "https://github.com/${{ github.repository }}/blob/master/CHANGELOG.md" commit: "${{ github.sha }}" description: "Automated Release via Github Actions" deploymentType: "ROLLING" groupId: "Workshop App Release: ${{ github.ref_name }}" user: "${{ github.actor }}" # This step creates a new Change Tracking Marker for App456 - name: App456 Marker uses: newrelic/deployment-marker-action@v2.3.0 with: apiKey: ${{ secrets.NEW_RELIC_API_KEY }} guid: ${{ secrets.NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App456 }} version: "${{ env.RELEASE_VERSION }}" changelog: "https://github.com/${{ github.repository }}/blob/master/CHANGELOG.md" commit: "${{ github.sha }}" description: "Automated Release via Github Actions" deploymentType: "ROLLING" groupId: "Workshop App Release: ${{ github.ref_name }}" user: "${{ github.actor }}" # This step creates a new Change Tracking Marker for App789 - name: App789 Marker uses: newrelic/deployment-marker-action@v2.3.0 with: apiKey: ${{ secrets.NEW_RELIC_API_KEY }} guid: ${{ secrets.NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App789 }} version: "${{ env.RELEASE_VERSION }}" changelog: "https://github.com/${{ github.repository }}/blob/master/CHANGELOG.md" commit: "${{ github.sha }}" description: "Automated Release via Github Actions" deploymentType: "ROLLING" groupId: "Workshop App Release: ${{ github.ref_name }}" user: "${{ github.actor }}"
무엇 향후 계획
추적할 변경 사항을 지정한 후 New Relic UI에서 해당 변경 사항의 영향을 분석할 수 있습니다. 자세한 내용 은 New Relic에서 변경 사항을 보고 분석하는 방법을 참조하십시오.