Sentry 오류 추적
Tier: Free, Premium, Ultimate
Offering: GitLab.com, Self-managed, GitLab Dedicated
Sentry는 오픈 소스 오류 추적 시스템입니다. GitLab은 관리자가 Sentry를 GitLab에 연결하여 사용자가 GitLab에서 Sentry 오류 목록을 볼 수 있도록 지원합니다.
GitLab은 클라우드 호스팅된 Sentry와 사용자의 온프레미스 인스턴스에 배포된 Sentry와 모두 통합됩니다.
프로젝트용 Sentry 통합 활성화
GitLab은 Sentry를 프로젝트에 연결하는 방법을 제공합니다.
필수 조건:
- 프로젝트의 유지자 역할 이상이어야 합니다.
Sentry 통합 활성화 방법:
- Sentry.io에 가입하거나 자체 온프레미스 Sentry 인스턴스를 배포하세요.
- 새 Sentry 프로젝트를 생성합니다. 통합하려는 각 GitLab 프로젝트에 대해 새로운 Sentry 프로젝트를 만듭니다.
-
Sentry 인증 토큰을 찾거나 생성합니다.
Sentry의 SaaS 버전의 경우, https://sentry.io/api/에서 인증 토큰을 찾거나 생성할 수 있습니다.
토큰에 적어도 다음 스코프(scopes)를 부여하세요:
project:read,event:read, 및 (이벤트 해결을 위한)event:write。 - GitLab에서 오류 추적을 활성화하고 구성합니다:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 설정 > 모니터를 선택한 다음 오류 추적을 확장합니다.
- 오류 추적 활성화에 대해 활성화를 선택합니다.
- 오류 추적 백엔드에 대해 Sentry를 선택합니다.
-
Sentry API URL에 Sentry 호스트명을 입력합니다. 예를 들어,
https://sentry.example.com을 입력합니다. Sentry의 SaaS 버전의 경우, 호스트명은https://sentry.io입니다. - 인증 토큰에 이전에 생성한 토큰을 입력합니다.
- Sentry와의 연결을 테스트하고 프로젝트 드롭다운 목록을 채우려면, 연결을 선택합니다.
- 프로젝트 목록에서 GitLab 프로젝트에 연결할 Sentry 프로젝트를 선택합니다.
- 변경 사항 저장을 선택합니다.
Sentry 오류 목록을 보려면, 프로젝트 사이드바에서 모니터 > 오류 추적으로 이동합니다.
Sentry와 GitLab의 통합 활성화
또한 Sentry 문서의 단계를 따라 Sentry의 GitLab 통합을 활성화할 수 있습니다.
문제 해결
오류 추적을 사용하는 경우 다음과 같은 문제가 발생할 수 있습니다.
오류 연결 실패. 인증 토큰을 확인하고 다시 시도하세요
프로젝트 설정에서
모니터 기능이 비활성화된 경우, 프로젝트용 Sentry 통합을 활성화하려고 하면 오류가 발생할 수 있습니다.
결과적으로 /project/path/-/error_tracking/projects.json?api_host=https:%2F%2Fsentry.example.com%2F&token=<token>로 보내는 요청이 404 오류를 반환할 수 있습니다.
이 문제를 해결하려면 프로젝트의 모니터 기능을 활성화하세요.
도움말