Sentry는 오픈 소스 오류 추적 시스템입니다. GitLab은 관리자가 Sentry를 GitLab에 연결할 수 있도록 하여 사용자가 GitLab에서 Sentry 오류 목록을 볼 수 있습니다.

GitLab은 클라우드 호스팅 Sentry와 온프레미스 인스턴스에 배포된 Sentry 모두와 통합됩니다.

프로젝트에 대한 Sentry 통합 활성화#

GitLab은 프로젝트에 Sentry를 연결하는 방법을 제공합니다.

사전 요구사항:

• 프로젝트에서 유지 관리자 또는 소유자 역할이 있어야 합니다.

Sentry 통합을 활성화하려면:

1. Sentry.io에 가입하거나 자체 온프레미스 Sentry 인스턴스를 배포합니다.
2. 새 Sentry 프로젝트를 생성합니다. 통합하려는 각 GitLab 프로젝트에 대해 새 Sentry 프로젝트를 생성합니다.
3. Sentry 인증 토큰을 찾거나 생성합니다. Sentry의 SaaS 버전의 경우 https://sentry.io/api/에서 인증 토큰을 찾거나 생성할 수 있습니다. 토큰에 최소한 project:read, event:read 및 event:write(이벤트 해결용) 범위를 부여합니다.
4. GitLab에서 오류 추적을 활성화하고 구성합니다:
   1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
   2. 설정 > 모니터를 선택한 다음 오류 추적을 확장합니다.
   3. 오류 추적 활성화에서 활성을 선택합니다.
   4. 오류 추적 백엔드에서 Sentry를 선택합니다.
   5. Sentry API URL에 Sentry 호스트명을 입력합니다. 예를 들어 https://sentry.example.com을 입력합니다. Sentry의 SaaS 버전의 경우 호스트명은 https://sentry.io입니다. EU에서 호스팅되는 Sentry SaaS 버전의 경우 호스트명은 https://de.sentry.io입니다.
   6. 인증 토큰에 이전에 생성한 토큰을 입력합니다.
   7. Sentry에 대한 연결을 테스트하고 프로젝트 드롭다운 목록을 채우려면 연결을 선택합니다.
   8. 프로젝트 목록에서 GitLab 프로젝트에 연결할 Sentry 프로젝트를 선택합니다.
   9. 변경 사항 저장을 선택합니다.

Sentry 오류 목록을 보려면 프로젝트의 사이드바에서 모니터 > 오류 추적으로 이동합니다.

GitLab과 Sentry 통합 활성화#

Sentry 문서의 단계를 따라 GitLab과 Sentry의 통합을 활성화할 수도 있습니다.

문제 해결#

오류 추적을 사용할 때 다음 문제가 발생할 수 있습니다.

오류 Connection failed. Check auth token and try again#

프로젝트 설정에서 모니터 기능이 비활성화된 경우 프로젝트에 대한 Sentry 통합 활성화를 시도할 때 오류가 발생할 수 있습니다. /project/path/-/error_tracking/projects.json?api_host=https:%2F%2Fsentry.example.com%2F&token=<token>에 대한 결과 요청이 404 오류를 반환합니다.

이 문제를 해결하려면 프로젝트에 대한 모니터 기능을 활성화합니다.

오류 Connection has failed. Re-check Auth Token and try again#

온프레미스 Sentry 통합은 연결 시도 시 이 문제가 발생할 수 있습니다.

사전 요구사항:

• 관리자 액세스.

이 문제를 해결하려면:

1. 오른쪽 상단에서 관리자를 선택합니다.
2. 설정 > 네트워크를 선택합니다.
3. 아웃바운드 요청을 확장합니다.
4. 웹훅 및 통합에서 로컬 네트워크에 대한 요청 허용 및 시스템 훅에서 로컬 네트워크에 대한 요청 허용 체크박스를 선택합니다.
5. 변경 사항 저장을 선택합니다.