Grafana 구성하기

Tier: Free, Premium, Ultimate Offering: 자체 관리
  • GitLab 16.0에서 GitLab과 번들로 제공되던 Grafana가 deprecated되었습니다.
  • GitLab 16.3에서 GitLab과 번들로 제공되던 Grafana가 제거되었습니다.

Grafana는 시계열 메트릭을 그래프와 대시보드를 통해 시각화할 수 있는 도구입니다. GitLab은 성능 데이터를 Prometheus에 기록하고, Grafana를 사용하여 데이터를 조회하여 그래프로 표시할 수 있습니다.

GitLab 대시보드 가져오기

정보를 표시하기 시작하려면 일련의 기본 대시보드를 가져올 수 있습니다. GitLab은 시작하기 위한 일련의 기본 Grafana 대시보드를 게시했습니다. 사용하려면:

  1. 저장소를 복제하거나 ZIP 파일 또는 tarball을 다운로드하세요.
  2. 각 대시보드 JSON 파일을 개별적으로 가져오는 방법을 따릅니다.

또는 모든 대시보드를 Grafana 인스턴스로 가져올 수 있습니다. 이 프로세스에 대한 자세한 정보는 GitLab Grafana 대시보드를 참조하세요.

GitLab UI와 통합하기

  • GitLab 12.1에서 소개되었습니다.

Grafana를 설정한 후, GitLab 사이드바에서 액세스할 수 있는 링크를 활성화할 수 있습니다:

  1. 왼쪽 사이드바에서 하단에 관리 영역을 선택합니다.
  2. 설정 > 지표 및 프로파일링을 선택합니다.
  3. 메트릭 - Grafana를 확장합니다.
  4. Grafana로의 링크 추가 확인란을 선택합니다.
  5. Grafana URL을 구성합니다. Grafana 인스턴스의 전체 URL을 입력합니다.
  6. 변경 사항 저장을 선택합니다.

GitLab은 관리 > 모니터링 > 메트릭 대시보드 아래에서 링크를 표시합니다.

필수 스코프

  • GitLab 13.10에서 소개되었습니다.

위의 프로세스를 통해 Grafana를 설정할 때, 관리 영역 > 애플리케이션 > GitLab Grafana 화면에는 스코프가 표시되지 않습니다. 그러나 read_user 스코프는 필요하며, 애플리케이션에 자동으로 제공됩니다. read_user를 포함하고 있지 않고 read_user를 포함한 스코프 이외의 스코프를 설정하면 GitLab을 OAuth 제공자로 사용하여 로그인하려고 할 때 다음 오류가 발생합니다. 

The requested scope is invalid, unknown, or malformed.

이 오류가 표시되면 GitLab Grafana 구성 화면에서 다음 중 하나가 사실인지 확인하세요:

  • 스코프가 표시되지 않습니다.
  • read_user 스코프가 포함되어 있습니다.