그런 다음 계측할 각 프로젝트에 대해 Settings > Integrations > Datadog으로 이동하여 프로젝트에 대한 통합을 설정합니다.
참고: 초기 버전의 GitLab 버그로 인해, GitLab의 UI에서 옵션을 사용할 수 있더라도 GitLab versions < 14.1에서는 그룹 또는 인스턴스 레벨에서 Datadog 통합을 활성화할 수 없습니다.
통합 구성 설정을 입력합니다:
Active
통합을 활성화합니다.
Datadog site
데이터를 보낼 Datadog site를 지정합니다. 기본값: datadoghq.com 선택된 사이트:
API URL (선택 사항)
데이터를 직접 전송하는 데 사용되는 API URL을 재정의할 수 있으며, 고급 시나리오에서만 사용됩니다.. 기본값: (공백, 재정의 없음)
API key
데이터를 보낼 때 사용할 API 키를 지정합니다. Datadog의 통합 섹션에 있는 APIs 탭에서 생성할 수 있습니다.
Service (선택 사항)
통합에 의해 생성된 각 스팬에 연결할 서비스 이름을 지정합니다. 이를 통해 GitLab 인스턴스를 구분할 수 있습니다. 기본값: gitlab-ci
Env(선택 사항)
통합에 의해 생성된 각 스팬에 연결할 환경 (env 태그)을 지정합니다. 이를 통해 GitLab 인스턴스 그룹을 구분할 수 있습니다 (예: 스테이징 또는 프로덕션). 기본값: none
Tags (선택 사항)
통합에 의해 생성된 각 스팬에 연결할 커스텀 태그를 지정합니다. key:value 형식의 태그를 한 줄에 하나씩 입력합니다. 기본값: (공백, 추가 태그 없음) 참고: GitLab.com 및 GitLab > = 14.8 자체 호스팅에서만 사용 가능.
Test settings 버튼을 사용하여 (프로젝트에서 통합을 설정하는 경우에만 사용 가능) 통합을 테스트할 수 있습니다.성공적으로 완료되면 Save changes를 클릭하여 통합 설정을 완료합니다.
웹후크를 통한 통합
네이티브 Datadog 통합을 사용하는 대신 웹후크를 사용하여 파이프라인 데이터를 Datadog으로 전송할 수 있습니다.
참고: 네이티브 Datadog 통합은 권장되는 접근 방식이며 현재 개발 중인 옵션입니다.
리포지토리 (또는 GitLab 인스턴스 설정)에서 Settings > Webhooks로 이동하여 새 웹후크를 추가합니다:
URL: https://webhook-intake./api/v2/webhook/?dd-api-key=<API_KEY> 여기서 <API_KEY>는 Datadog API 키입니다.
Secret Token: 비워둠
Trigger: Job events 및 Pipeline events를 선택합니다.
커스텀 env 또는 service 파라미터를 설정하려면 웹후크 URL에 쿼리 파라미터를 추가합니다:&env=<YOUR_ENV>&service=<YOUR_SERVICE_NAME>
커스텀 태그 설정
통합으로 생성된 모든 파이프라인과 작업 스팬에 커스텀 태그를 설정하려면 URL에 쉼표로 구분된 key:value 쌍을 사용하여 URL 인코딩된 쿼리 파라미터 tags를 추가합니다 키:값 쌍에 쉼표가 포함되어 있으면 따옴표로 묶어야 합니다. 예를 들어, key1:value1,"key2: value with , comma",key3:value3를 추가하려면 Webhook URL에 다음 문자열을 추가해야 합니다:
자체 호스팅 GitLab 러너를 사용하는 경우 실행 중인 인프라스트럭처와 작업을 상호 연관시킬 수 있습니다. 이 기능이 작동하려면 GitLab 러너에 host:<hostname> 양식의 태그가 있어야 합니다. 새 러너를 등록하는 동안 태그를 추가할 수 있습니다. 기존 러너의 경우, 러너의 config.toml를 업데이트하여 태그를 추가하거나, Settings > CI/CD > Runners로 이동해 적절한 러너를 편집하여 UI를 통해 태그를 추가하세요.
이러한 단계가 끝나면 CI Visibility가 각 작업에 호스트 이름을 추가합니다. 메트릭을 보려면 트레이스 보기에서 작업 스팬을 클릭하세요. 드로어에 호스트 메트릭이 포함된 Infrastructure라는 이름의 새 탭이 나타납니다.
파이프라인 실패에 대한 오류 메시지 보기
오류 메시지는 GitLab 버전 15.2.0 이상에서 지원됩니다.
실패한 GitLab 파이프라인 실행의 경우 특정 파이프라인 실행 내 Errors 탭 아래에 있는 각 오류에 GitLab의 오류 유형과 관련된 메시지가 표시됩니다.
각 오류 유형과 관련된 메시지 및 도메인은 아래 표를 참조하세요. 나열되지 않은 오류 유형은 Job failed의 오류 메시지와 unknown의 오류 도메인으로 이어집니다.