통합

웹훅으로 외부 소스에서 알림을 받고, 알림 필드를 매핑하고, 테스트 알림을 트리거하며, Prometheus·Opsgenie 같은 도구와 통합하는 방법을 설명합니다.

GitLab은 웹훅 리시버를 통해 모든 소스에서 알림을 받을 수 있습니다. 알림 은 온콜 로테이션에 대한 페이징을 트리거 하거나 인시던트를 생성 하는 데 사용할 수 있습니다. 통합 목록 # Maintainer 또는 Owner 권한이 있으면 프로젝트 사이드바 메뉴에서 Settings > Monitor 로 이동하고 Alerts 섹션을 확장하여 구성된 알림 통합 목록을 볼 수 있습니다. 목록에는 통합 이름, 유형, 상태(활성화 또는 비활성화)가 표시됩니다. 구성 # GitLab은 사용자가 구성하는 HTTP 엔드포인트를 통해 알림을 받을 수 있습니다. 단일 알림 엔드포인트 # GitLab 프로젝트에서 알림 엔드포인트를 활성화하면 JSON 형식의 알림 페이로드를 받을 수 있습니다. 원하는 대로 언제든지 페이로드를 커스터마이즈 할 수 있습니다. 프로젝트에서 Maintainer 권한이 있는 사용자로 GitLab에 로그인합니다. 프로젝트에서 Settings > Monitor 로 이동합니다. Alerts 섹션을 확장하고 Select integration type 드롭다운 목록에서 Prometheus 알림이면 Prometheus 를, 다른 모니터링 도구면 HTTP Endpoint 를 선택합니다. Active 알림 설정을 토글합니다. 통합을 저장하면 웹훅 구성에 필요한 URL과 Authorization Key를 View credentials 탭에서 확인할 수 있습니다. 외부 서비스에도 이 URL과 Authorization Key를 입력해야 합니다. 알림 엔드포인트 # GitLab Premium 에서는 JSON 형식으로 모든 외부 소스로부터 알림을 받을 수 있는 고유한 알림 엔드포인트를 여러 개 생성할 수 있으며, 페이로드를 커스터마이즈 할 수도 있습니다. 프로젝트에서 Maintainer 권한이 있는 사용자로 GitLab에 로그인합니다. 프로젝트에서 Settings > Monitor 로 이동합니다. Alerts 섹션을 확장합니다. 생성하려는 각 엔드포인트마다 다음을 수행합니다. Add new integration 을 선택합니다. Select integration type 드롭다운 목록에서 Prometheus 알림이면 Prometheus 를, 다른 모니터링 도구면 HTTP Endpoint 를 선택합니다. 통합의 이름을 지정합니다. Active 알림 설정을 토글합니다. 통합을 저장하면 웹훅 구성에 필요한 URL 과 Authorization Key 를 View credentials 탭에서 확인할 수 있습니다. 외부 서비스에도 URL과 Authorization Key를 입력해야 합니다. 선택 사항. 모니터링 도구의 알림 필드를 GitLab 필드에 매핑하려면 샘플 페이로드를 입력하고 Parse payload for custom mapping 을 선택합니다. 유효한 JSON 이어야 합니다. 샘플 페이로드를 업데이트하면 필드도 다시 매핑해야 합니다. Prometheus 통합의 경우 전체 페이로드 대신 페이로드의 alerts 키에서 알림 하나만 입력합니다. 선택 사항. 유