작업 및 파이프라인 실행을 분산 추적 으로 시각화하여 OpenTelemetry 플러그인 으로 Jenkins를 모니터링합니다. 또한 빠른 시작 을 설치하여 Jenkins 파이프라인을 모니터링하기 위해 사전 빌드된 대시보드를 얻을 수 있습니다.
전제 조건
먼저 Jenkins에서 OpenTelemetry 플러그인을 설치해야 합니다.
- 젠킨스에 로그인합니다.
- 대시보드에서 Manage Jenkins 클릭합니다.
- 시스템 설정에서 Plugins 클릭합니다.
- Available plugins 탭을 클릭한 다음 OpenTelemetry) 검색하세요.
- OpenTelemetry 확인란을 선택하고 Install without restart 선택합니다.
- 설치가 완료되면 Manage Jenkins 클릭합니다.
- System Configuration 아래에서 System 클릭합니다.
- 아래로 스크롤하여 OpenTelemetry 섹션을 확인하세요. 표시되지 않으면 Jenkins를 다시 시작하세요.
구성
뉴렐릭으로 데이터를 보내려면 Jenkins 플러그인을 구성하려면 뉴렐릭 OTLP 엔드포인트 와 가 필요합니다. OpenTelemetry
- OTLP 엔드포인트를 입력하세요. 예를 들어,
https://otlp.nr-data.net:4317
. - 인증을 위해 Header Authentication 선택합니다. Header Name 필드에 api-key 입력합니다. 비. Header Value 필드에 뉴렐릭 수집 인스턴스 키가 포함된 비밀 텍스트를 입력합니다.
- 변경 사항을 저장합니다.
뉴렐릭 클러스터 키로 생성된 비밀 텍스트가 없으면 + Add 버튼을 클릭하고 Jenkins Credentials Provider 선택하여 생성하세요. kind 및 secret 을 제외하고 기본값을 유지할 수 있으며 description 는 선택 사항입니다.
- Kind 드롭다운 메뉴에서 Secret text 선택하세요.
- secret 필드에 뉴렐릭 수집 인스턴스 키를 입력합니다.
- 선택적으로 비밀 텍스트의 용도를 기록하는 설명을 추가합니다.
확인
New Relic에서 Jenkins 데이터를 보려면 작업을 실행하거나 새 파이프라인을 만드십시오. 파이프라인을 구축하는 방법은 다음과 같습니다.
- Jenkins에 로그인하고 New Item 클릭합니다.
- 항목 이름을 입력하고 Pipeline 클릭한 다음 OK 클릭합니다.
- Pipeline 섹션까지 맨 아래로 스크롤합니다.
- 파이프라인 펼쳐보기를 사용하고 try sample Pipeline... 드롭다운 메뉴에서 옵션을 선택하세요.
- 저장을 클릭합니다.
- 새로 생성된 파이프라인에서 Build Now 클릭합니다.
- one.newrelic.com > All capabilities > APM & services > Services - OpenTelemetry > jenkins 에 도착했습니다.
- 작업 및 파이프라인 실행을 시각화하려면 Distributed tracing 클릭하세요.
- Jenkins 콘솔 로그를 보려면 Logs 클릭하세요. 로그가 없으면 환경 변수
OTEL_LOGS_EXPORTER="otlp"
이 설정되어 있는지 확인하세요.
Jenkins 빠른 시작 대시보드 설치
Jenkins 파이프라인 데이터를 New Relic으로 보낸 후에는 New Relic Instant Observability 에서 미리 빌드된 대시보드를 사용하여 작업 및 파이프라인 실행을 쉽게 모니터링할 수도 있습니다. 통합 보기에서 주요 메트릭을 보려면 미리 빌드된 대시보드로 몇 분 만에 시작하세요.
- 뉴렐릭 Instant 옵저버빌리티 의 Jenkins 퀵스타트로 이동하여 + Install now 클릭하세요.
- 계정을 선택하고 Begin installation 클릭합니다.
- 이미 유효성 검사를 완료했다면 done 선택하여 다음 단계로 이동하세요.
- 퀵스타트 구현은 귀하의 계정에 대한 리소스를 배포합니다. 대시보드로 이동하려면 see your data 클릭하세요.
중요
Jenkins OpenTelemetry 플러그인은 New Relic에서 유지 관리하지 않으므로 계측에 문제가 있는 경우 플러그인의 GitHub 저장소에서 새 문제를 생성하세요.