Skip to main content

Enterprise Server 3.21 은(는) 현재 릴리스 후보로 제공됩니다.

Grafana를 사용하여 OpenTelemetry 메트릭 분석

OpenTelemetry 메트릭 스택에서 제공하는 대시보드 및 메트릭을 사용하여 인스턴스의 상태 및 성능을 모니터링합니다.

필수 조건

인스턴스에서 OpenTelemetry 메트릭을 사용하도록 설정해야 합니다. 구성 지침은 인스턴스에 대한 OpenTelemetry 구성을 참조하세요.

  1. 페이지의 오른쪽 상단에 있는 GitHub Enterprise Server의 관리 계정에서 을 클릭합니다.
  2. “Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다.
  3. " 사이트 관리자" 사이드바에서 관리 콘솔 을 클릭합니다.
  4. 여러 관리 콘솔 사용자 계정을 만든 경우 루트 사이트 관리자** 또는 관리 콘솔 사용자를 선택합니다**. 관리 콘솔 사용자 계정에 대한 자세한 내용은 관리 콘솔에 대한 액세스 관리을(를) 참조하세요.
  5. 관리 콘솔 자격 증명을 입력합니다. 계속을 클릭합니다.
  6. 모니터 탭을 클릭합니다.

메트릭 레이블

OpenTelemetry 스택 내보내기는 자동으로 메트릭에 레이블을 연결합니다. 일반적인 레이블은 다음과 같습니다.

  • job - 메트릭을 생성한 내보내기 프로그램의 이름
  • instance — 메트릭이 시작된 인스턴스 이름

일부 내보내기(예: node_exporter 또는 haproxy_exporter)의 경우, job 레이블 값을 검색하여 오픈 소스 설명서를 찾을 수 있습니다.

레이블 가용성은 내보내기 및 메트릭에 따라 다릅니다. 일부 GitHub 애플리케이션 수준 메트릭은 인프라/내보내기 메트릭보다 적은 레이블을 제공할 수 있으며 레이블은 버전에서 버전으로 변경될 수 있습니다.

패널 질의 검사

중요

미리 빌드된 대시보드는 검사를 위해 열고 편집할 수 있지만 변경 내용을 저장할 수는 없습니다. 대시보드의 복사본을 만들어 사용자 지정을 적용하고 유지합니다.

지정된 패널에 전원을 공급하는 메트릭 및 쿼리를 이해하려면 Grafana 대시보드를 볼 때 그래프 패널 메뉴 (세로 점 3개) 를 사용합니다.

  • 편집: 패널 편집기를 엽니다. 시각화를 구동하는 쿼리를 검토하고 조정하는 가장 직접적인 방법입니다.
  • 탐색: 패널의 쿼리가 미리 채워져 있는 Grafana 탐색을 열어 대화형 분석을 허용합니다.
  • 메트릭 드릴다운: 관련 메트릭을 검색하고 레이블 값별로 메트릭을 세분화하기 위한 사이드 패널을 엽니다.

Grafana에서 메트릭 탐색

Grafana는 인스턴스에서 사용할 수 있는 메트릭을 검색하고 분석하는 여러 가지 방법을 제공합니다.

Grafana 드릴다운

Grafana Drilldown은 메트릭 접두사, 레이블 및 레이블 값을 필터링하여 메트릭을 검색하는 안내 워크플로를 제공합니다. 메트릭을 선택한 후 Grafana는 사용 가능한 레이블 값으로 계열을 분석할 수 있습니다. 예를 들어 haproxy_backend_response_errors_total 프록시/백 엔드 레이블 값을 기준으로 그룹화할 수 있습니다.

Grafana 탐색

Grafana Explore를 사용하면 사용자가 사용 가능한 메트릭 및 레이블을 검색하는 데 도움이 되는 쿼리 작성기를 포함하여 PromQL(Prometheus 쿼리 언어)을 사용하여 대화형 분석을 수행할 수 있습니다.

Grafana Explore 기능에서 작업하기 위한 팁:

  • 코드 모드의 메트릭 브라우저를 사용하여 메트릭 및 레이블을 검색합니다. 레이블 및 레이블 값을 선택하면 연결된 메트릭이 표시될 수 있으며 메트릭을 선택하면 연결된 레이블 및 레이블 값이 표시될 수 있습니다.
  • 메트릭을 선택한 후 쿼리를 구체화하는 제안에 대한 작성기 모드 로 전환합니다.
    • 작업 단추를 통해 추가 작업에 액세스합니다 .
  • 옵션 패널의 범례 설정을 사용하여 범례 레이블을 사용자 지정하세요, 예를 들어 false. Grafana는 기본적으로 고유한 레이블 집합을 기준으로 범례 레이블을 구분하여 할당합니다.

추가 읽기