Sentry 오류 추적

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

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

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

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

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

전제 조건:

  • 프로젝트에 대해 최소한의 Maintainer 역할이 있어야 합니다.

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. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
    2. Settings > Monitor를 선택한 다음 Error Tracking을 확장합니다.
    3. Enable error tracking에서 Active를 선택합니다.
    4. Error tracking backend에서 Sentry를 선택합니다.
    5. Sentry API URL에 Sentry 호스트 이름을 입력합니다. 예를 들어, https://sentry.example.com을 입력합니다.
      Sentry의 SaaS 버전에서 호스트 이름은 https://sentry.io입니다.
    6. Auth Token에 이전에 생성한 토큰을 입력합니다.
    7. Sentry에 대한 연결을 테스트하고 Project 드롭다운 목록을 채우려면 Connect를 선택합니다.
    8. Project 목록에서 GitLab 프로젝트에 연결할 Sentry 프로젝트를 선택합니다.
    9. Save changes를 선택합니다.

Sentry 오류 목록을 보려면 프로젝트의 사이드바에서 Monitor > Error Tracking으로 이동합니다.

GitLab과의 Sentry 통합 활성화

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

문제 해결

오류 추적 작업 중에 다음과 같은 문제가 발생할 수 있습니다.

오류 Connection failed. Check auth token and try again

프로젝트 설정에서 Monitor 기능이 비활성화되어 있으면, 프로젝트에 대한 Sentry 통합을 활성화하려고 할 때 오류가 발생할 수 있습니다.
이로 인해 /project/path/-/error_tracking/projects.json?api_host=https:%2F%2Fsentry.example.com%2F&token=<token> 요청이 404 오류를 반환합니다.

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