Grafana 구성

Tier: Free, Premium, Ultimate Offering: Self-managed

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

GitLab 대시보드 가져오기

시작하기 위해 기본 대시보드 세트를 가져올 수 있습니다. GitLab은 시작을 도와주는 기본 Grafana 대시보드 세트를 게시했습니다. 사용 방법은 다음과 같습니다:

  1. 리포지터리를 복제하거나 ZIP 파일 또는 tar볼을 다운로드합니다.
  2. 각 대시보드 JSON 파일을 개별적으로 가져오는 단계를 따릅니다.

또는 모든 대시보드를 Grafana에 가져올 수 있습니다. 이 프로세스에 대한 자세한 내용은 GitLab Grafana 대시보드를 참조하십시오.

GitLab UI와 통합

Grafana 설정을 완료한 후에는 GitLab 측면 링크를 활성화할 수 있습니다:

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

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

필수 스코프

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

요청된 스코프가 잘못되었거나 알 수 없거나 형식이 잘못되었습니다.

이 오류가 표시되면 GitLab Grafana 구성 화면에서 다음 중 하나가 참인지 확인합니다:

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