성능 표시줄

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

GitLab UI 페이지의 성능 통계를 확인하려면 성능 표시줄을 표시할 수 있습니다. 예시:

Performance bar

사용 가능한 정보

History
  • Rugged calls removed in GitLab 16.6.

왼쪽에서 오른쪽으로, 성능 표시줄에는 다음이 표시됩니다.

  • 현재 호스트: 페이지를 제공하는 현재 호스트.
  • 데이터베이스 쿼리: 소요된 시간(밀리초) 및 총 데이터베이스 쿼리 수를 00ms / 00 (00 cached) pg 형식으로 표시합니다. 자세한 내용을 표시하려면 대화 상자를 선택합니다. 각 쿼리에 대한 다음 내용을 볼 수 있습니다.
    • 트랜잭션 진행 중: 쿼리가 트랜잭션의 컨텍스트에서 실행된 경우 쿼리 아래에 표시됩니다.
    • Role: Database Load Balancing이 활성화된 경우에 표시됩니다. 쿼리에 사용된 서버 역할을 보여줍니다. “Primary”는 쿼리가 읽기/쓰기 기본 서버로 전송되었음을 의미하고, “Replica”는 읽기 전용 복제본으로 전송되었음을 의미합니다.
    • Configuration name: 이는 서로 다른 GitLab 기능을 구성하는 다른 데이터베이스를 구분하는 데 사용됩니다. 표시된 이름은 GitLab에서 데이터베이스 연결을 구성하는 데 사용하는 동일한 이름입니다.
  • Gitaly 호출: 소요된 시간(밀리초)과 총 Gitaly 호출 수를 표시합니다. 자세한 내용을 표시하려면 모달 창을 선택합니다.
  • Redis 호출: 소요된 시간(밀리초) 및 총 Redis 호출 수를 표시합니다. 자세한 내용을 표시하려면 모달 창을 선택합니다.
  • Elasticsearch 호출: 소요된 시간(밀리초) 및 총 Elasticsearch 호출 수를 표시합니다. 자세한 내용을 표시하려면 모달 창을 선택합니다.
  • 외부 HTTP 호출: 다른 시스템으로의 외부 호출의 소요된 시간(밀리초)과 총 호출 수를 표시합니다. 자세한 내용을 표시하려면 모달 창을 선택합니다.
  • 페이지의 로드 타이밍: 브라우저가 로드 타이밍을 지원하는 경우 슬래시로 구분된 여러 값(밀리초)을 표시합니다. 자세한 내용을 표시하려면 모달 창을 선택합니다. 왼쪽부터 순서대로 다음 값들이 표시됩니다:
    • Backend: 기본 페이지 로드에 필요한 시간.
    • First Contentful Paint: 사용자에게 무언가가 표시되기까지의 시간을 나타냅니다. 브라우저가 이 기능을 지원하지 않으면 NaN이 표시됩니다.
    • DomContentLoaded 이벤트.
    • 페이지가 로드한 총 요청 수.
  • 메모리: 선택된 요청 중에 사용된 메모리 양과 할당된 객체를 표시합니다. 자세한 내용을 표시하려면 선택합니다.
  • 트레이스: Jaeger가 통합된 경우, 트레이스는 현재 요청의 correlation_id가 포함된 Jaeger 추적 페이지로 연결됩니다.
  • +: 요청의 세부 정보를 성능 표시줄에 추가하는 링크입니다. 요청은 현재 사용자로 인증된 전체 URL 또는 X-Request-Id 헤더의 값으로 추가할 수 있습니다.
  • 다운로드: 성능 표시줄 보고서를 생성하는 데 사용된 원시 JSON을 다운로드할 수 있는 링크입니다.
  • 메모리 보고서: 현재 URL의 메모리 프로파일링 보고서를 생성하는 링크입니다.
  • 선택된 스택프로필 모드로 현재 URL의 플레임그래프를 생성하는 링크: 오른쪽의 선택 상자에서 선택한 스택프로필 모드로 현재 URL의 플레임그래프를 생성하는 링크입니다:
    • Wall: 벽시간(clock on a wall)의 간격별로 샘플링합니다. 간격은 10100 마이크로초로 설정됩니다.
    • CPU: CPU 활동의 간격별로 샘플링합니다. 간격은 10100 마이크로초로 설정됩니다.
    • Object: 간격별로 샘플링합니다. 간격은 100 할당으로 설정됩니다.
  • 요청 선택기: 성능 표시줄 오른쪽에 표시되는 선택 상자로, 현재 페이지가 열려 있는 동안 발생한 요청에 대한 이러한 지표를 보여줍니다. 고유 URL 당 처음 두 개의 요청만 캡처됩니다.
  • 통계(옵션): GITLAB_PERFORMANCE_BAR_STATS_URL 환경 변수가 설정된 경우, 이 URL이 표시됩니다. GitLab.com에서만 사용됩니다.
note
모든 표시기가 모든 환경에서 사용할 수 있는 것은 아닙니다. 예를 들어, 메모리 보기는 특정 패치 가 적용된 Ruby에서 실행해야 합니다. GDK를 사용하여 GitLab을 로컬에서 실행하는 경우에는 일반적으로 해당되지 않으며 메모리 보기를 사용할 수 없습니다.

키보드 바로 가기

p + b 키보드 바로 가기를 눌러 성능 표시줄을 표시하고, 다시 눌러 숨깁니다.

성능 표시줄을 표시하려면 관리자가 아닌 사용자는 이를 활성화해야 합니다.

요청 경고

미리 정의된 한도를 초과하는 요청은 경고 caution아이콘과 해당 지표 옆에 설명이 표시됩니다. 이 예에서 Gitaly 호출 시간이 임계값을 초과했습니다.

Gitaly call duration exceeded threshold

관리자가 아닌 사용자를 위해 성능 표시줄 활성화

기본적으로 성능 표시줄은 관리자가 아닌 사용자에게 비활성화되어 있습니다. 특정 그룹에 대해 활성화하려면:

  1. 관리자 액세스 권한이 있는 사용자로서 로그인합니다.
  2. 왼쪽 사이드바에서 가장 아래쪽에 있는 관리 영역을 선택합니다.
  3. 설정 > 메트릭 및 프로파일링을 선택합니다.
  4. 프로파일링 - 성능 표시줄을 확장합니다.
  5. 비관리자에게 성능 표시줄 액세스 허용을 선택합니다.
  6. 다음 그룹 멤버에게 액세스 허용 필드에 대상 그룹의 전체 경로를 제공합니다.
  7. 변경 사항 저장을 선택합니다.