성능 표시 막대

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

성능 표시 막대를 표시하여 GitLab UI 페이지의 성능 통계를 볼 수 있습니다. 예를 들면:

Performance bar

이용 가능한 정보

왼쪽에서 오른쪽으로, 성능 표시 막대는 다음을 표시합니다:

  • 현재 호스트: 페이지를 제공하는 현재 호스트입니다.
  • 데이터베이스 쿼리: 소요된 시간(밀리초)과 데이터베이스 쿼리의 총 수를 00ms / 00 (00 cached) pg 형식으로 표시합니다. 자세한 내용을 표시하려면 선택하세요. 각 쿼리에 대해 다음을 볼 수 있습니다:
    • 트랜잭션 내: 해당 쿼리가 트랜잭션의 맥락에서 실행되면 아래에 표시됩니다
    • 롤: 데이터베이스 로드 밸런싱이 활성화되면 표시됩니다. 사용된 서버 역할을 보여줍니다. “Primary”는 쿼리가 읽기/쓰기 프라이머리 서버로 전송되었음을 의미하고, “Replica”는 읽기 전용 레플리카로 전송되었음을 의미합니다.
    • 구성 이름: 이는 다른 GitLab 기능을 구성한 것과 구별하기 위해 사용됩니다. 표시된 이름은 GitLab에서 데이터베이스 연결을 구성하는 데 사용된 이름과 동일합니다.
  • Gitaly 호출: 소요된 시간(밀리초)과 총 Gitaly 호출 수를 표시합니다. 자세한 내용을 표시하려면 선택하세요.
  • Redis 호출: 소요된 시간(밀리초)과 총 Redis 호출 수를 표시합니다. 자세한 내용을 표시하려면 선택하세요.
  • Elasticsearch 호출: 소요된 시간(밀리초)과 총 Elasticsearch 호출 수를 표시합니다. 자세한 내용을 표시하려면 선택하세요.
  • 외부 HTTP 호출: 다른 시스템으로의 외부 호출에 소요된 시간(밀리초)과 총 수를 표시합니다. 자세한 내용을 표시하려면 선택하세요.
  • 페이지 로드 시간: 브라우저에서 로드 시간을 지원하는 경우, 슬래시로 구분된 여러 값이 밀리초 단위로 표시됩니다. 선택하여 자세한 내용을 표시하세요. 값은 왼쪽에서 오른쪽으로 다음과 같습니다:
    • Backend: 기본 페이지 로드에 필요한 시간.
    • First Contentful Paint: 사용자에게 뭔가가 보이기 시작한 시간. 브라우저가 이 기능을 지원하지 않으면 NaN이 표시됩니다.
    • DomContentLoaded 이벤트.
    • 페이지 로드된 총 요청 수.
  • 메모리: 선택한 요청 중에 사용된 메모리 양과 할당된 객체를 표시합니다. 자세한 내용을 표시하려면 선택하세요.
  • Trace: Jaeger가 통합된 경우, Trace는 현재 요청의 correlation_id가 포함된 Jaeger 추적 페이지로 연결됩니다.
  • +: 요청의 세부 정보를 성능 표시 막대에 추가하는 링크입니다. 요청은 현재 사용자로 인증된 상태의 전체 URL 또는 X-Request-Id 헤더의 값으로 추가할 수 있습니다.
  • 다운로드: 성능 표시 막대 보고서를 생성하는 데 사용된 원시 JSON을 다운로드하는 링크입니다.
  • 메모리 보고서: 현재 URL의 메모리 프로파일링 보고서를 생성하는 링크입니다.
  • Flamegraph와 모드: 선택한 Stackprof 모드로 현재 URL의 flamegraph를 생성하는 링크입니다:
    • Wall 모드는 벽 시계의 시간 간격마다 샘플링됩니다. 간격은 10100 마이크로초로 설정됩니다.
    • CPU 모드는 CPU 활동의 간격마다 샘플링됩니다. 간격은 10100 마이크로초로 설정됩니다.
    • Object 모드는 간격마다 샘플링됩니다. 간격은 100 할당으로 설정됩니다.
  • 요청 선택기: 현재 페이지를 열 때 생성된 요청을 위해 이러한 메트릭을 볼 수 있도록 하는 성능 표시 막대 오른쪽에 표시된 선택상자입니다. 고유 URL 당 처음 두 요청만 캡처됩니다.
  • Stats (옵션): GITLAB_PERFORMANCE_BAR_STATS_URL 환경 변수가 설정된 경우, 이 URL이 막대에 표시됩니다. GitLab 13.9 이후에서는 GitLab SaaS에서만 사용됩니다.

참고: 모든 표시기가 모든 환경에서 사용 가능한 것은 아닙니다. 예를 들어 메모리 보기는 특정 패치가 적용된 Ruby에서 실행해야 합니다. 특정 패치가 적용된 Ruby로 GitLab을 로컬에서 실행하는 경우에는 일반적으로 해당되지 않으며 메모리 보기를 사용할 수 없습니다.

키보드 바로 가기

성능 바를 표시하려면 p + b 키보드 바로 가기를 누르세요. 다시 눌러 숨기세요.

관리자가 아닌 사용자가 성능 바를 표시하려면 그들을 위해 활성화해야 합니다.

요청 경고

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

Gitaly 호출 지속 시간이 임계값을 초과했습니다

관리자가 아닌 사용자를 위해 성능 바 활성화

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

  1. 관리자 액세스 권한을 가진 사용자로서 로그인하세요.
  2. 왼쪽 사이드바에서 맨 아래쪽에 관리자 영역을 선택하세요.
  3. 설정 > 메트릭 및 프로파일링을 선택하세요.
  4. 프로파일링 - 성능 바를 확장하세요.
  5. 비 관리자에게 성능 바 액세스를 허용을 선택하세요.
  6. 다음 그룹의 회원에게 액세스를 허용 필드에, 성능에 액세스할 수 있는 그룹의 전체 경로를 입력하세요.
  7. 변경 사항 저장을 선택하세요.