Datadog 연동을 사용하면 GitLab 프로젝트를 Datadog에 연결할 수 있습니다. 이 연동으로 저장소 메타데이터를 동기화해 Datadog 텔레메트리를 강화하고, Datadog 이 머지 리퀘스트에 댓글을 남기게 하며, CI/CD 파이프라인과 job 정보를 Datadog으로 전송할 수 있습니다.

Datadog 계정 연결#

관리자 액세스 권한이 있는 사용자는 전체 인스턴스 또는 특정 프로젝트나 그룹에 대해 이 연동을 구성할 수 있습니다:

1. Datadog API 키가 없다면 다음을 수행합니다.
   1. Datadog에 로그인합니다.
   2. Integrations 섹션으로 이동합니다.
   3. APIs 탭에서 API 키를 생성합니다. 이후 단계에서 필요하므로 이 값을 복사해 둡니다.
2. 특정 프로젝트나 그룹에 대한 연동인 경우: GitLab에서 해당 프로젝트나 그룹으로 이동합니다.
3. 전체 인스턴스에 대한 연동인 경우:
   1. 관리자 액세스 권한이 있는 사용자로 GitLab에 로그인합니다.
   2. 오른쪽 상단에서 Admin을 선택합니다.
4. 왼쪽 사이드바에서 Settings > Integrations를 선택합니다.
5. Add an integration까지 스크롤한 후 Datadog을 선택합니다.
6. 연동을 활성화하려면 Active를 선택합니다.
7. 데이터를 전송할 Datadog site를 지정합니다.
8. 선택 사항. 데이터를 직접 전송하는 데 사용되는 API URL을 재정의하려면 API URL을 입력합니다. 고급 시나리오에서만 사용됩니다.
9. Datadog API 키를 입력합니다.

CI Visibility 구성#

선택적으로 Datadog CI Visibility를 활성화해 CI/CD 파이프라인과 job 데이터를 Datadog으로 전송할 수 있습니다. 이 기능을 사용해 job 실패와 성능 문제를 모니터링하고 문제 해결합니다.

자세한 내용은 Datadog CI Visibility 문서를 참고합니다.

이 기능은 Webhooks를 기반으로 하며, GitLab 에서의 구성만 필요합니다:

1. 선택 사항. job 출력에 대한 로그 수집을 활성화하려면 Enable Pipeline job logs collection을 선택합니다.
2. 선택 사항. GitLab 인스턴스를 둘 이상 사용한다면 인스턴스를 구분할 수 있도록 고유한 Service 이름을 입력합니다.
3. 선택 사항. 스테이징·프로덕션 환경과 같이 GitLab 인스턴스 그룹을 사용한다면 Env 이름을 입력합니다. 이 값은 연동이 생성하는 각 span에 첨부됩니다.
4. 선택 사항. 연동이 구성되는 모든 span에 대한 커스텀 태그를 정의하려면 Tags에 한 줄에 하나씩 태그를 입력합니다. 각 줄은 key:value 형식이어야 합니다.
5. 선택 사항. Test settings를 선택합니다.
6. Save changes를 선택합니다.

연동이 데이터를 전송하면 Datadog 계정의 CI Visibility 섹션에서 확인할 수 있습니다.

관련 주제#

• Datadog CI Visibility 문서