GitLab Prometheus 메트릭

요약

GitLab Prometheus 메트릭을 활성화하려면 다음 단계를 따릅니다. 직접 컴파일한 설치의 경우 직접 구성해야 합니다. GitLab은 자체 내부 서비스 메트릭을 모니터링하며, 이를 /-/metrics 엔드포인트에서 사용할 수 있게 합니다.

GitLab Prometheus 메트릭을 활성화하려면 다음 단계를 따릅니다.

관리자 액세스 권한이 있는 사용자로 GitLab에 로그인합니다.
오른쪽 상단에서 Admin을 선택합니다.
왼쪽 사이드바에서 Settings > Metrics and profiling을 선택합니다.
Metrics - Prometheus 섹션을 찾아 Enable GitLab Prometheus metrics endpoint를 선택합니다.
변경 사항을 적용하려면 GitLab을 재시작합니다.

직접 컴파일한 설치의 경우 직접 구성해야 합니다.

메트릭 수집#

GitLab은 자체 내부 서비스 메트릭을 모니터링하며, 이를 /-/metrics 엔드포인트에서 사용할 수 있게 합니다. 다른 Prometheus 익스포터와 달리 메트릭에 액세스하려면 클라이언트 IP 주소가 명시적으로 허용되어야 합니다.

이 메트릭은 Linux 패키지 및 Helm 차트 설치에서 활성화되어 수집됩니다. 직접 컴파일한 설치에서는 이 메트릭을 수동으로 활성화하고 Prometheus 서버로 수집해야 합니다.

Sidekiq 노드에서 메트릭을 활성화하고 확인하는 방법은 Sidekiq 메트릭을 참고합니다.

사용 가능한 메트릭#

다음 메트릭을 사용할 수 있습니다.

메트릭	유형	버전	레이블	설명
`action_cable_active_connections`	Gauge	13.4	`server_mode`	현재 연결된 ActionCable WS 클라이언트 수
`action_cable_broadcasts_total`	Counter	13.10	`server_mode`	발생한 ActionCable 브로드캐스트 수
`action_cable_pool_current_size`	Gauge	13.4	`server_mode`	ActionCable 스레드 풀의 현재 워커 스레드 수
`action_cable_pool_largest_size`	Gauge	13.4	`server_mode`	ActionCable 스레드 풀에서 지금까지 관찰된 최대 워커 스레드 수
`action_cable_pool_max_size`	Gauge	13.4	`server_mode`	ActionCable 스레드 풀의 최대 워커 스레드 수
`action_cable_pool_min_size`	Gauge	13.4	`server_mode`	ActionCable 스레드 풀의 최소 워커 스레드 수
`action_cable_pool_pending_tasks`	Gauge	13.4	`server_mode`	ActionCable 스레드 풀에서 실행 대기 중인 작업 수
`action_cable_pool_tasks_total`	Gauge	13.4	`server_mode`	ActionCable 스레드 풀에서 실행된 총 작업 수
`action_cable_single_client_transmissions_total`	Counter	13.10	`server_mode`	모든 채널에서 클라이언트에 전송된 ActionCable 메시지 수
`action_cable_subscription_confirmations_total`	Counter	13.10	`server_mode`	확인된 클라이언트의 ActionCable 구독 수
`action_cable_subscription_rejections_total`	Counter	13.10	`server_mode`	거부된 클라이언트의 ActionCable 구독 수
`action_cable_transmitted_bytes_total`	Counter	16.0	`operation`, `channel`	ActionCable을 통해 전송된 총 바이트 수
`active_context_queue_size`	Gauge	18.7	`queue_name`, `shard`	각 ActiveContext 큐의 항목 수
`artifact_report_<report_type>_builds_completed_total`	Counter	15.3		보고서 유형별 아티팩트가 있는 완료된 CI 빌드 카운터(상태별 레이블)
`auto_devops_pipelines_completed_total`	Counter	12.7		완료된 Auto DevOps 파이프라인 카운터(상태별 레이블)
`cached_object_operations_total`	Counter	15.3	`controller`, `action`, `endpoint_id`	특정 웹 요청에 대해 캐시된 총 오브젝트 수
`ci_report_parser_duration_seconds`	Histogram	13.9	`parser`	CI/CD 보고서 아티팩트를 파싱하는 시간
`dependency_linker_usage`	Counter	16.8	`used_on`	의존성 링커가 사용된 횟수
`email_receiver_error`	Counter	14.1		수신 이메일을 처리할 때 발생한 총 오류 수
`failed_login_captcha_total`	Gauge	11.0		로그인 중 실패한 CAPTCHA 시도 카운터
`gitlab_application_rate_limiter_throttle_utilization_ratio`	Histogram	17.6	`throttle_key`, `peek`, `feature_category`	GitLab 애플리케이션 속도 제한기의 스로틀 활용률.
`gitaly_circuit_breaker_requests_total`	Counter	18.9	`circuit_state`, `result`, `reason`	총 Gitaly 요청 중 회로 차단기가 처리한 수. `result`는 `allowed`, `rejected`, `error` 중 하나입니다. `reason`은 오류 세부 정보를 제공합니다(예: `resource_exhausted`)
`gitaly_circuit_breaker_transitions_total`	Counter	18.9	`from_state`, `to_state`	회로 차단기 상태 전환의 총 횟수. 상태는 `closed`, `open`입니다. 엔드포인트 및 스토리지에 대한 자세한 정보는 구조화된 로그에서 확인할 수 있습니다
`gitlab_audit_event_streaming_nats_consumer_lag_seconds`	Histogram	19.3	`feature_category`	감사 이벤트 스트리밍 NATS 컨슈머 지연(게시부터 디스패치까지)(초)
`gitlab_audit_event_streaming_nats_consumer_unreachable_total`	Counter	19.4	`feature_category`	NATS에 연결할 수 없어 중단된 감사 이벤트 컨슈머 드레인 수
`gitlab_audit_event_streaming_nats_dispatch_destination_error_total`	Counter	19.4	`feature_category`	대상 측 오류로 실패한 감사 이벤트 배치 디스패치 수(오류가 아니라 저하 비율)
`gitlab_audit_event_streaming_nats_publish_duration_seconds`	Histogram	19.4	`feature_category`	감사 이벤트 스트리밍 NATS 동기 게시 소요 시간(초)
`gitlab_audit_event_streaming_nats_publish_fallback_total`	Counter	19.3	`feature_category`	NATS에서 Sidekiq으로 폴백된 감사 이벤트 게시 수(오류가 아니라 저하 비율)
`gitlab_audit_event_streaming_nats_publish_total`	Counter	19.3	`feature_category`	NATS를 통한 감사 이벤트 게시 시도 수
`gitlab_authorized_projects_safety_net_refresh_rows_total`	Counter	19.3	`trigger`, `direction`	세이프티 넷 새로고침으로 추가되거나 삭제된 `project_authorizations` 행의 총 수
`gitlab_blob_embeds_total`	Counter	19.4	`outcome`	Blob 임베드 렌더링 시도의 총 수. 결과는 `rendered`, `unrenderable`, `unauthorized`, `project_not_found`, `embed_limit_exceeded`, `email_preview_disabled` 중 하나입니다.
`gitlab_bootsnap_compile_cache_events_total`	Counter	19.3	`event`	부팅 중 관찰된 Bootsnap 컴파일 캐시 이벤트 수(유형별 `hit`, `revalidated`, `miss`, `stale`). 적중률은 `(hit + revalidated) / total`입니다
`gitlab_cache_misses_total`	Counter	10.2	`controller`, `action`, `store`, `endpoint_id`	캐시 읽기 미스
`gitlab_cache_operation_duration_seconds`	Histogram	10.2	`operation`, `store`, `endpoint_id`	캐시 액세스 시간
`gitlab_cache_operations_total`	Counter	12.2	`controller`, `action`, `operation`, `store`, `endpoint_id`	컨트롤러 또는 액션별 캐시 작업
`gitlab_cache_read_multikey_count`	Histogram	15.7	`controller`, `action`, `store`, `endpoint_id`	멀티키 캐시 읽기 작업의 키 수
`gitlab_ci_active_jobs`	Histogram	14.2		파이프라인 생성 시 활성 job 수
`gitlab_ci_build_trace_errors_total`	Counter	14.4	`error_reason`	빌드 추적에서 다양한 오류 유형의 총 수
`gitlab_ci_current_queue_size`	Gauge	16.3		초기화된 CI/CD 빌드 큐의 현재 크기
`gitlab_ci_job_failure_reasons`	Counter	13.11	`reason`, `runner_type`	job 실패 사유 카운터. `runner_type` 레이블은 GitLab 19.3에서 추가되었습니다. `reason` 레이블 값은 CI/CD 실패 사유 메트릭을 참고합니다
`gitlab_ci_job_token_authorization_failures`	Counter	17.11	`same_root_ancestor`	CI JOB 토큰을 통한 실패한 인가 시도 수
`gitlab_ci_job_token_inbound_access`	Counter	17.2		CI job 토큰을 통한 인바운드 액세스 수
`gitlab_ci_pipeline_builder_scoped_variables_duration`	Histogram	14.5		CI/CD job에 대한 스코프 변수를 생성하는 데 걸리는 시간(초)
`gitlab_ci_pipeline_creation_duration_seconds`	Histogram	13.0	`gitlab`	CI/CD 파이프라인을 생성하는 데 걸리는 시간(초)
`gitlab_ci_pipeline_failure_reasons`	Counter	13.11	`reason`	파이프라인 실패 사유 카운터. `reason` 레이블 값은 CI/CD 실패 사유 메트릭을 참고합니다
`gitlab_ci_pipeline_security_orchestration_policy_processing_duration_seconds`	Histogram	13.12		CI/CD 파이프라인에서 보안 정책을 처리하는 데 걸리는 시간(초)
`gitlab_ci_pipeline_size_builds`	Histogram	13.1	`source`	파이프라인 소스별로 그룹화된 파이프라인 내 총 빌드 수
`gitlab_ci_pipeline_time_to_finished_seconds`	Histogram	19.2	`source`, `status`	파이프라인 생성부터 완료 상태(성공, 실패 또는 취소)까지의 실제 경과 시간(초)
`gitlab_ci_queue_depth_total`	Histogram	16.3		작업 결과와 관련된 CI/CD 빌드 큐의 크기
`gitlab_ci_queue_iteration_duration_seconds`	Histogram	16.3		CI/CD 큐에서 빌드를 찾는 데 걸리는 시간
`gitlab_ci_queue_operations_total`	Counter	16.3		큐 내부에서 발생하는 모든 작업 수
`gitlab_ci_queue_retrieval_duration_seconds`	Histogram	16.3		빌드 큐를 검색하기 위한 SQL 쿼리 실행 시간
`gitlab_ci_queue_size_total`	Histogram	16.3		초기화된 CI/CD 빌드 큐의 크기
`gitlab_ci_runner_authentication_failure_total`	Counter	15.2		러너 인증 실패 총 횟수
`gitlab_ci_runner_authentication_success_total`	Counter	15.2	`type`	러너 인증 성공 총 횟수
`gitlab_ci_trace_bytes_total`	Counter	13.4		전송된 빌드 추적 총 바이트 수
`gitlab_ci_trace_finalize_duration_seconds`	Histogram	13.6		빌드 추적 청크를 오브젝트 스토리지로 마이그레이션하는 기간
`gitlab_ci_trace_operations_total`	Counter	13.4	`operation`	빌드 추적에 대한 다양한 작업의 총 수
`gitlab_connection_pool_available_count`	Gauge	16.7		풀에서 사용 가능한 연결 수
`gitlab_connection_pool_size`	Gauge	16.7		연결 풀 크기
`gitlab_database_transaction_seconds`	Histogram	12.1		데이터베이스 트랜잭션에서 소요된 시간(초)
`gitlab_dependency_paths_found_total`	Counter	18.3	`cyclic`	지정된 의존성에 대해 발견된 상위 의존성 경로 수.
`gitlab_diffs_collection_real_duration_seconds`	Histogram	15.8	`controller`, `action`, `endpoint_id`	diffs 배치 요청에서 머지 리퀘스트 diff 파일 쿼리에 소요된 시간(초)
`gitlab_diffs_comparison_real_duration_seconds`	Histogram	15.8	`controller`, `action`, `endpoint_id`	diffs 배치 요청에서 비교 데이터를 가져오는 데 소요된 시간(초)
`gitlab_diffs_highlight_cache_decorate_real_duration_seconds`	Histogram	15.8	`controller`, `action`, `endpoint_id`	diffs 배치 요청에서 캐시에서 강조 표시된 줄을 설정하는 데 소요된 시간(초)
`gitlab_diffs_render_real_duration_seconds`	Histogram	15.8	`controller`, `action`, `endpoint_id`	diffs 배치 요청에서 diffs를 직렬화하고 렌더링하는 데 소요된 시간(초)
`gitlab_diffs_reorder_real_duration_seconds`	Histogram	15.8	`controller`, `action`, `endpoint_id`	diffs 배치 요청에서 diff 파일 재정렬에 소요된 시간(초)
`gitlab_diffs_unfold_real_duration_seconds`	Histogram	15.8	`controller`, `action`, `endpoint_id`	diffs 배치 요청에서 위치 전개에 소요된 시간(초)
`gitlab_diffs_unfoldable_positions_real_duration_seconds`	Histogram	15.8	`controller`, `action`	diffs 배치 요청에서 전개 가능한 노트 위치를 가져오는 데 소요된 시간(초)
`gitlab_diffs_write_cache_real_duration_seconds`	Histogram	15.8	`controller`, `action`, `endpoint_id`	diffs 배치 요청에서 강조 표시된 줄 및 통계를 캐시하는 데 소요된 시간(초)
`gitlab_external_http_duration_seconds`	Counter	13.8		외부 시스템에 대한 각 HTTP 호출에 소요된 시간(초)
`gitlab_external_http_exception_total`	Counter	13.8		외부 HTTP 호출 중 발생한 총 예외 수
`gitlab_external_http_total`	Counter	13.8	`controller`, `action`, `endpoint_id`	외부 시스템에 대한 총 HTTP 호출 수
`gitlab_find_dependency_paths_real_duration_seconds`	Histogram	18.3		지정된 컴포넌트의 상위 의존성 경로를 해결하는 데 소요된 시간(초).
`gitlab_ghost_user_migration_lag_seconds`	Gauge	15.6		고스트 사용자 마이그레이션을 위해 예약된 가장 오래된 레코드의 대기 시간(초)
`gitlab_ghost_user_migration_scheduled_records_total`	Gauge	15.6		예약된 고스트 사용자 마이그레이션의 총 수
`gitlab_graphql_return_type_conflicts_total`	Counter	19.4	`field`, `operation`, `types`	같은 응답 키에 대해 일치하지 않는 타입을 선택한 GraphQL 쿼리 수
`gitlab_highlight_usage`	Counter	16.8	`used_on`	`Gitlab::Highlight`가 사용된 횟수
`gitlab_http_router_rule_total`	Counter	17.4	`rule_action`, `rule_type`	HTTP Router 규칙의 `rule_action` 및 `rule_type` 발생 횟수
`gitlab_issuable_fast_count_by_state_failures_total`	Counter	13.5		Issue 및 Merge request 페이지에서 소프트 실패한 행 수 계산 작업 수
`gitlab_issuable_fast_count_by_state_total`	Counter	13.5		Issue 및 Merge request 페이지의 행 수 계산 작업 총 수
`gitlab_keeparound_refs_created_total`	Counter	16.10	`source`	실제로 생성된 keep-around refs 수
`gitlab_keeparound_refs_requested_total`	Counter	16.10	`source`	생성 요청된 keep-around refs 수
`gitlab_memwd_violations_handled_total`	Counter	15.9		Ruby 프로세스 메모리 위반이 처리된 총 횟수
`gitlab_memwd_violations_total`	Counter	15.9		Ruby 프로세스가 메모리 임계값을 위반한 총 횟수
`gitlab_method_call_duration_seconds`	Histogram	10.2	`controller`, `action`, `module`, `method`	메서드 호출 실제 기간
`gitlab_omniauth_login_total`	Counter	16.1	`omniauth_provider`, `status`	OmniAuth 로그인 시도 총 수
`gitlab_openbao_request_duration_seconds`	Histogram	19.4	`operation`, `outcome`	Rails에서 OpenBao로 보낸 각 HTTP 호출의 소요 시간(초). Premium 및 Ultimate만 해당.
`gitlab_openbao_request_errors_total`	Counter	19.4	`operation`, `error_type`	Rails에서 OpenBao로 보낸 HTTP 호출 중 실패한 호출 수(장애 유형별). Premium 및 Ultimate만 해당.
`gitlab_openbao_requests_total`	Counter	19.4	`operation`, `method`, `outcome`	Rails에서 OpenBao로 보낸 HTTP 호출의 총 수. Premium 및 Ultimate만 해당.
`gitlab_page_out_of_bounds`	Counter	12.8	`controller`, `action`, `bot`	PageLimiter 페이지네이션 제한 도달 카운터
`gitlab_plan_tier_lookups_total`	Counter	19.5	`subject`, `result`	플랜 티어 조회 수. `subject`는 `user` 또는 `namespace`입니다. `result`는 요청별 저장소나 Redis가 응답하면 `hit`이고, 조회가 데이터베이스를 질의하면 `miss`입니다. ID가 없는 조회는 계산하지 않습니다. 한 요청 안의 두 조회는 같은 캐시 키로 해석될 때만 요청별 저장소를 재사용합니다. 예를 들어 배포 토큰이 자신의 네임스페이스가 요청 대상 네임스페이스인 경우가 그렇습니다. 따라서 적중률이 아니라 `miss` 비율에 알림을 설정합니다
`gitlab_presentable_object_cacheless_render_real_duration_seconds`	Histogram	15.3	`controller`, `action`, `endpoint_id`	특정 웹 요청 오브젝트를 캐싱하고 표현하는 데 소요된 실제 시간
`gitlab_rack_attack_events_total`	Counter	17.6	`event_type`, `event_name`	Rack Attack에서 처리된 총 이벤트 수.
`gitlab_rack_attack_throttle_limit`	Gauge	17.6	`event_name`	Rack Attack이 클라이언트를 스로틀하기 전에 만들 수 있는 최대 요청 수.
`gitlab_rack_attack_throttle_period_seconds`	Gauge	17.6	`event_name`	Rack Attack이 클라이언트를 스로틀하기 전에 클라이언트에 대한 요청이 집계되는 기간.
`gitlab_rails_boot_time_seconds`	Gauge	14.8		Rails 기본 프로세스가 시작을 완료하기까지 경과된 시간
`gitlab_rails_queue_duration_seconds`	Histogram	9.4		GitLab Workhorse가 Rails에 요청을 전달하는 것 사이의 지연 시간 측정
`gitlab_rate_limiter_git_basic_auth_ban_events_total`	Counter	19.4	`event`	Git 및 컨테이너 레지스트리 인증 IP 차단 이벤트 수. `event`는 `failure`, `ban`, `blocked`, `already_banned`, `reset` 중 하나입니다
`gitlab_ref_cache_operations_total`	Counter	19.4	`operation`, `ref_type`, `status`	결과별 ref 캐시 작업 수. `operation`은 `fetch`, `search`, `include`, `update`, `rebuild` 중 하나입니다. `ref_type`은 `branch`, `tag`, `unknown` 중 하나입니다. `fetch`, `search`, `include`의 경우 `status`는 `hit`, `miss_untrusted`, `miss_absent`, `error` 중 하나입니다. `miss_untrusted`는 집합이 존재하지만 신뢰할 수 없거나, 캐시 재빌드가 Redis 키가 없는 빈 집합을 만드는 복구 가능한 미스를 의미합니다. `miss_absent`는 멤버를 생성한 콜드 읽기를 의미합니다. `update`의 경우 `status`는 `success`, `skipped`, `error` 중 하나입니다. `rebuild`의 경우 `status`는 `success`, `skipped_locked`, `skipped_trusted`, `error` 중 하나입니다. `update/skipped`에는 재빌드 중 큐에 추가되었다가 이후 조정(reconciliation) 과정에서 적용된 이중 쓰기가 포함됩니다.
`gitlab_ref_cache_trust_events_total`	Counter	19.4	`ref_type`, `event`	ref 캐시 신뢰 수명 주기 이벤트의 총 수. `ref_type`은 `branch`, `tag`, `unknown` 중 하나입니다. `event`는 `granted`, `revoked`, `grant_skipped` 중 하나입니다.
`gitlab_ruby_threads_max_expected_threads`	Gauge	13.3		애플리케이션 작업을 수행하기 위해 실행될 것으로 예상되는 최대 스레드 수
`gitlab_ruby_threads_running_threads`	Gauge	13.3		이름별 실행 중인 Ruby 스레드 수
`gitlab_secrets_manager_entitlement_resolutions_total`	Counter	19.4	`source`	Customers Portal에 조회한 Secrets Manager 엔타이틀먼트 확인 수. 오프라인 확인과 캐시된 확인은 계산하지 않습니다. `source`는 `live`(Customers Portal이 응답함), `lkg_stale`(Customers Portal에 연결할 수 없거나 HTTP 5xx 오류로 응답하여 GitLab이 마지막으로 확인된 정상 응답을 재사용함), `fail_closed`(확인에 실패하여 GitLab이 액세스를 거부함) 중 하나입니다. Premium 및 Ultimate만 해당.
`gitlab_security_policies_policy_creation_duration_seconds`	Histogram	17.6		정책 관련 구성을 생성하는 데 걸리는 시간
`gitlab_security_policies_policy_deletion_duration_seconds`	Histogram	17.6		정책 관련 구성을 삭제하는 데 걸리는 시간
`gitlab_security_policies_policy_sync_duration_seconds`	Histogram	17.6		정책 구성에 대한 정책 변경 사항을 동기화하는 데 걸리는 시간
`gitlab_security_policies_scan_execution_configuration_rendering_seconds`	Histogram	17.3		스캔 실행 정책 CI 구성을 렌더링하는 데 걸리는 시간
`gitlab_security_policies_scan_result_process_duration_seconds`	Histogram	16.7		머지 리퀘스트 승인 정책을 처리하는 데 걸리는 시간
`gitlab_security_policies_sync_opened_merge_requests_duration_seconds`	Histogram	17.6		정책 변경 후 열린 머지 리퀘스트를 동기화하는 데 걸리는 시간
`gitlab_security_policies_update_configuration_duration_seconds`	Histogram	17.6		정책 구성 변경에 대한 동기화를 예약하는 데 걸리는 시간
`gitlab_sli_openbao_client_calls_error_total`	Counter	19.4	`operation`	애플리케이션 SLI로 측정한, Rails에서 OpenBao로 보낸 HTTP 호출 중 실패한 호출 수. Premium 및 Ultimate만 해당.
`gitlab_sli_openbao_client_calls_total`	Counter	19.4	`operation`	애플리케이션 SLI로 측정한, Rails에서 OpenBao로 보낸 HTTP 호출의 총 수. Premium 및 Ultimate만 해당.
`gitlab_sli_rails_request_apdex_success_total`	Counter	14.4	`endpoint_id`, `feature_category`, `request_urgency`	긴급도별 목표 소요 시간을 충족한 성공 요청의 총 수. `gitlab_sli_rails_requests_apdex_total`로 나누면 성공 비율을 구할 수 있습니다
`gitlab_sli_rails_request_apdex_total`	Counter	14.4	`endpoint_id`, `feature_category`, `request_urgency`	총 요청 Apdex 측정 수.
`gitlab_sli_rails_request_error_total`	Counter	15.7	`endpoint_id`, `feature_category`, `request_urgency`, `error`	총 요청 오류 측정 수.
`gitlab_snowplow_events_total`	Counter	14.1		발생한 총 GitLab Snowplow 분석 계측 이벤트 수
`gitlab_snowplow_failed_events_total`	Counter	14.1		GitLab Snowplow 분석 계측 이벤트 발생 실패 총 수
`gitlab_snowplow_successful_events_total`	Counter	14.1		GitLab Snowplow 분석 계측 이벤트 발생 성공 총 수
`gitlab_spamcheck_request_duration_seconds`	Histogram	13.12		Rails와 스팸 방지 엔진 간의 요청 기간
`gitlab_sql_<role>_duration_seconds`	Histogram	13.10		`SCHEMA` 작업과 `BEGIN` / `COMMIT`을 제외한 SQL 실행 시간(데이터베이스 역할(primary/replica)별로 그룹화)
`gitlab_sql_duration_seconds`	Histogram	10.2		`SCHEMA` 작업과 `BEGIN` / `COMMIT`을 제외한 SQL 실행 시간
`gitlab_transaction_cache_<key>_count_total`	Counter	10.2		총 Rails 캐시 호출 카운터(키별)
`gitlab_transaction_cache_<key>_duration_total`	Counter	10.2		Rails 캐시 호출에 소요된 총 시간 카운터(초, 키별)
`gitlab_transaction_cache_count_total`	Counter	10.2		총 Rails 캐시 호출 카운터(집계)
`gitlab_transaction_cache_duration_total`	Counter	10.2		Rails 캐시 호출에 소요된 총 시간 카운터(초, 집계)
`gitlab_transaction_cache_read_hit_count_total`	Counter	10.2	`controller`, `action`, `store`, `endpoint_id`	Rails 캐시 호출에 대한 캐시 히트 카운터
`gitlab_transaction_cache_read_miss_count_total`	Counter	10.2	`controller`, `action`, `store`, `endpoint_id`	Rails 캐시 호출에 대한 캐시 미스 카운터
`gitlab_transaction_db_<role>_cached_count_total`	Counter	13.1	`controller`, `action`, `endpoint_id`	캐시된 SQL 호출 총 수 카운터(데이터베이스 역할별 그룹화)
`gitlab_transaction_db_<role>_count_total`	Counter	13.10	`controller`, `action`, `endpoint_id`	SQL 호출 총 수 카운터(데이터베이스 역할별 그룹화)
`gitlab_transaction_db_<role>_wal_cached_count_total`	Counter	14.1	`controller`, `action`, `endpoint_id`	캐시된 WAL 쿼리 총 수 카운터(데이터베이스 역할별 그룹화)
`gitlab_transaction_db_<role>_wal_count_total`	Counter	14.0	`controller`, `action`, `endpoint_id`	WAL 쿼리 총 수 카운터(데이터베이스 역할별 그룹화)
`gitlab_transaction_db_cached_count_total`	Counter	13.1	`controller`, `action`, `endpoint_id`	캐시된 SQL 호출 총 수 카운터
`gitlab_transaction_db_count_total`	Counter	13.1	`controller`, `action`, `endpoint_id`	SQL 호출 총 수 카운터
`gitlab_transaction_db_write_count_total`	Counter	13.1	`controller`, `action`, `endpoint_id`	쓰기 SQL 호출 총 수 카운터
`gitlab_transaction_duration_seconds`	Histogram	10.2	`controller`, `action`, `endpoint_id`	성공한 요청의 소요 시간(`gitlab_transaction_*` 메트릭)
`gitlab_transaction_event_build_found_total`	Counter	9.4		API /jobs/request에서 빌드 발견 카운터
`gitlab_transaction_event_build_invalid_total`	Counter	9.4		API /jobs/request에서 동시성 충돌로 인한 빌드 무효 카운터
`gitlab_transaction_event_build_not_found_cached_total`	Counter	9.4		API /jobs/request에서 빌드를 찾을 수 없는 캐시된 응답 카운터
`gitlab_transaction_event_build_not_found_total`	Counter	9.4		API /jobs/request에서 빌드를 찾을 수 없는 카운터
`gitlab_transaction_event_change_default_branch_total`	Counter	9.4		리포지터리의 기본 브랜치가 변경될 때 카운터
`gitlab_transaction_event_create_repository_total`	Counter	9.4		리포지터리가 생성될 때 카운터
`gitlab_transaction_event_etag_caching_cache_hit_total`	Counter	9.4	`endpoint`	ETag 캐시 히트 카운터.
`gitlab_transaction_event_etag_caching_header_missing_total`	Counter	9.4	`endpoint`	ETag 캐시 미스 카운터 - 헤더 누락
`gitlab_transaction_event_etag_caching_key_not_found_total`	Counter	9.4	`endpoint`	ETag 캐시 미스 카운터 - 키를 찾을 수 없음
`gitlab_transaction_event_etag_caching_middleware_used_total`	Counter	9.4	`endpoint`	ETag 미들웨어 액세스 카운터
`gitlab_transaction_event_etag_caching_resource_changed_total`	Counter	9.4	`endpoint`	ETag 캐시 미스 카운터 - 리소스 변경됨
`gitlab_transaction_event_fork_repository_total`	Counter	9.4		리포지터리 포크 카운터(RepositoryForkWorker). 소스 리포지터리가 존재하는 경우에만 증가
`gitlab_transaction_event_import_repository_total`	Counter	9.4		리포지터리 임포트 카운터(RepositoryImportWorker)
`gitlab_transaction_event_patch_hard_limit_bytes_hit_total`	Counter	13.9		diff 패치 크기 제한 도달 카운터
`gitlab_transaction_event_push_branch_total`	Counter	9.4		모든 브랜치 푸시 카운터
`gitlab_transaction_event_rails_exception_total`	Counter	9.4		Rails 예외 수 카운터
`gitlab_transaction_event_remove_branch_total`	Counter	9.4		리포지터리에서 브랜치가 제거될 때 카운터
`gitlab_transaction_event_remove_repository_total`	Counter	9.4		리포지터리가 제거될 때 카운터
`gitlab_transaction_event_remove_tag_total`	Counter	9.4		어떤 리포지터리에서든 태그가 제거될 때의 카운터
`gitlab_transaction_event_sidekiq_exception_total`	Counter	9.4		Sidekiq 예외 카운터
`gitlab_transaction_event_stuck_import_jobs_total`	Counter	9.4	`projects_without_jid_count`, `projects_with_jid_count`	중단된 임포트 job 수
`gitlab_transaction_event_update_build_total`	Counter	9.4		API `/jobs/request/:id`의 빌드 업데이트 카운터
`gitlab_transaction_new_redis_connections_total`	Counter	9.4		새로운 Redis 연결 카운터
`gitlab_transaction_rails_queue_duration_total`	Counter	9.4	`controller`, `action`, `endpoint_id`	GitLab Workhorse가 Rails에 요청을 전달하는 것 사이의 지연 시간 측정
`gitlab_transaction_view_duration_total`	Counter	9.4	`controller`, `action`, `view`, `endpoint_id`	뷰 기간
`gitlab_view_rendering_duration_seconds`	Histogram	10.2	`controller`, `action`, `view`, `endpoint_id`	뷰 기간(히스토그램)
`gitlab_vulnerability_report_branch_comparison_cpu_duration_seconds`	Histogram	15.11		기본 브랜치 SQL 쿼리에 대한 취약점 보고서의 CPU 실행 기간
`gitlab_vulnerability_report_branch_comparison_real_duration_seconds`	Histogram	15.11		기본 브랜치 SQL 쿼리에 대한 취약점 보고서의 벽시계 실행 기간
`http_elasticsearch_requests_duration_seconds`	Histogram	13.1	`controller`, `action`, `endpoint_id`	웹 트랜잭션 중 Elasticsearch 요청 기간. Premium 및 Ultimate만 해당.
`http_elasticsearch_requests_total`	Counter	13.1	`controller`, `action`, `endpoint_id`	웹 트랜잭션 중 Elasticsearch 요청 수. Premium 및 Ultimate만 해당.
`http_zoekt_requests_duration_seconds`	Histogram	19.2	`controller`, `action`, `feature_category`, `endpoint_id`	웹 트랜잭션 중 Zoekt 서버에 대한 쿼리 시간. Premium 및 Ultimate만 해당.
`http_zoekt_requests_total`	Counter	19.2	`controller`, `action`, `feature_category`, `endpoint_id`	웹 트랜잭션 중 Zoekt 서버에 대한 호출 수. Premium 및 Ultimate만 해당.
`http_request_duration_seconds`	Histogram	9.4	`method`	성공적인 요청에 대한 Rack 미들웨어의 HTTP 응답 시간
`http_requests_total`	Counter	9.4	`method`, `status`	Rack 요청 수
`job_queue_duration_seconds`	Histogram	9.5		요청 처리 실행 시간
`job_register_attempts_failed_total`	Counter	9.5		러너가 job 등록에 실패한 횟수
`job_register_attempts_total`	Counter	9.5		러너가 job 등록을 시도하는 횟수
`pipeline_graph_link_calculation_duration_seconds`	Histogram	13.9		링크 계산에 소요된 총 시간(초)
`pipeline_graph_links_per_job_ratio`	Histogram	13.9		그래프당 job 대비 링크 비율
`pipeline_graph_links_total`	Histogram	13.9		그래프당 링크 수
`pipelines_created_total`	Counter	9.4	`source`, `partition_id`	생성된 파이프라인 카운터
`pipelines_finished_total`	Counter	19.2	`source`, `partition_id`, `status`	완료된 파이프라인 카운터(성공, 실패 또는 취소)
`rack_uncaught_errors_total`	Counter	9.4		처리되지 않은 오류를 처리하는 Rack 연결 수
`redis_cache_generation_duration_seconds`	Histogram	15.6	`cache_hit`, `cache_identifier`, `feature_category`, `backing_resource`	Redis 캐시를 생성하는 시간
`redis_hit_miss_operations_total`	Counter	15.6	`cache_hit`, `cache_identifier`, `feature_category`, `backing_resource`	Redis 캐시 히트 및 미스의 총 수
`search_advanced_boolean_settings`	Gauge	17.3	`name`	고급 검색 불리언 설정의 현재 상태
`search_advanced_index_repair_total`	Counter	17.3	`document_type`	인덱스 복구 작업 수
`service_desk_new_note_email`	Counter	14.0		새 Service Desk 댓글에 대한 이메일 알림 총 수
`service_desk_thank_you_email`	Counter	14.0		새 Service Desk 이메일에 대한 이메일 응답 총 수
`successful_login_captcha_total`	Gauge	11.0		로그인 중 성공한 CAPTCHA 시도 카운터
`upload_file_does_not_exist`	Counter	10.7		업로드 레코드가 파일을 찾을 수 없는 횟수.
`user_session_logins_total`	Counter	9.4		GitLab이 시작되거나 재시작된 이후 로그인한 사용자 수 카운터
`validity_check_network_errors_total`	Counter	18.6	`partner`, `error_class`	파트너 토큰 검증 API 호출 중 총 네트워크 오류. Ultimate만 해당.
`validity_check_partner_api_duration_seconds`	Histogram	18.6	`partner`	토큰 검증 요청에 대한 파트너 API 응답 시간(초). Ultimate만 해당.
`validity_check_partner_api_requests_total`	Counter	18.6	`partner`, `status`, `error_type`	성공/실패 상태를 포함한 총 파트너 API 검증 요청. Ultimate만 해당.
`validity_check_rate_limit_hits_total`	Counter	18.6	`limit_type`	파트너 토큰 검증 중 총 속도 제한 도달. Ultimate만 해당.

CI/CD 실패 사유 메트릭#

gitlab_ci_job_failure_reasons 및 gitlab_ci_pipeline_failure_reasons 카운터는 CI/CD job과 파이프라인이 실패한 이유를 기록합니다. 실패를 처리하는 프로세스가 카운터를 증가시키므로 같은 메트릭이 Rails(Puma)와 Sidekiq 메트릭 엔드포인트 모두에 나타납니다. 예를 들어 러너의 job 상태 업데이트는 Rails API가 처리하고, 다운스트림 파이프라인 생성은 Sidekiq에서 실행됩니다. 레이블 값의 의미는 두 엔드포인트에서 같습니다. 대시보드에서는 모든 엔드포인트의 값을 합산해야 합니다.

job 실패 사유#

gitlab_ci_job_failure_reasons의 reason 레이블은 job의 실패 사유를 기록합니다. 일반적인 값은 다음과 같습니다.

script_failure: job 스크립트 명령이 0이 아닌 종료 코드를 반환했습니다. docker, docker+machine, kubernetes 실행기에서는 이 값에 Docker 이미지 pull 실패도 포함됩니다. GitLab 19.1 이상에서는 잘못된 이미지 또는 태그로 인한 pull 실패가 runner_configuration_error로 기록되고, 접근할 수 없는 레지스트리로 인한 pull 실패는 runner_external_dependency_failure로 기록됩니다.
api_failure: job 중에 러너가 GitLab API와 통신하지 못했습니다. 예를 들어 job 트레이스를 전송하거나, 아티팩트를 업로드하거나, job 상태를 보고할 때 발생합니다.
runner_system_failure: job 스크립트와 관계없이 러너가 빌드 환경 또는 실행기를 준비하는 중에 실패했습니다.
job_execution_timeout: job이 해당 job에 설정된 최대 실행 시간을 초과했습니다.
downstream_pipeline_creation_failed: 트리거 job이 다운스트림 파이프라인을 생성하지 못했습니다.
unknown_failure: 특정 실패 사유가 기록되지 않았습니다.

전체 값 목록은 retry:when을 참고합니다.

파이프라인 실패 사유#

gitlab_ci_pipeline_failure_reasons의 reason 레이블은 파이프라인의 실패 사유를 기록합니다.

값	설명
`unknown_failure`	파이프라인 실패 사유를 알 수 없습니다.
`config_error`	CI/CD 구성 파일의 오류로 파이프라인이 실패했습니다.
`external_validation_failure`	외부 파이프라인 검증에 실패했습니다.
`user_not_verified`	사용자가 검증되지 않아 파이프라인이 실패했습니다.
`size_limit_exceeded`	파이프라인 크기 제한을 초과했습니다.
`job_activity_limit_exceeded`	파이프라인 job 활동 제한을 초과했습니다.
`deployments_limit_exceeded`	파이프라인 배포 제한을 초과했습니다.
`project_deleted`	파이프라인과 연결된 프로젝트가 삭제되었습니다.
`filtered_by_rules`	`rules`로 모든 job이 제외되어 파이프라인이 생성되지 않았습니다. 이 값은 예상된 동작입니다.
`filtered_by_workflow_rules`	최상위 `workflow:rules`가 파이프라인 실행을 막았습니다. 이 값은 예상된 동작입니다.
`composite_identity_forbidden`	코드를 AI가 아닌 사용자가 먼저 검토해야 하므로 파이프라인이 실행되지 않았습니다.
`pipeline_ref_creation_failure`	GitLab이 파이프라인 ref를 생성하지 못했습니다.
`filtered_by_no_pipeline`	`ci.no_pipeline` 옵션으로 커밋을 푸시하여 파이프라인이 실행되지 않았습니다. 이 값은 예상된 동작입니다.
`gitaly_unavailable`	파이프라인을 생성할 때 Gitaly를 일시적으로 사용할 수 없었습니다.

filtered_by_rules, filtered_by_workflow_rules, filtered_by_no_pipeline, gitaly_unavailable 사유는 메트릭에 집계되지만, GitLab은 이 사유에 대해 실패한 파이프라인을 저장하지 않으므로 UI에는 실패한 파이프라인으로 나타나지 않습니다.

두 카운터는 Sidekiq 메트릭 표에도 나열되어 있습니다.

Zoekt 메트릭#

히스토리

GitLab 19.2에서 도입되었습니다.

Zoekt로 구동되는 정확한 코드 검색에 대한 메트릭입니다.

요청별 및 job별 메트릭#

이 메트릭은 GitLab Rails에서 Zoekt 노드로 보내는 모든 HTTP 요청에 대해, 웹/Grape 요청과 Sidekiq job 모두에서 생성됩니다.

메트릭	유형	버전	레이블	설명
`http_zoekt_requests_total`	Counter	19.2	`controller`, `action`, `feature_category`, `endpoint_id`	웹 트랜잭션 중 Zoekt 서버에 대한 호출 수. Premium 및 Ultimate만 해당.
`http_zoekt_requests_duration_seconds`	Histogram	19.2	`controller`, `action`, `feature_category`, `endpoint_id`	웹 트랜잭션 중 Zoekt 서버에 대한 쿼리 시간. Premium 및 Ultimate만 해당.
`sidekiq_zoekt_requests_total`	Counter	19.2	`queue`, `boundary`, `external_dependencies`, `feature_category`, `job_status`, `urgency`, `destination_shard_redis`	Sidekiq job 실행 중 Zoekt 요청. Premium 및 Ultimate만 해당.
`sidekiq_zoekt_requests_duration_seconds`	Histogram	19.2	`queue`, `boundary`, `external_dependencies`, `feature_category`, `job_status`, `urgency`, `destination_shard_redis`	Sidekiq job이 Zoekt 서버에 요청하는 데 소요된 시간(초). Premium 및 Ultimate만 해당.

두 개의 sidekiq_zoekt_* 행은 Sidekiq 메트릭 표에도 동등한 Elasticsearch 및 Redis 메트릭과 함께 나열되어 있습니다.

데이터베이스에서 파생된 Zoekt 메트릭(GitLab exporter)#

데이터베이스에서 파생된 Zoekt 메트릭(노드 상태, 작업 큐 깊이, 인덱스 상태, 스토리지 바이트)은 gitlab-exporter 프로세스가 search_zoekt_* 접두사로 내보냅니다. 이 메트릭은 Rails /-/metrics 엔드포인트가 아니라 gitlab-exporter 엔드포인트에서 내보냅니다.

메트릭	유형	버전	레이블	설명
`search_zoekt_task_processing_queue_size`	Gauge	None	`node_name`, `node_id`	Zoekt가 처리 대기 중인 작업 수.
`search_zoekt_repositories_schema_version_count`	Gauge	None	`target_schema_version`, `zoekt_node_id`, `zoekt_node_name`	최신 스키마 버전이 아닌 `zoekt_repositories` 수.
`search_zoekt_nodes_status`	Gauge	None	`zoekt_node_id`, `zoekt_node_name`	각 Zoekt 노드의 상태. `0`은 오프라인(마지막 확인이 2분 이상 전), `1`은 온라인입니다.
`search_zoekt_node_unclaimed_storage_bytes`	Gauge	None	`zoekt_node_id`, `zoekt_node_name`	Zoekt 노드의 미청구 스토리지 바이트.
`search_zoekt_node_storage_percent_used`	Gauge	None	`zoekt_node_id`, `zoekt_node_name`	Zoekt 노드에서 사용 중인 스토리지 비율(범위: `0`~`1`).
`search_zoekt_repositories_states_total`	Gauge	None	`state`	각 상태의 Zoekt 리포지터리 수.
`search_zoekt_indices_states`	Gauge	None	`state`	각 상태의 Zoekt 인덱스 수.
`search_zoekt_indices_watermark_levels`	Gauge	None	`watermark_level`	각 워터마크 수준의 Zoekt 인덱스 수.
`search_zoekt_indices_reserved_storage_bytes`	Gauge	None	`zoekt_index_id`, `zoekt_node_name`	각 Zoekt 인덱스의 예약된 스토리지 바이트.
`search_zoekt_indices_used_storage_bytes`	Gauge	None	`zoekt_index_id`, `zoekt_node_name`	각 Zoekt 인덱스의 사용된 스토리지 바이트.
`search_zoekt_node_enabled_namespaces`	Gauge	19.2	`node_id`, `node_name`	Zoekt 노드당 활성화된 네임스페이스 수.
`search_zoekt_node_tasks`	Gauge	19.2	`node_id`, `node_name`, `state`	상태별로 분류된 노드의 Zoekt 인덱싱 작업 수.
`search_zoekt_indices_with_stale_used_storage_bytes`	Gauge	19.2	None	마지막 인덱스 실행 이후 `used_storage_bytes` 값이 갱신되지 않은 Zoekt 인덱스 수.

SLI 메트릭#

전역 검색 SLI 메트릭에는 search_type="zoekt" 레이블로 Zoekt 검색이 포함됩니다. 자세한 내용은 애플리케이션 SLI를 참고합니다.

메트릭	유형	버전	레이블	설명
`gitlab_sli_global_search_apdex_success_total`	Counter	14.4	`search_type`, `search_level`, `search_scope`, `endpoint_id`	지연 시간 목표(코드 검색의 경우 15.52초)를 충족한 Zoekt 검색의 총 수. `search_type="zoekt"`로 필터링합니다
`gitlab_sli_global_search_apdex_total`	Counter	14.4	`search_type`, `search_level`, `search_scope`, `endpoint_id`	Zoekt 검색 Apdex 측정의 총 수. `search_type="zoekt"`로 필터링합니다
`gitlab_sli_global_search_error_total`	Counter	14.4	`search_type`, `search_level`, `search_scope`, `endpoint_id`	Zoekt 검색 오류 측정의 총 수. `search_type="zoekt"`로 필터링합니다
`gitlab_sli_global_search_total`	Counter	14.4	`search_type`, `search_level`, `search_scope`, `endpoint_id`	전역 검색 오류율 측정의 총 수. `gitlab_sli_global_search_error_total`을 `gitlab_sli_global_search_total`로 나누면 오류 비율을 구할 수 있습니다. `search_type="zoekt"`로 필터링합니다

Zoekt 작업 SLI 메트릭#

이 메트릭의 Apdex 목표는 ee/lib/gitlab/metrics/zoekt_tasks_slis.rb의 APDEX_THRESHOLD_S입니다. 이 상수가 변경되면 이 섹션을 업데이트합니다.

메트릭	유형	버전	레이블	설명
`gitlab_sli_search_zoekt_tasks_apdex_success_total`	Counter	18.10	`zoekt_node`, `task_type`	7200초(2시간) 목표 안에 완료된 Zoekt 인덱싱 작업의 총 수
`gitlab_sli_search_zoekt_tasks_apdex_total`	Counter	18.10	`zoekt_node`, `task_type`	총 Zoekt 인덱싱 작업 Apdex 측정 수
`gitlab_sli_search_zoekt_tasks_error_total`	Counter	18.10	`zoekt_node`, `task_type`	총 Zoekt 인덱싱 작업 오류 수
`gitlab_sli_search_zoekt_tasks_total`	Counter	18.10	`zoekt_node`, `task_type`	Zoekt 인덱싱 작업 오류율 측정의 총 수. `gitlab_sli_search_zoekt_tasks_error_total`을 `gitlab_sli_search_zoekt_tasks_total`로 나누면 오류 비율을 구할 수 있습니다
`gitlab_sli_search_zoekt_tasks_requests_total`	Counter	18.10	`zoekt_node`, `task_type`	큐에 추가된 총 Zoekt 작업 수
`gitlab_search_zoekt_task_duration_seconds`	Histogram	19.5	`zoekt_node`, `task_type`	Zoekt 인덱싱 작업의 예약 시각부터 완료까지의 시간(초)

감사 이벤트 스트리밍 SLI 메트릭#

이 SLI는 NATS 감사 이벤트 스트리밍 파이프라인을 추적합니다. 자세한 내용은 애플리케이션 SLI를 참고합니다.

메트릭	유형	버전	레이블	설명
`gitlab_sli_audit_event_streaming_nats_dispatch_apdex_success_total`	Counter	19.3	`feature_category`	컨슈머 지연 목표를 충족한 감사 이벤트 배치 디스패치의 총 수
`gitlab_sli_audit_event_streaming_nats_dispatch_apdex_total`	Counter	19.3	`feature_category`	총 감사 이벤트 배치 디스패치 Apdex 측정 수
`gitlab_sli_audit_event_streaming_nats_dispatch_error_total`	Counter	19.3	`feature_category`	실패한 감사 이벤트 배치 디스패치의 총 수
`gitlab_sli_audit_event_streaming_nats_dispatch_total`	Counter	19.3	`feature_category`	총 감사 이벤트 배치 디스패치 시도 수

기능 플래그로 제어되는 메트릭#

다음 메트릭은 기능 플래그로 제어할 수 있습니다.

메트릭	기능 플래그
`gitlab_view_rendering_duration_seconds`	`prometheus_metrics_view_instrumentation`
`gitlab_ci_queue_depth_total`	`gitlab_ci_builds_queuing_metrics`
`gitlab_ci_queue_size`	`gitlab_ci_builds_queuing_metrics`
`gitlab_ci_queue_size_total`	`gitlab_ci_builds_queuing_metrics`
`gitlab_ci_queue_iteration_duration_seconds`	`gitlab_ci_builds_queuing_metrics`
`gitlab_ci_current_queue_size`	`gitlab_ci_builds_queuing_metrics`
`gitlab_ci_queue_retrieval_duration_seconds`	`gitlab_ci_builds_queuing_metrics`
`gitlab_ci_queue_active_runners_total`	`gitlab_ci_builds_queuing_metrics`
`gitaly_circuit_breaker_requests_total`	`add_circuit_breaker_to_gitaly`
`gitaly_circuit_breaker_transitions_total`	`add_circuit_breaker_to_gitaly`
`ruby_gvl_wait_seconds_total`	`enable_sidekiq_gvl_metrics`
`ruby_gvl_wait_seconds_total`	`enable_puma_gvl_metrics`

Praefect 메트릭#

Praefect를 구성하여 메트릭을 보고하도록 할 수 있습니다. 사용 가능한 메트릭은 Gitaly Cluster(Praefect) 모니터링을 참고합니다.

Sidekiq 메트릭#

Sidekiq job도 메트릭을 수집할 수 있으며, Sidekiq exporter가 활성화되어 있으면 이 메트릭에 액세스할 수 있습니다. 예를 들어 gitlab.yml의 monitoring.sidekiq_exporter 구성 옵션을 사용합니다. 이 메트릭은 구성된 포트의 /metrics 경로에서 제공됩니다.

메트릭	유형	버전	레이블	설명
`destroyed_job_artifacts_count_total`	Counter	13.6		삭제된 만료된 job 아티팩트 수
`destroyed_pipeline_artifacts_count_total`	Counter	13.8		삭제된 만료된 파이프라인 아티팩트 수
`geo_ci_secure_files_checksum_failed`	Gauge	15.3	`url`	기본 사이트에서 체크섬 계산에 실패한 보안 파일 수
`geo_ci_secure_files_checksum_total`	Gauge	15.3	`url`	기본 사이트에서 체크섬할 보안 파일 수
`geo_ci_secure_files_checksummed`	Gauge	15.3	`url`	기본 사이트에서 체크섬을 성공적으로 계산한 보안 파일 수
`geo_ci_secure_files_failed`	Gauge	15.3	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 보안 파일 수
`geo_ci_secure_files_registry`	Gauge	15.3	`url`	레지스트리의 보안 파일 수
`geo_ci_secure_files_synced`	Gauge	15.3	`url`	보조 사이트에서 동기화된 동기화 가능한 보안 파일 수
`geo_ci_secure_files_verification_failed`	Gauge	15.3	`url`	보조 사이트에서 검증에 실패한 보안 파일 수
`geo_ci_secure_files_verification_total`	Gauge	15.3	`url`	보조 사이트에서 검증을 시도할 보안 파일 수
`geo_ci_secure_files_verified`	Gauge	15.3	`url`	보조 사이트에서 성공적으로 검증된 보안 파일 수
`geo_ci_secure_files`	Gauge	15.3	`url`	기본 사이트의 보안 파일 수
`geo_container_repositories_checksum_failed`	Gauge	15.10	`url`	기본 사이트에서 체크섬 계산에 실패한 컨테이너 리포지터리 수
`geo_container_repositories_checksum_total`	Gauge	15.10	`url`	기본 사이트에서 성공적으로 체크섬된 컨테이너 리포지터리 수
`geo_container_repositories_checksummed`	Gauge	15.10	`url`	기본 사이트에서 체크섬을 시도한 컨테이너 리포지터리 수
`geo_container_repositories_failed`	Gauge	15.4	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 컨테이너 리포지터리 수
`geo_container_repositories_registry`	Gauge	15.4	`url`	레지스트리의 컨테이너 리포지터리 수
`geo_container_repositories_synced`	Gauge	15.4	`url`	보조 사이트에서 동기화된 컨테이너 리포지터리 수
`geo_container_repositories_verification_failed`	Gauge	15.10	`url`	보조 사이트에서 검증에 실패한 컨테이너 리포지터리 수
`geo_container_repositories_verification_total`	Gauge	15.10	`url`	보조 사이트에서 검증을 시도한 컨테이너 리포지터리 수
`geo_container_repositories_verified`	Gauge	15.10	`url`	보조 사이트에서 검증된 컨테이너 리포지터리 수
`geo_container_repositories`	Gauge	15.4	`url`	기본 사이트의 컨테이너 리포지터리 수
`geo_cursor_last_event_id`	Gauge	10.2	`url`	보조 사이트에서 처리된 이벤트 로그의 마지막 데이터베이스 ID
`geo_cursor_last_event_timestamp`	Gauge	10.2	`url`	보조 사이트에서 처리된 이벤트 로그의 마지막 UNIX 타임스탬프
`geo_db_replication_lag_seconds`	Gauge	10.2	`url`	데이터베이스 복제 지연(초)
`geo_dependency_proxy_blob_checksum_failed`	Gauge	15.6		기본 사이트에서 체크섬 계산에 실패한 dependency proxy 블롭 수
`geo_dependency_proxy_blob_checksum_total`	Gauge	15.6		기본 사이트에서 체크섬할 dependency proxy 블롭 수
`geo_dependency_proxy_blob_checksummed`	Gauge	15.6		기본 사이트에서 체크섬을 성공적으로 계산한 dependency proxy 블롭 수
`geo_dependency_proxy_blob_failed`	Gauge	15.6		보조 사이트에서 동기화에 실패한 dependency proxy 블롭 수
`geo_dependency_proxy_blob_registry`	Gauge	15.6		레지스트리의 dependency proxy 블롭 수
`geo_dependency_proxy_blob_synced`	Gauge	15.6		보조 사이트에서 동기화된 dependency proxy 블롭 수
`geo_dependency_proxy_blob_verification_failed`	Gauge	15.6		보조 사이트에서 검증에 실패한 dependency proxy 블롭 수
`geo_dependency_proxy_blob_verification_total`	Gauge	15.6		보조 사이트에서 검증을 시도할 dependency proxy 블롭 수
`geo_dependency_proxy_blob_verified`	Gauge	15.6		보조 사이트에서 성공적으로 검증된 dependency proxy 블롭 수
`geo_dependency_proxy_blob`	Gauge	15.6		기본 사이트의 dependency proxy 블롭 수
`geo_dependency_proxy_manifests_checksum_failed`	Gauge	15.6	`url`	기본 사이트에서 체크섬 계산에 실패한 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_checksum_total`	Gauge	15.6	`url`	기본 사이트에서 체크섬할 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_checksummed`	Gauge	15.6	`url`	기본 사이트에서 체크섬을 성공적으로 계산한 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_failed`	Gauge	15.6	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_registry`	Gauge	15.6	`url`	레지스트리의 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_synced`	Gauge	15.6	`url`	보조 사이트에서 동기화된 동기화 가능한 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_verification_failed`	Gauge	15.6	`url`	보조 사이트에서 검증에 실패한 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_verification_total`	Gauge	15.6	`url`	보조 사이트에서 검증을 시도할 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_verified`	Gauge	15.6	`url`	보조 사이트에서 성공적으로 검증된 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests`	Gauge	15.6	`url`	기본 사이트의 dependency proxy 매니페스트 수
`geo_design_management_repositories_checksum_failed`	Gauge	16.1	`url`	기본 사이트에서 체크섬 계산에 실패한 디자인 리포지터리 수
`geo_design_management_repositories_checksum_total`	Gauge	16.1	`url`	기본 사이트에서 체크섬을 시도한 디자인 리포지터리 수
`geo_design_management_repositories_checksummed`	Gauge	16.1	`url`	기본 사이트에서 성공적으로 체크섬된 디자인 리포지터리 수
`geo_design_management_repositories_failed`	Gauge	16.1	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 디자인 리포지터리 수
`geo_design_management_repositories_registry`	Gauge	16.1	`url`	레지스트리의 디자인 리포지터리 수
`geo_design_management_repositories_synced`	Gauge	16.1	`url`	보조 사이트에서 동기화된 동기화 가능한 디자인 리포지터리 수
`geo_design_management_repositories_verification_failed`	Gauge	16.1	`url`	보조 사이트에서 검증에 실패한 디자인 리포지터리 수
`geo_design_management_repositories_verification_total`	Gauge	16.1	`url`	보조 사이트에서 검증을 시도한 디자인 리포지터리 수
`geo_design_management_repositories_verified`	Gauge	16.1	`url`	보조 사이트에서 검증된 디자인 리포지터리 수
`geo_design_management_repositories`	Gauge	16.1	`url`	기본 사이트의 디자인 리포지터리 수
`geo_group_wiki_repositories_checksum_failed`	Gauge	13.10	`url`	기본 사이트에서 체크섬 계산에 실패한 그룹 위키 수
`geo_group_wiki_repositories_checksum_total`	Gauge	16.3	`url`	기본 사이트에서 체크섬할 그룹 위키 수
`geo_group_wiki_repositories_checksummed`	Gauge	13.10	`url`	기본 사이트에서 체크섬을 성공적으로 계산한 그룹 위키 수
`geo_group_wiki_repositories_failed`	Gauge	13.10	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 그룹 위키 수
`geo_group_wiki_repositories_registry`	Gauge	13.10	`url`	레지스트리의 그룹 위키 수
`geo_group_wiki_repositories_synced`	Gauge	13.10	`url`	보조 사이트에서 동기화된 동기화 가능한 그룹 위키 수
`geo_group_wiki_repositories_verification_failed`	Gauge	16.3	`url`	보조 사이트에서 검증에 실패한 그룹 위키 수
`geo_group_wiki_repositories_verification_total`	Gauge	16.3	`url`	보조 사이트에서 검증을 시도할 그룹 위키 수
`geo_group_wiki_repositories_verified`	Gauge	16.3	`url`	보조 사이트에서 성공적으로 검증된 그룹 위키 수
`geo_group_wiki_repositories`	Gauge	13.10	`url`	기본 사이트의 그룹 위키 수
`geo_job_artifacts_checksum_failed`	Gauge	14.8	`url`	기본 사이트에서 체크섬 계산에 실패한 job 아티팩트 수
`geo_job_artifacts_checksum_total`	Gauge	14.8	`url`	기본 사이트에서 체크섬할 job 아티팩트 수
`geo_job_artifacts_checksummed`	Gauge	14.8	`url`	기본 사이트에서 체크섬을 성공적으로 계산한 job 아티팩트 수
`geo_job_artifacts_failed`	Gauge	14.8	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 job 아티팩트 수
`geo_job_artifacts_registry`	Gauge	14.8	`url`	레지스트리의 job 아티팩트 수
`geo_job_artifacts_synced`	Gauge	14.8	`url`	보조 사이트에서 동기화된 동기화 가능한 job 아티팩트 수
`geo_job_artifacts_verification_failed`	Gauge	14.8	`url`	보조 사이트에서 검증에 실패한 job 아티팩트 수
`geo_job_artifacts_verification_total`	Gauge	14.8	`url`	보조 사이트에서 검증을 시도할 job 아티팩트 수
`geo_job_artifacts_verified`	Gauge	14.8	`url`	보조 사이트에서 성공적으로 검증된 job 아티팩트 수
`geo_job_artifacts`	Gauge	14.8	`url`	기본 사이트의 job 아티팩트 수
`geo_last_event_id`	Gauge	10.2	`url`	기본 사이트의 최신 이벤트 로그 항목의 데이터베이스 ID
`geo_last_event_timestamp`	Gauge	10.2	`url`	기본 사이트의 최신 이벤트 로그 항목의 UNIX 타임스탬프
`geo_last_successful_status_check_timestamp`	Gauge	10.2	`url`	상태가 마지막으로 성공적으로 업데이트된 타임스탬프
`geo_lfs_objects_checksum_failed`	Gauge	14.6	`url`	기본 사이트에서 체크섬 계산에 실패한 LFS 오브젝트 수
`geo_lfs_objects_checksum_total`	Gauge	14.6	`url`	기본 사이트에서 체크섬할 필요가 있는 LFS 오브젝트 수
`geo_lfs_objects_checksummed`	Gauge	14.6	`url`	기본 사이트에서 성공적으로 체크섬된 LFS 오브젝트 수
`geo_lfs_objects_failed`	Gauge	10.2	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 LFS 오브젝트 수
`geo_lfs_objects_registry`	Gauge	14.6	`url`	레지스트리의 LFS 오브젝트 수
`geo_lfs_objects_synced`	Gauge	10.2	`url`	보조 사이트에서 동기화된 동기화 가능한 LFS 오브젝트 수
`geo_lfs_objects_verification_failed`	Gauge	14.6	`url`	보조 사이트에서 검증에 실패한 LFS 오브젝트 수
`geo_lfs_objects_verification_total`	Gauge	14.6	`url`	보조 사이트에서 검증을 시도할 LFS 오브젝트 수
`geo_lfs_objects_verified`	Gauge	14.6	`url`	보조 사이트에서 성공적으로 검증된 LFS 오브젝트 수
`geo_lfs_objects`	Gauge	10.2	`url`	기본 사이트의 LFS 오브젝트 수
`geo_merge_request_diffs_checksum_failed`	Gauge	13.4	`url`	기본 사이트에서 체크섬 계산에 실패한 머지 리퀘스트 diff 수
`geo_merge_request_diffs_checksum_total`	Gauge	13.12	`url`	기본 사이트에서 체크섬할 머지 리퀘스트 diff 수
`geo_merge_request_diffs_checksummed`	Gauge	13.4	`url`	기본 사이트에서 성공적으로 체크섬된 머지 리퀘스트 diff 수
`geo_merge_request_diffs_failed`	Gauge	13.4	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 머지 리퀘스트 diff 수
`geo_merge_request_diffs_registry`	Gauge	13.4	`url`	레지스트리의 머지 리퀘스트 diff 수

데이터베이스 로드 밸런싱 메트릭#

다음 메트릭을 사용할 수 있습니다.

메트릭	유형	버전	레이블	설명
`db_load_balancing_hosts`	Gauge	12.3		로드 밸런싱 호스트의 현재 수
`sidekiq_load_balancing_count`	Counter	13.11	`queue`, `boundary`, `external_dependencies`, `feature_category`, `job_status`, `urgency`, `data_consistency`, `load_balancing_strategy`	데이터 일관성이 `:sticky` 또는 `:delayed`로 설정된 로드 밸런싱을 사용하는 Sidekiq job 수
`gitlab_transaction_caught_up_replica_pick_count_total`	Counter	14.1	`result`	업데이트된 복제본에 대한 검색 시도 수

데이터베이스 파티셔닝 메트릭#

다음 메트릭을 사용할 수 있습니다.

메트릭	유형	버전	설명
`db_partitions_present`	Gauge	13.4	존재하는 데이터베이스 파티션 수
`db_partitions_missing`	Gauge	13.4	현재 예상되지만 존재하지 않는 데이터베이스 파티션 수

연결 풀 메트릭#

이 메트릭은 데이터베이스 연결 풀의 상태를 기록하며, 모든 메트릭에는 다음 레이블이 있습니다.

class - 기록되는 Ruby 클래스입니다.
- ActiveRecord::Base는 기본 데이터베이스 연결입니다.
- Geo::TrackingBase는 Geo 추적 데이터베이스에 대한 연결입니다(활성화된 경우).
host - 데이터베이스 연결에 사용되는 호스트 이름입니다.
port - 데이터베이스 연결에 사용되는 포트입니다.

메트릭	유형	버전	설명
`gitlab_database_connection_pool_size`	Gauge	13.0	총 연결 풀 용량
`gitlab_database_connection_pool_connections`	Gauge	13.0	풀에 생성된 연결 수.¹
`gitlab_database_connection_pool_busy`	Gauge	13.0	소유자가 아직 살아있는 사용 중인 연결
`gitlab_database_connection_pool_dead`	Gauge	13.0	소유자가 살아있지 않은 사용 중인 연결
`gitlab_database_connection_pool_idle`	Gauge	13.0	생성되었지만 현재 사용되지 않는 연결
`gitlab_database_connection_pool_waiting`	Gauge	13.0	현재 이 큐에서 대기 중인 스레드
`gitlab_database_extended_connection_pool_busy`	Gauge	18.11	소유자가 아직 살아있는 사용 중인 연결(스레드별)
`gitlab_database_extended_connection_pool_dead`	Gauge	18.11	소유자가 살아있지 않은 사용 중인 연결(스레드별)

GitLab 18.11 이상에서는 기본 연결 풀 게이지가 Puma 워커 프로세스 전체에서 집계되므로, 워커별로 하나가 아니라 Pod별로 하나의 시계열이 생성됩니다.

집계에는 GitLab이 사용하는 prometheus-client-mmap 클라이언트가 지원하는 multiprocess_mode 설정을 사용합니다.

gitlab_database_connection_pool_size는 min을 사용합니다. Puma 워커는 같은 구성으로 포크되므로 이 값은 Pod 안의 모든 워커에서 동일하며, min은 그 공통 값을 그대로 나타냅니다.
gitlab_database_connection_pool_connections, gitlab_database_connection_pool_busy, gitlab_database_connection_pool_dead, gitlab_database_connection_pool_idle, gitlab_database_connection_pool_waiting은 max(최악의 경우 워커)를 사용합니다.

이 값은 워커 전체의 합계가 아니라 Pod별 최악의 경우 값이므로, GitLab 18.10 이하에서 워커별 시계열을 합산하던 대시보드나 알림 (예: sum(gitlab_database_connection_pool_busy))은 이제 총계를 실제보다 적게 보고합니다.

Puma 워커 수를 곱해서 이전 합계를 재구성해서는 안 됩니다. Pod 전체의 합계는 해당 Pod나 플릿 전체의 사용률을 반영하지 않으며, 모니터링은 최악의 경우 워커를 대상으로 해야 합니다.

단일 워커 프로세스가 풀을 포화시키면, 같은 Pod의 다른 워커가 무엇을 하고 있든 상관없이 그 워커는 요청을 처리할 수 없습니다.

연결 풀 포화 모니터링에는 connections에서 idle을 뺀 값 대신 busy와 dead의 합을 사용합니다.

gitlab_database_extended_connection_pool_busy 및 gitlab_database_extended_connection_pool_dead 메트릭에는 스레드별 세분화를 위한 thread_name 레이블이 포함됩니다. 이 메트릭은 카디널리티가 높아 기본적으로 비활성화되어 있습니다. Pod의 일정 비율에 대해 활성화하려면 per_thread_db_connection_pool_metrics ops 기능 플래그를 사용합니다. 이 플래그는 Feature.current_pod 범위로 지정되므로 높은 카디널리티 시계열을 전체 플릿에 내보내지 않고도 Pod의 일부 비율에만 켤 수 있습니다.

Ruby 메트릭#

몇 가지 기본 Ruby 런타임 메트릭을 사용할 수 있습니다.

메트릭	유형	버전	설명
`ruby_gc_duration_seconds`	Counter	11.1	Ruby GC에서 소요된 시간
`ruby_gc_stat_...`	Gauge	11.1	GC.stat의 다양한 메트릭
`ruby_gc_stat_ext_heap_fragmentation`	Gauge	15.2	에덴 슬롯 대비 라이브 오브젝트로 측정된 Ruby 힙 단편화 수준(범위 0 ~ 1)
`ruby_gvl_wait_seconds_total`	Gauge	19.4	이 프로세스의 모든 스레드가 Global VM Lock을 기다리며 보낸 시간(초). 기능 플래그로 제어됩니다
`ruby_file_descriptors`	Gauge	11.1	프로세스당 파일 디스크립터
`ruby_sampler_duration_seconds`	Counter	11.1	통계 수집에 소요된 시간
`ruby_process_cpu_seconds_total`	Gauge	12.0	프로세스당 총 CPU 시간
`ruby_process_max_fds`	Gauge	12.0	프로세스당 최대 열린 파일 디스크립터 수
`ruby_process_resident_memory_bytes`	Gauge	12.0	프로세스의 메모리 사용량(RSS/상주 세트 크기)
`ruby_process_resident_anon_memory_bytes`	Gauge	15.6	프로세스의 익명 메모리 사용량(RSS/상주 세트 크기)
`ruby_process_resident_file_memory_bytes`	Gauge	15.6	프로세스의 파일 지원 메모리 사용량(RSS/상주 세트 크기)
`ruby_process_unique_memory_bytes`	Gauge	13.0	프로세스의 메모리 사용량(USS/고유 세트 크기)
`ruby_process_proportional_memory_bytes`	Gauge	13.0	프로세스의 메모리 사용량(PSS/비례 세트 크기)
`ruby_process_start_time_seconds`	Gauge	12.0	프로세스 시작 시간의 UNIX 타임스탬프

Puma 메트릭#

메트릭	유형	버전	설명
`puma_workers`	Gauge	12.0	총 워커 수
`puma_running_workers`	Gauge	12.0	부팅된 워커 수
`puma_stale_workers`	Gauge	12.0	오래된 워커 수
`puma_running`	Gauge	12.0	실행 중인 스레드 수
`puma_queued_connections`	Gauge	12.0	워커 스레드를 기다리는 해당 워커의 "to do" 세트의 연결 수
`puma_active_connections`	Gauge	12.0	요청을 처리 중인 스레드 수
`puma_pool_capacity`	Gauge	12.0	워커가 현재 처리할 수 있는 요청 수
`puma_max_threads`	Gauge	12.0	최대 워커 스레드 수
`puma_idle_threads`	Gauge	12.0	요청을 처리하지 않는 생성된 스레드 수

Redis 메트릭#

이 클라이언트 메트릭은 Redis 서버 메트릭을 보완하기 위한 것입니다. 이 메트릭은 Redis 인스턴스별로 세분화됩니다. 이 메트릭에는 모두 Redis 인스턴스를 나타내는 storage 레이블이 있습니다. 예를 들어 cache 또는 shared_state입니다.

메트릭	유형	버전	설명
`gitlab_redis_client_exceptions_total`	Counter	13.2	Redis 클라이언트 예외 수(예외 클래스별로 세분화)
`gitlab_redis_client_requests_total`	Counter	13.2	Redis 클라이언트 요청 수
`gitlab_redis_client_requests_duration_seconds`	Histogram	13.2	Redis 요청 지연 시간(차단 명령 제외)
`gitlab_redis_client_redirections_total`	Counter	15.10	Redis 클러스터 MOVED/ASK 리디렉션 수(리디렉션 유형별로 세분화)
`gitlab_redis_client_requests_pipelined_commands`	Histogram	16.4	단일 Redis 서버에 전송된 파이프라인당 명령 수
`gitlab_redis_client_pipeline_redirections_count`	Histogram	17.0	파이프라인의 Redis 클러스터 리디렉션 수

Git LFS 메트릭#

다양한 Git LFS 기능을 추적하는 메트릭입니다.

메트릭	유형	버전	설명
`gitlab_sli_lfs_update_objects_total`	Counter	16.10	총 업데이트된 LFS 오브젝트 수
`gitlab_sli_lfs_update_objects_error_total`	Counter	16.10	총 업데이트된 LFS 오브젝트 오류 수
`gitlab_sli_lfs_check_objects_total`	Counter	16.10	총 확인된 LFS 오브젝트 수
`gitlab_sli_lfs_check_objects_error_total`	Counter	16.10	총 확인된 LFS 오브젝트 오류 수
`gitlab_sli_lfs_validate_link_objects_total`	Counter	16.10	총 검증된 LFS 연결 오브젝트 수
`gitlab_sli_lfs_validate_link_objects_error_total`	Counter	16.10	총 검증된 LFS 연결 오브젝트 오류 수

시크릿 탐지 파트너 토큰 검증 메트릭#

히스토리

GitLab 18.6에서 도입되었습니다.

외부 파트너 API(AWS, GCP, Postman 등)를 통한 시크릿 탐지 파트너 토큰 검증을 추적하는 메트릭입니다.

메트릭	유형	버전	레이블	설명
`validity_check_partner_api_duration_seconds`	Histogram	18.6	`partner`	파트너 토큰 검증 요청에 대한 API 응답 시간 추적. 히스토그램 버킷: [0.1, 0.25, 0.5, 1, 2, 5, 10] 초.
`validity_check_partner_api_requests_total`	Counter	18.6	`partner`, `status`, `error_type`	파트너 API 검증 요청의 총 수. `status`는 `success` 또는 `failure`일 수 있습니다. `error_type`은 실패한 경우에만 포함됩니다(예: `network_error`, `rate_limit`, `response_error`).
`validity_check_network_errors_total`	Counter	18.6	`partner`, `error_class`	파트너 API 호출 중 발생한 네트워크 오류의 총 수. `error_class`는 오류 유형을 나타냅니다(예: `Timeout`, `ConnectionRefused`, `HTTPError`).
`validity_check_rate_limit_hits_total`	Counter	18.6	`limit_type`	토큰 검증 중 속도 제한에 도달한 총 횟수. `limit_type`은 파트너 속도 제한 키에 해당합니다(예: `partner_aws_api`, `partner_gcp_api`, `partner_postman_api`).

파트너 레이블#

partner 레이블은 다음 값을 가질 수 있습니다.

aws - Amazon Web Services 토큰
gcp - Google Cloud Platform 토큰
postman - Postman API 토큰

메트릭 공유 디렉터리#

GitLab Prometheus 클라이언트에는 멀티프로세스 서비스 간에 공유되는 메트릭 데이터를 저장할 디렉터리가 필요합니다. 이 파일은 Puma 서버에서 실행되는 모든 인스턴스가 공유합니다. 이 디렉터리는 실행 중인 모든 Puma 프로세스가 액세스할 수 있어야 하며, 그렇지 않으면 메트릭이 올바르게 작동하지 않습니다.

이 디렉터리의 위치는 환경 변수 prometheus_multiproc_dir로 구성합니다. 최상의 성능을 위해 이 디렉터리를 tmpfs에 생성합니다.

GitLab을 Linux 패키지로 설치했고 tmpfs를 사용할 수 있으면 GitLab이 메트릭 디렉터리를 자동으로 구성합니다.

idle은 사용 중이 아닌 초기화된 연결만 계산하므로, busy, dead, idle 연결의 합계는 전체 연결 수보다 작거나 같을 수 있습니다. ↩

GitLab Prometheus 메트릭

GitLab v19.5

Tier: Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

원문 보기

번역일: 2026-10-15

요약

GitLab Prometheus 메트릭을 활성화하려면 다음 단계를 따릅니다.

관리자 액세스 권한이 있는 사용자로 GitLab에 로그인합니다.
오른쪽 상단에서 Admin을 선택합니다.
왼쪽 사이드바에서 Settings > Metrics and profiling을 선택합니다.
Metrics - Prometheus 섹션을 찾아 Enable GitLab Prometheus metrics endpoint를 선택합니다.
변경 사항을 적용하려면 GitLab을 재시작합니다.

직접 컴파일한 설치의 경우 직접 구성해야 합니다.

메트릭 수집#

Sidekiq 노드에서 메트릭을 활성화하고 확인하는 방법은 Sidekiq 메트릭을 참고합니다.

사용 가능한 메트릭#

다음 메트릭을 사용할 수 있습니다.

메트릭	유형	버전	레이블	설명
`action_cable_active_connections`	Gauge	13.4	`server_mode`	현재 연결된 ActionCable WS 클라이언트 수
`action_cable_broadcasts_total`	Counter	13.10	`server_mode`	발생한 ActionCable 브로드캐스트 수
`action_cable_pool_current_size`	Gauge	13.4	`server_mode`	ActionCable 스레드 풀의 현재 워커 스레드 수
`action_cable_pool_largest_size`	Gauge	13.4	`server_mode`	ActionCable 스레드 풀에서 지금까지 관찰된 최대 워커 스레드 수
`action_cable_pool_max_size`	Gauge	13.4	`server_mode`	ActionCable 스레드 풀의 최대 워커 스레드 수
`action_cable_pool_min_size`	Gauge	13.4	`server_mode`	ActionCable 스레드 풀의 최소 워커 스레드 수
`action_cable_pool_pending_tasks`	Gauge	13.4	`server_mode`	ActionCable 스레드 풀에서 실행 대기 중인 작업 수
`action_cable_pool_tasks_total`	Gauge	13.4	`server_mode`	ActionCable 스레드 풀에서 실행된 총 작업 수
`action_cable_single_client_transmissions_total`	Counter	13.10	`server_mode`	모든 채널에서 클라이언트에 전송된 ActionCable 메시지 수
`action_cable_subscription_confirmations_total`	Counter	13.10	`server_mode`	확인된 클라이언트의 ActionCable 구독 수
`action_cable_subscription_rejections_total`	Counter	13.10	`server_mode`	거부된 클라이언트의 ActionCable 구독 수
`action_cable_transmitted_bytes_total`	Counter	16.0	`operation`, `channel`	ActionCable을 통해 전송된 총 바이트 수
`active_context_queue_size`	Gauge	18.7	`queue_name`, `shard`	각 ActiveContext 큐의 항목 수
`artifact_report_<report_type>_builds_completed_total`	Counter	15.3		보고서 유형별 아티팩트가 있는 완료된 CI 빌드 카운터(상태별 레이블)
`auto_devops_pipelines_completed_total`	Counter	12.7		완료된 Auto DevOps 파이프라인 카운터(상태별 레이블)
`cached_object_operations_total`	Counter	15.3	`controller`, `action`, `endpoint_id`	특정 웹 요청에 대해 캐시된 총 오브젝트 수
`ci_report_parser_duration_seconds`	Histogram	13.9	`parser`	CI/CD 보고서 아티팩트를 파싱하는 시간
`dependency_linker_usage`	Counter	16.8	`used_on`	의존성 링커가 사용된 횟수
`email_receiver_error`	Counter	14.1		수신 이메일을 처리할 때 발생한 총 오류 수
`failed_login_captcha_total`	Gauge	11.0		로그인 중 실패한 CAPTCHA 시도 카운터
`gitlab_application_rate_limiter_throttle_utilization_ratio`	Histogram	17.6	`throttle_key`, `peek`, `feature_category`	GitLab 애플리케이션 속도 제한기의 스로틀 활용률.
`gitaly_circuit_breaker_requests_total`	Counter	18.9	`circuit_state`, `result`, `reason`	총 Gitaly 요청 중 회로 차단기가 처리한 수. `result`는 `allowed`, `rejected`, `error` 중 하나입니다. `reason`은 오류 세부 정보를 제공합니다(예: `resource_exhausted`)
`gitaly_circuit_breaker_transitions_total`	Counter	18.9	`from_state`, `to_state`	회로 차단기 상태 전환의 총 횟수. 상태는 `closed`, `open`입니다. 엔드포인트 및 스토리지에 대한 자세한 정보는 구조화된 로그에서 확인할 수 있습니다
`gitlab_audit_event_streaming_nats_consumer_lag_seconds`	Histogram	19.3	`feature_category`	감사 이벤트 스트리밍 NATS 컨슈머 지연(게시부터 디스패치까지)(초)
`gitlab_audit_event_streaming_nats_consumer_unreachable_total`	Counter	19.4	`feature_category`	NATS에 연결할 수 없어 중단된 감사 이벤트 컨슈머 드레인 수
`gitlab_audit_event_streaming_nats_dispatch_destination_error_total`	Counter	19.4	`feature_category`	대상 측 오류로 실패한 감사 이벤트 배치 디스패치 수(오류가 아니라 저하 비율)
`gitlab_audit_event_streaming_nats_publish_duration_seconds`	Histogram	19.4	`feature_category`	감사 이벤트 스트리밍 NATS 동기 게시 소요 시간(초)
`gitlab_audit_event_streaming_nats_publish_fallback_total`	Counter	19.3	`feature_category`	NATS에서 Sidekiq으로 폴백된 감사 이벤트 게시 수(오류가 아니라 저하 비율)
`gitlab_audit_event_streaming_nats_publish_total`	Counter	19.3	`feature_category`	NATS를 통한 감사 이벤트 게시 시도 수
`gitlab_authorized_projects_safety_net_refresh_rows_total`	Counter	19.3	`trigger`, `direction`	세이프티 넷 새로고침으로 추가되거나 삭제된 `project_authorizations` 행의 총 수
`gitlab_blob_embeds_total`	Counter	19.4	`outcome`	Blob 임베드 렌더링 시도의 총 수. 결과는 `rendered`, `unrenderable`, `unauthorized`, `project_not_found`, `embed_limit_exceeded`, `email_preview_disabled` 중 하나입니다.
`gitlab_bootsnap_compile_cache_events_total`	Counter	19.3	`event`	부팅 중 관찰된 Bootsnap 컴파일 캐시 이벤트 수(유형별 `hit`, `revalidated`, `miss`, `stale`). 적중률은 `(hit + revalidated) / total`입니다
`gitlab_cache_misses_total`	Counter	10.2	`controller`, `action`, `store`, `endpoint_id`	캐시 읽기 미스
`gitlab_cache_operation_duration_seconds`	Histogram	10.2	`operation`, `store`, `endpoint_id`	캐시 액세스 시간
`gitlab_cache_operations_total`	Counter	12.2	`controller`, `action`, `operation`, `store`, `endpoint_id`	컨트롤러 또는 액션별 캐시 작업
`gitlab_cache_read_multikey_count`	Histogram	15.7	`controller`, `action`, `store`, `endpoint_id`	멀티키 캐시 읽기 작업의 키 수
`gitlab_ci_active_jobs`	Histogram	14.2		파이프라인 생성 시 활성 job 수
`gitlab_ci_build_trace_errors_total`	Counter	14.4	`error_reason`	빌드 추적에서 다양한 오류 유형의 총 수
`gitlab_ci_current_queue_size`	Gauge	16.3		초기화된 CI/CD 빌드 큐의 현재 크기
`gitlab_ci_job_failure_reasons`	Counter	13.11	`reason`, `runner_type`	job 실패 사유 카운터. `runner_type` 레이블은 GitLab 19.3에서 추가되었습니다. `reason` 레이블 값은 CI/CD 실패 사유 메트릭을 참고합니다
`gitlab_ci_job_token_authorization_failures`	Counter	17.11	`same_root_ancestor`	CI JOB 토큰을 통한 실패한 인가 시도 수
`gitlab_ci_job_token_inbound_access`	Counter	17.2		CI job 토큰을 통한 인바운드 액세스 수
`gitlab_ci_pipeline_builder_scoped_variables_duration`	Histogram	14.5		CI/CD job에 대한 스코프 변수를 생성하는 데 걸리는 시간(초)
`gitlab_ci_pipeline_creation_duration_seconds`	Histogram	13.0	`gitlab`	CI/CD 파이프라인을 생성하는 데 걸리는 시간(초)
`gitlab_ci_pipeline_failure_reasons`	Counter	13.11	`reason`	파이프라인 실패 사유 카운터. `reason` 레이블 값은 CI/CD 실패 사유 메트릭을 참고합니다
`gitlab_ci_pipeline_security_orchestration_policy_processing_duration_seconds`	Histogram	13.12		CI/CD 파이프라인에서 보안 정책을 처리하는 데 걸리는 시간(초)
`gitlab_ci_pipeline_size_builds`	Histogram	13.1	`source`	파이프라인 소스별로 그룹화된 파이프라인 내 총 빌드 수
`gitlab_ci_pipeline_time_to_finished_seconds`	Histogram	19.2	`source`, `status`	파이프라인 생성부터 완료 상태(성공, 실패 또는 취소)까지의 실제 경과 시간(초)
`gitlab_ci_queue_depth_total`	Histogram	16.3		작업 결과와 관련된 CI/CD 빌드 큐의 크기
`gitlab_ci_queue_iteration_duration_seconds`	Histogram	16.3		CI/CD 큐에서 빌드를 찾는 데 걸리는 시간
`gitlab_ci_queue_operations_total`	Counter	16.3		큐 내부에서 발생하는 모든 작업 수
`gitlab_ci_queue_retrieval_duration_seconds`	Histogram	16.3		빌드 큐를 검색하기 위한 SQL 쿼리 실행 시간
`gitlab_ci_queue_size_total`	Histogram	16.3		초기화된 CI/CD 빌드 큐의 크기
`gitlab_ci_runner_authentication_failure_total`	Counter	15.2		러너 인증 실패 총 횟수
`gitlab_ci_runner_authentication_success_total`	Counter	15.2	`type`	러너 인증 성공 총 횟수
`gitlab_ci_trace_bytes_total`	Counter	13.4		전송된 빌드 추적 총 바이트 수
`gitlab_ci_trace_finalize_duration_seconds`	Histogram	13.6		빌드 추적 청크를 오브젝트 스토리지로 마이그레이션하는 기간
`gitlab_ci_trace_operations_total`	Counter	13.4	`operation`	빌드 추적에 대한 다양한 작업의 총 수
`gitlab_connection_pool_available_count`	Gauge	16.7		풀에서 사용 가능한 연결 수
`gitlab_connection_pool_size`	Gauge	16.7		연결 풀 크기
`gitlab_database_transaction_seconds`	Histogram	12.1		데이터베이스 트랜잭션에서 소요된 시간(초)
`gitlab_dependency_paths_found_total`	Counter	18.3	`cyclic`	지정된 의존성에 대해 발견된 상위 의존성 경로 수.
`gitlab_diffs_collection_real_duration_seconds`	Histogram	15.8	`controller`, `action`, `endpoint_id`	diffs 배치 요청에서 머지 리퀘스트 diff 파일 쿼리에 소요된 시간(초)
`gitlab_diffs_comparison_real_duration_seconds`	Histogram	15.8	`controller`, `action`, `endpoint_id`	diffs 배치 요청에서 비교 데이터를 가져오는 데 소요된 시간(초)
`gitlab_diffs_highlight_cache_decorate_real_duration_seconds`	Histogram	15.8	`controller`, `action`, `endpoint_id`	diffs 배치 요청에서 캐시에서 강조 표시된 줄을 설정하는 데 소요된 시간(초)
`gitlab_diffs_render_real_duration_seconds`	Histogram	15.8	`controller`, `action`, `endpoint_id`	diffs 배치 요청에서 diffs를 직렬화하고 렌더링하는 데 소요된 시간(초)
`gitlab_diffs_reorder_real_duration_seconds`	Histogram	15.8	`controller`, `action`, `endpoint_id`	diffs 배치 요청에서 diff 파일 재정렬에 소요된 시간(초)
`gitlab_diffs_unfold_real_duration_seconds`	Histogram	15.8	`controller`, `action`, `endpoint_id`	diffs 배치 요청에서 위치 전개에 소요된 시간(초)
`gitlab_diffs_unfoldable_positions_real_duration_seconds`	Histogram	15.8	`controller`, `action`	diffs 배치 요청에서 전개 가능한 노트 위치를 가져오는 데 소요된 시간(초)
`gitlab_diffs_write_cache_real_duration_seconds`	Histogram	15.8	`controller`, `action`, `endpoint_id`	diffs 배치 요청에서 강조 표시된 줄 및 통계를 캐시하는 데 소요된 시간(초)
`gitlab_external_http_duration_seconds`	Counter	13.8		외부 시스템에 대한 각 HTTP 호출에 소요된 시간(초)
`gitlab_external_http_exception_total`	Counter	13.8		외부 HTTP 호출 중 발생한 총 예외 수
`gitlab_external_http_total`	Counter	13.8	`controller`, `action`, `endpoint_id`	외부 시스템에 대한 총 HTTP 호출 수
`gitlab_find_dependency_paths_real_duration_seconds`	Histogram	18.3		지정된 컴포넌트의 상위 의존성 경로를 해결하는 데 소요된 시간(초).
`gitlab_ghost_user_migration_lag_seconds`	Gauge	15.6		고스트 사용자 마이그레이션을 위해 예약된 가장 오래된 레코드의 대기 시간(초)
`gitlab_ghost_user_migration_scheduled_records_total`	Gauge	15.6		예약된 고스트 사용자 마이그레이션의 총 수
`gitlab_graphql_return_type_conflicts_total`	Counter	19.4	`field`, `operation`, `types`	같은 응답 키에 대해 일치하지 않는 타입을 선택한 GraphQL 쿼리 수
`gitlab_highlight_usage`	Counter	16.8	`used_on`	`Gitlab::Highlight`가 사용된 횟수
`gitlab_http_router_rule_total`	Counter	17.4	`rule_action`, `rule_type`	HTTP Router 규칙의 `rule_action` 및 `rule_type` 발생 횟수
`gitlab_issuable_fast_count_by_state_failures_total`	Counter	13.5		Issue 및 Merge request 페이지에서 소프트 실패한 행 수 계산 작업 수
`gitlab_issuable_fast_count_by_state_total`	Counter	13.5		Issue 및 Merge request 페이지의 행 수 계산 작업 총 수
`gitlab_keeparound_refs_created_total`	Counter	16.10	`source`	실제로 생성된 keep-around refs 수
`gitlab_keeparound_refs_requested_total`	Counter	16.10	`source`	생성 요청된 keep-around refs 수
`gitlab_memwd_violations_handled_total`	Counter	15.9		Ruby 프로세스 메모리 위반이 처리된 총 횟수
`gitlab_memwd_violations_total`	Counter	15.9		Ruby 프로세스가 메모리 임계값을 위반한 총 횟수
`gitlab_method_call_duration_seconds`	Histogram	10.2	`controller`, `action`, `module`, `method`	메서드 호출 실제 기간
`gitlab_omniauth_login_total`	Counter	16.1	`omniauth_provider`, `status`	OmniAuth 로그인 시도 총 수
`gitlab_openbao_request_duration_seconds`	Histogram	19.4	`operation`, `outcome`	Rails에서 OpenBao로 보낸 각 HTTP 호출의 소요 시간(초). Premium 및 Ultimate만 해당.
`gitlab_openbao_request_errors_total`	Counter	19.4	`operation`, `error_type`	Rails에서 OpenBao로 보낸 HTTP 호출 중 실패한 호출 수(장애 유형별). Premium 및 Ultimate만 해당.
`gitlab_openbao_requests_total`	Counter	19.4	`operation`, `method`, `outcome`	Rails에서 OpenBao로 보낸 HTTP 호출의 총 수. Premium 및 Ultimate만 해당.
`gitlab_page_out_of_bounds`	Counter	12.8	`controller`, `action`, `bot`	PageLimiter 페이지네이션 제한 도달 카운터
`gitlab_plan_tier_lookups_total`	Counter	19.5	`subject`, `result`	플랜 티어 조회 수. `subject`는 `user` 또는 `namespace`입니다. `result`는 요청별 저장소나 Redis가 응답하면 `hit`이고, 조회가 데이터베이스를 질의하면 `miss`입니다. ID가 없는 조회는 계산하지 않습니다. 한 요청 안의 두 조회는 같은 캐시 키로 해석될 때만 요청별 저장소를 재사용합니다. 예를 들어 배포 토큰이 자신의 네임스페이스가 요청 대상 네임스페이스인 경우가 그렇습니다. 따라서 적중률이 아니라 `miss` 비율에 알림을 설정합니다
`gitlab_presentable_object_cacheless_render_real_duration_seconds`	Histogram	15.3	`controller`, `action`, `endpoint_id`	특정 웹 요청 오브젝트를 캐싱하고 표현하는 데 소요된 실제 시간
`gitlab_rack_attack_events_total`	Counter	17.6	`event_type`, `event_name`	Rack Attack에서 처리된 총 이벤트 수.
`gitlab_rack_attack_throttle_limit`	Gauge	17.6	`event_name`	Rack Attack이 클라이언트를 스로틀하기 전에 만들 수 있는 최대 요청 수.
`gitlab_rack_attack_throttle_period_seconds`	Gauge	17.6	`event_name`	Rack Attack이 클라이언트를 스로틀하기 전에 클라이언트에 대한 요청이 집계되는 기간.
`gitlab_rails_boot_time_seconds`	Gauge	14.8		Rails 기본 프로세스가 시작을 완료하기까지 경과된 시간
`gitlab_rails_queue_duration_seconds`	Histogram	9.4		GitLab Workhorse가 Rails에 요청을 전달하는 것 사이의 지연 시간 측정
`gitlab_rate_limiter_git_basic_auth_ban_events_total`	Counter	19.4	`event`	Git 및 컨테이너 레지스트리 인증 IP 차단 이벤트 수. `event`는 `failure`, `ban`, `blocked`, `already_banned`, `reset` 중 하나입니다
`gitlab_ref_cache_operations_total`	Counter	19.4	`operation`, `ref_type`, `status`	결과별 ref 캐시 작업 수. `operation`은 `fetch`, `search`, `include`, `update`, `rebuild` 중 하나입니다. `ref_type`은 `branch`, `tag`, `unknown` 중 하나입니다. `fetch`, `search`, `include`의 경우 `status`는 `hit`, `miss_untrusted`, `miss_absent`, `error` 중 하나입니다. `miss_untrusted`는 집합이 존재하지만 신뢰할 수 없거나, 캐시 재빌드가 Redis 키가 없는 빈 집합을 만드는 복구 가능한 미스를 의미합니다. `miss_absent`는 멤버를 생성한 콜드 읽기를 의미합니다. `update`의 경우 `status`는 `success`, `skipped`, `error` 중 하나입니다. `rebuild`의 경우 `status`는 `success`, `skipped_locked`, `skipped_trusted`, `error` 중 하나입니다. `update/skipped`에는 재빌드 중 큐에 추가되었다가 이후 조정(reconciliation) 과정에서 적용된 이중 쓰기가 포함됩니다.
`gitlab_ref_cache_trust_events_total`	Counter	19.4	`ref_type`, `event`	ref 캐시 신뢰 수명 주기 이벤트의 총 수. `ref_type`은 `branch`, `tag`, `unknown` 중 하나입니다. `event`는 `granted`, `revoked`, `grant_skipped` 중 하나입니다.
`gitlab_ruby_threads_max_expected_threads`	Gauge	13.3		애플리케이션 작업을 수행하기 위해 실행될 것으로 예상되는 최대 스레드 수
`gitlab_ruby_threads_running_threads`	Gauge	13.3		이름별 실행 중인 Ruby 스레드 수
`gitlab_secrets_manager_entitlement_resolutions_total`	Counter	19.4	`source`	Customers Portal에 조회한 Secrets Manager 엔타이틀먼트 확인 수. 오프라인 확인과 캐시된 확인은 계산하지 않습니다. `source`는 `live`(Customers Portal이 응답함), `lkg_stale`(Customers Portal에 연결할 수 없거나 HTTP 5xx 오류로 응답하여 GitLab이 마지막으로 확인된 정상 응답을 재사용함), `fail_closed`(확인에 실패하여 GitLab이 액세스를 거부함) 중 하나입니다. Premium 및 Ultimate만 해당.
`gitlab_security_policies_policy_creation_duration_seconds`	Histogram	17.6		정책 관련 구성을 생성하는 데 걸리는 시간
`gitlab_security_policies_policy_deletion_duration_seconds`	Histogram	17.6		정책 관련 구성을 삭제하는 데 걸리는 시간
`gitlab_security_policies_policy_sync_duration_seconds`	Histogram	17.6		정책 구성에 대한 정책 변경 사항을 동기화하는 데 걸리는 시간
`gitlab_security_policies_scan_execution_configuration_rendering_seconds`	Histogram	17.3		스캔 실행 정책 CI 구성을 렌더링하는 데 걸리는 시간
`gitlab_security_policies_scan_result_process_duration_seconds`	Histogram	16.7		머지 리퀘스트 승인 정책을 처리하는 데 걸리는 시간
`gitlab_security_policies_sync_opened_merge_requests_duration_seconds`	Histogram	17.6		정책 변경 후 열린 머지 리퀘스트를 동기화하는 데 걸리는 시간
`gitlab_security_policies_update_configuration_duration_seconds`	Histogram	17.6		정책 구성 변경에 대한 동기화를 예약하는 데 걸리는 시간
`gitlab_sli_openbao_client_calls_error_total`	Counter	19.4	`operation`	애플리케이션 SLI로 측정한, Rails에서 OpenBao로 보낸 HTTP 호출 중 실패한 호출 수. Premium 및 Ultimate만 해당.
`gitlab_sli_openbao_client_calls_total`	Counter	19.4	`operation`	애플리케이션 SLI로 측정한, Rails에서 OpenBao로 보낸 HTTP 호출의 총 수. Premium 및 Ultimate만 해당.
`gitlab_sli_rails_request_apdex_success_total`	Counter	14.4	`endpoint_id`, `feature_category`, `request_urgency`	긴급도별 목표 소요 시간을 충족한 성공 요청의 총 수. `gitlab_sli_rails_requests_apdex_total`로 나누면 성공 비율을 구할 수 있습니다
`gitlab_sli_rails_request_apdex_total`	Counter	14.4	`endpoint_id`, `feature_category`, `request_urgency`	총 요청 Apdex 측정 수.
`gitlab_sli_rails_request_error_total`	Counter	15.7	`endpoint_id`, `feature_category`, `request_urgency`, `error`	총 요청 오류 측정 수.
`gitlab_snowplow_events_total`	Counter	14.1		발생한 총 GitLab Snowplow 분석 계측 이벤트 수
`gitlab_snowplow_failed_events_total`	Counter	14.1		GitLab Snowplow 분석 계측 이벤트 발생 실패 총 수
`gitlab_snowplow_successful_events_total`	Counter	14.1		GitLab Snowplow 분석 계측 이벤트 발생 성공 총 수
`gitlab_spamcheck_request_duration_seconds`	Histogram	13.12		Rails와 스팸 방지 엔진 간의 요청 기간
`gitlab_sql_<role>_duration_seconds`	Histogram	13.10		`SCHEMA` 작업과 `BEGIN` / `COMMIT`을 제외한 SQL 실행 시간(데이터베이스 역할(primary/replica)별로 그룹화)
`gitlab_sql_duration_seconds`	Histogram	10.2		`SCHEMA` 작업과 `BEGIN` / `COMMIT`을 제외한 SQL 실행 시간
`gitlab_transaction_cache_<key>_count_total`	Counter	10.2		총 Rails 캐시 호출 카운터(키별)
`gitlab_transaction_cache_<key>_duration_total`	Counter	10.2		Rails 캐시 호출에 소요된 총 시간 카운터(초, 키별)
`gitlab_transaction_cache_count_total`	Counter	10.2		총 Rails 캐시 호출 카운터(집계)
`gitlab_transaction_cache_duration_total`	Counter	10.2		Rails 캐시 호출에 소요된 총 시간 카운터(초, 집계)
`gitlab_transaction_cache_read_hit_count_total`	Counter	10.2	`controller`, `action`, `store`, `endpoint_id`	Rails 캐시 호출에 대한 캐시 히트 카운터
`gitlab_transaction_cache_read_miss_count_total`	Counter	10.2	`controller`, `action`, `store`, `endpoint_id`	Rails 캐시 호출에 대한 캐시 미스 카운터
`gitlab_transaction_db_<role>_cached_count_total`	Counter	13.1	`controller`, `action`, `endpoint_id`	캐시된 SQL 호출 총 수 카운터(데이터베이스 역할별 그룹화)
`gitlab_transaction_db_<role>_count_total`	Counter	13.10	`controller`, `action`, `endpoint_id`	SQL 호출 총 수 카운터(데이터베이스 역할별 그룹화)
`gitlab_transaction_db_<role>_wal_cached_count_total`	Counter	14.1	`controller`, `action`, `endpoint_id`	캐시된 WAL 쿼리 총 수 카운터(데이터베이스 역할별 그룹화)
`gitlab_transaction_db_<role>_wal_count_total`	Counter	14.0	`controller`, `action`, `endpoint_id`	WAL 쿼리 총 수 카운터(데이터베이스 역할별 그룹화)
`gitlab_transaction_db_cached_count_total`	Counter	13.1	`controller`, `action`, `endpoint_id`	캐시된 SQL 호출 총 수 카운터
`gitlab_transaction_db_count_total`	Counter	13.1	`controller`, `action`, `endpoint_id`	SQL 호출 총 수 카운터
`gitlab_transaction_db_write_count_total`	Counter	13.1	`controller`, `action`, `endpoint_id`	쓰기 SQL 호출 총 수 카운터
`gitlab_transaction_duration_seconds`	Histogram	10.2	`controller`, `action`, `endpoint_id`	성공한 요청의 소요 시간(`gitlab_transaction_*` 메트릭)
`gitlab_transaction_event_build_found_total`	Counter	9.4		API /jobs/request에서 빌드 발견 카운터
`gitlab_transaction_event_build_invalid_total`	Counter	9.4		API /jobs/request에서 동시성 충돌로 인한 빌드 무효 카운터
`gitlab_transaction_event_build_not_found_cached_total`	Counter	9.4		API /jobs/request에서 빌드를 찾을 수 없는 캐시된 응답 카운터
`gitlab_transaction_event_build_not_found_total`	Counter	9.4		API /jobs/request에서 빌드를 찾을 수 없는 카운터
`gitlab_transaction_event_change_default_branch_total`	Counter	9.4		리포지터리의 기본 브랜치가 변경될 때 카운터
`gitlab_transaction_event_create_repository_total`	Counter	9.4		리포지터리가 생성될 때 카운터
`gitlab_transaction_event_etag_caching_cache_hit_total`	Counter	9.4	`endpoint`	ETag 캐시 히트 카운터.
`gitlab_transaction_event_etag_caching_header_missing_total`	Counter	9.4	`endpoint`	ETag 캐시 미스 카운터 - 헤더 누락
`gitlab_transaction_event_etag_caching_key_not_found_total`	Counter	9.4	`endpoint`	ETag 캐시 미스 카운터 - 키를 찾을 수 없음
`gitlab_transaction_event_etag_caching_middleware_used_total`	Counter	9.4	`endpoint`	ETag 미들웨어 액세스 카운터
`gitlab_transaction_event_etag_caching_resource_changed_total`	Counter	9.4	`endpoint`	ETag 캐시 미스 카운터 - 리소스 변경됨
`gitlab_transaction_event_fork_repository_total`	Counter	9.4		리포지터리 포크 카운터(RepositoryForkWorker). 소스 리포지터리가 존재하는 경우에만 증가
`gitlab_transaction_event_import_repository_total`	Counter	9.4		리포지터리 임포트 카운터(RepositoryImportWorker)
`gitlab_transaction_event_patch_hard_limit_bytes_hit_total`	Counter	13.9		diff 패치 크기 제한 도달 카운터
`gitlab_transaction_event_push_branch_total`	Counter	9.4		모든 브랜치 푸시 카운터
`gitlab_transaction_event_rails_exception_total`	Counter	9.4		Rails 예외 수 카운터
`gitlab_transaction_event_remove_branch_total`	Counter	9.4		리포지터리에서 브랜치가 제거될 때 카운터
`gitlab_transaction_event_remove_repository_total`	Counter	9.4		리포지터리가 제거될 때 카운터
`gitlab_transaction_event_remove_tag_total`	Counter	9.4		어떤 리포지터리에서든 태그가 제거될 때의 카운터
`gitlab_transaction_event_sidekiq_exception_total`	Counter	9.4		Sidekiq 예외 카운터
`gitlab_transaction_event_stuck_import_jobs_total`	Counter	9.4	`projects_without_jid_count`, `projects_with_jid_count`	중단된 임포트 job 수
`gitlab_transaction_event_update_build_total`	Counter	9.4		API `/jobs/request/:id`의 빌드 업데이트 카운터
`gitlab_transaction_new_redis_connections_total`	Counter	9.4		새로운 Redis 연결 카운터
`gitlab_transaction_rails_queue_duration_total`	Counter	9.4	`controller`, `action`, `endpoint_id`	GitLab Workhorse가 Rails에 요청을 전달하는 것 사이의 지연 시간 측정
`gitlab_transaction_view_duration_total`	Counter	9.4	`controller`, `action`, `view`, `endpoint_id`	뷰 기간
`gitlab_view_rendering_duration_seconds`	Histogram	10.2	`controller`, `action`, `view`, `endpoint_id`	뷰 기간(히스토그램)
`gitlab_vulnerability_report_branch_comparison_cpu_duration_seconds`	Histogram	15.11		기본 브랜치 SQL 쿼리에 대한 취약점 보고서의 CPU 실행 기간
`gitlab_vulnerability_report_branch_comparison_real_duration_seconds`	Histogram	15.11		기본 브랜치 SQL 쿼리에 대한 취약점 보고서의 벽시계 실행 기간
`http_elasticsearch_requests_duration_seconds`	Histogram	13.1	`controller`, `action`, `endpoint_id`	웹 트랜잭션 중 Elasticsearch 요청 기간. Premium 및 Ultimate만 해당.
`http_elasticsearch_requests_total`	Counter	13.1	`controller`, `action`, `endpoint_id`	웹 트랜잭션 중 Elasticsearch 요청 수. Premium 및 Ultimate만 해당.
`http_zoekt_requests_duration_seconds`	Histogram	19.2	`controller`, `action`, `feature_category`, `endpoint_id`	웹 트랜잭션 중 Zoekt 서버에 대한 쿼리 시간. Premium 및 Ultimate만 해당.
`http_zoekt_requests_total`	Counter	19.2	`controller`, `action`, `feature_category`, `endpoint_id`	웹 트랜잭션 중 Zoekt 서버에 대한 호출 수. Premium 및 Ultimate만 해당.
`http_request_duration_seconds`	Histogram	9.4	`method`	성공적인 요청에 대한 Rack 미들웨어의 HTTP 응답 시간
`http_requests_total`	Counter	9.4	`method`, `status`	Rack 요청 수
`job_queue_duration_seconds`	Histogram	9.5		요청 처리 실행 시간
`job_register_attempts_failed_total`	Counter	9.5		러너가 job 등록에 실패한 횟수
`job_register_attempts_total`	Counter	9.5		러너가 job 등록을 시도하는 횟수
`pipeline_graph_link_calculation_duration_seconds`	Histogram	13.9		링크 계산에 소요된 총 시간(초)
`pipeline_graph_links_per_job_ratio`	Histogram	13.9		그래프당 job 대비 링크 비율
`pipeline_graph_links_total`	Histogram	13.9		그래프당 링크 수
`pipelines_created_total`	Counter	9.4	`source`, `partition_id`	생성된 파이프라인 카운터
`pipelines_finished_total`	Counter	19.2	`source`, `partition_id`, `status`	완료된 파이프라인 카운터(성공, 실패 또는 취소)
`rack_uncaught_errors_total`	Counter	9.4		처리되지 않은 오류를 처리하는 Rack 연결 수
`redis_cache_generation_duration_seconds`	Histogram	15.6	`cache_hit`, `cache_identifier`, `feature_category`, `backing_resource`	Redis 캐시를 생성하는 시간
`redis_hit_miss_operations_total`	Counter	15.6	`cache_hit`, `cache_identifier`, `feature_category`, `backing_resource`	Redis 캐시 히트 및 미스의 총 수
`search_advanced_boolean_settings`	Gauge	17.3	`name`	고급 검색 불리언 설정의 현재 상태
`search_advanced_index_repair_total`	Counter	17.3	`document_type`	인덱스 복구 작업 수
`service_desk_new_note_email`	Counter	14.0		새 Service Desk 댓글에 대한 이메일 알림 총 수
`service_desk_thank_you_email`	Counter	14.0		새 Service Desk 이메일에 대한 이메일 응답 총 수
`successful_login_captcha_total`	Gauge	11.0		로그인 중 성공한 CAPTCHA 시도 카운터
`upload_file_does_not_exist`	Counter	10.7		업로드 레코드가 파일을 찾을 수 없는 횟수.
`user_session_logins_total`	Counter	9.4		GitLab이 시작되거나 재시작된 이후 로그인한 사용자 수 카운터
`validity_check_network_errors_total`	Counter	18.6	`partner`, `error_class`	파트너 토큰 검증 API 호출 중 총 네트워크 오류. Ultimate만 해당.
`validity_check_partner_api_duration_seconds`	Histogram	18.6	`partner`	토큰 검증 요청에 대한 파트너 API 응답 시간(초). Ultimate만 해당.
`validity_check_partner_api_requests_total`	Counter	18.6	`partner`, `status`, `error_type`	성공/실패 상태를 포함한 총 파트너 API 검증 요청. Ultimate만 해당.
`validity_check_rate_limit_hits_total`	Counter	18.6	`limit_type`	파트너 토큰 검증 중 총 속도 제한 도달. Ultimate만 해당.

CI/CD 실패 사유 메트릭#

job 실패 사유#

gitlab_ci_job_failure_reasons의 reason 레이블은 job의 실패 사유를 기록합니다. 일반적인 값은 다음과 같습니다.

script_failure: job 스크립트 명령이 0이 아닌 종료 코드를 반환했습니다. docker, docker+machine, kubernetes 실행기에서는 이 값에 Docker 이미지 pull 실패도 포함됩니다. GitLab 19.1 이상에서는 잘못된 이미지 또는 태그로 인한 pull 실패가 runner_configuration_error로 기록되고, 접근할 수 없는 레지스트리로 인한 pull 실패는 runner_external_dependency_failure로 기록됩니다.
api_failure: job 중에 러너가 GitLab API와 통신하지 못했습니다. 예를 들어 job 트레이스를 전송하거나, 아티팩트를 업로드하거나, job 상태를 보고할 때 발생합니다.
runner_system_failure: job 스크립트와 관계없이 러너가 빌드 환경 또는 실행기를 준비하는 중에 실패했습니다.
job_execution_timeout: job이 해당 job에 설정된 최대 실행 시간을 초과했습니다.
downstream_pipeline_creation_failed: 트리거 job이 다운스트림 파이프라인을 생성하지 못했습니다.
unknown_failure: 특정 실패 사유가 기록되지 않았습니다.

전체 값 목록은 retry:when을 참고합니다.

파이프라인 실패 사유#

gitlab_ci_pipeline_failure_reasons의 reason 레이블은 파이프라인의 실패 사유를 기록합니다.

값	설명
`unknown_failure`	파이프라인 실패 사유를 알 수 없습니다.
`config_error`	CI/CD 구성 파일의 오류로 파이프라인이 실패했습니다.
`external_validation_failure`	외부 파이프라인 검증에 실패했습니다.
`user_not_verified`	사용자가 검증되지 않아 파이프라인이 실패했습니다.
`size_limit_exceeded`	파이프라인 크기 제한을 초과했습니다.
`job_activity_limit_exceeded`	파이프라인 job 활동 제한을 초과했습니다.
`deployments_limit_exceeded`	파이프라인 배포 제한을 초과했습니다.
`project_deleted`	파이프라인과 연결된 프로젝트가 삭제되었습니다.
`filtered_by_rules`	`rules`로 모든 job이 제외되어 파이프라인이 생성되지 않았습니다. 이 값은 예상된 동작입니다.
`filtered_by_workflow_rules`	최상위 `workflow:rules`가 파이프라인 실행을 막았습니다. 이 값은 예상된 동작입니다.
`composite_identity_forbidden`	코드를 AI가 아닌 사용자가 먼저 검토해야 하므로 파이프라인이 실행되지 않았습니다.
`pipeline_ref_creation_failure`	GitLab이 파이프라인 ref를 생성하지 못했습니다.
`filtered_by_no_pipeline`	`ci.no_pipeline` 옵션으로 커밋을 푸시하여 파이프라인이 실행되지 않았습니다. 이 값은 예상된 동작입니다.
`gitaly_unavailable`	파이프라인을 생성할 때 Gitaly를 일시적으로 사용할 수 없었습니다.

두 카운터는 Sidekiq 메트릭 표에도 나열되어 있습니다.

Zoekt 메트릭#

히스토리

GitLab 19.2에서 도입되었습니다.

Zoekt로 구동되는 정확한 코드 검색에 대한 메트릭입니다.

요청별 및 job별 메트릭#

이 메트릭은 GitLab Rails에서 Zoekt 노드로 보내는 모든 HTTP 요청에 대해, 웹/Grape 요청과 Sidekiq job 모두에서 생성됩니다.

메트릭	유형	버전	레이블	설명
`http_zoekt_requests_total`	Counter	19.2	`controller`, `action`, `feature_category`, `endpoint_id`	웹 트랜잭션 중 Zoekt 서버에 대한 호출 수. Premium 및 Ultimate만 해당.
`http_zoekt_requests_duration_seconds`	Histogram	19.2	`controller`, `action`, `feature_category`, `endpoint_id`	웹 트랜잭션 중 Zoekt 서버에 대한 쿼리 시간. Premium 및 Ultimate만 해당.
`sidekiq_zoekt_requests_total`	Counter	19.2	`queue`, `boundary`, `external_dependencies`, `feature_category`, `job_status`, `urgency`, `destination_shard_redis`	Sidekiq job 실행 중 Zoekt 요청. Premium 및 Ultimate만 해당.
`sidekiq_zoekt_requests_duration_seconds`	Histogram	19.2	`queue`, `boundary`, `external_dependencies`, `feature_category`, `job_status`, `urgency`, `destination_shard_redis`	Sidekiq job이 Zoekt 서버에 요청하는 데 소요된 시간(초). Premium 및 Ultimate만 해당.

두 개의 sidekiq_zoekt_* 행은 Sidekiq 메트릭 표에도 동등한 Elasticsearch 및 Redis 메트릭과 함께 나열되어 있습니다.

데이터베이스에서 파생된 Zoekt 메트릭(GitLab exporter)#

메트릭	유형	버전	레이블	설명
`search_zoekt_task_processing_queue_size`	Gauge	None	`node_name`, `node_id`	Zoekt가 처리 대기 중인 작업 수.
`search_zoekt_repositories_schema_version_count`	Gauge	None	`target_schema_version`, `zoekt_node_id`, `zoekt_node_name`	최신 스키마 버전이 아닌 `zoekt_repositories` 수.
`search_zoekt_nodes_status`	Gauge	None	`zoekt_node_id`, `zoekt_node_name`	각 Zoekt 노드의 상태. `0`은 오프라인(마지막 확인이 2분 이상 전), `1`은 온라인입니다.
`search_zoekt_node_unclaimed_storage_bytes`	Gauge	None	`zoekt_node_id`, `zoekt_node_name`	Zoekt 노드의 미청구 스토리지 바이트.
`search_zoekt_node_storage_percent_used`	Gauge	None	`zoekt_node_id`, `zoekt_node_name`	Zoekt 노드에서 사용 중인 스토리지 비율(범위: `0`~`1`).
`search_zoekt_repositories_states_total`	Gauge	None	`state`	각 상태의 Zoekt 리포지터리 수.
`search_zoekt_indices_states`	Gauge	None	`state`	각 상태의 Zoekt 인덱스 수.
`search_zoekt_indices_watermark_levels`	Gauge	None	`watermark_level`	각 워터마크 수준의 Zoekt 인덱스 수.
`search_zoekt_indices_reserved_storage_bytes`	Gauge	None	`zoekt_index_id`, `zoekt_node_name`	각 Zoekt 인덱스의 예약된 스토리지 바이트.
`search_zoekt_indices_used_storage_bytes`	Gauge	None	`zoekt_index_id`, `zoekt_node_name`	각 Zoekt 인덱스의 사용된 스토리지 바이트.
`search_zoekt_node_enabled_namespaces`	Gauge	19.2	`node_id`, `node_name`	Zoekt 노드당 활성화된 네임스페이스 수.
`search_zoekt_node_tasks`	Gauge	19.2	`node_id`, `node_name`, `state`	상태별로 분류된 노드의 Zoekt 인덱싱 작업 수.
`search_zoekt_indices_with_stale_used_storage_bytes`	Gauge	19.2	None	마지막 인덱스 실행 이후 `used_storage_bytes` 값이 갱신되지 않은 Zoekt 인덱스 수.

SLI 메트릭#

전역 검색 SLI 메트릭에는 search_type="zoekt" 레이블로 Zoekt 검색이 포함됩니다. 자세한 내용은 애플리케이션 SLI를 참고합니다.

메트릭	유형	버전	레이블	설명
`gitlab_sli_global_search_apdex_success_total`	Counter	14.4	`search_type`, `search_level`, `search_scope`, `endpoint_id`	지연 시간 목표(코드 검색의 경우 15.52초)를 충족한 Zoekt 검색의 총 수. `search_type="zoekt"`로 필터링합니다
`gitlab_sli_global_search_apdex_total`	Counter	14.4	`search_type`, `search_level`, `search_scope`, `endpoint_id`	Zoekt 검색 Apdex 측정의 총 수. `search_type="zoekt"`로 필터링합니다
`gitlab_sli_global_search_error_total`	Counter	14.4	`search_type`, `search_level`, `search_scope`, `endpoint_id`	Zoekt 검색 오류 측정의 총 수. `search_type="zoekt"`로 필터링합니다
`gitlab_sli_global_search_total`	Counter	14.4	`search_type`, `search_level`, `search_scope`, `endpoint_id`	전역 검색 오류율 측정의 총 수. `gitlab_sli_global_search_error_total`을 `gitlab_sli_global_search_total`로 나누면 오류 비율을 구할 수 있습니다. `search_type="zoekt"`로 필터링합니다

Zoekt 작업 SLI 메트릭#

이 메트릭의 Apdex 목표는 ee/lib/gitlab/metrics/zoekt_tasks_slis.rb의 APDEX_THRESHOLD_S입니다. 이 상수가 변경되면 이 섹션을 업데이트합니다.

메트릭	유형	버전	레이블	설명
`gitlab_sli_search_zoekt_tasks_apdex_success_total`	Counter	18.10	`zoekt_node`, `task_type`	7200초(2시간) 목표 안에 완료된 Zoekt 인덱싱 작업의 총 수
`gitlab_sli_search_zoekt_tasks_apdex_total`	Counter	18.10	`zoekt_node`, `task_type`	총 Zoekt 인덱싱 작업 Apdex 측정 수
`gitlab_sli_search_zoekt_tasks_error_total`	Counter	18.10	`zoekt_node`, `task_type`	총 Zoekt 인덱싱 작업 오류 수
`gitlab_sli_search_zoekt_tasks_total`	Counter	18.10	`zoekt_node`, `task_type`	Zoekt 인덱싱 작업 오류율 측정의 총 수. `gitlab_sli_search_zoekt_tasks_error_total`을 `gitlab_sli_search_zoekt_tasks_total`로 나누면 오류 비율을 구할 수 있습니다
`gitlab_sli_search_zoekt_tasks_requests_total`	Counter	18.10	`zoekt_node`, `task_type`	큐에 추가된 총 Zoekt 작업 수
`gitlab_search_zoekt_task_duration_seconds`	Histogram	19.5	`zoekt_node`, `task_type`	Zoekt 인덱싱 작업의 예약 시각부터 완료까지의 시간(초)

감사 이벤트 스트리밍 SLI 메트릭#

이 SLI는 NATS 감사 이벤트 스트리밍 파이프라인을 추적합니다. 자세한 내용은 애플리케이션 SLI를 참고합니다.

메트릭	유형	버전	레이블	설명
`gitlab_sli_audit_event_streaming_nats_dispatch_apdex_success_total`	Counter	19.3	`feature_category`	컨슈머 지연 목표를 충족한 감사 이벤트 배치 디스패치의 총 수
`gitlab_sli_audit_event_streaming_nats_dispatch_apdex_total`	Counter	19.3	`feature_category`	총 감사 이벤트 배치 디스패치 Apdex 측정 수
`gitlab_sli_audit_event_streaming_nats_dispatch_error_total`	Counter	19.3	`feature_category`	실패한 감사 이벤트 배치 디스패치의 총 수
`gitlab_sli_audit_event_streaming_nats_dispatch_total`	Counter	19.3	`feature_category`	총 감사 이벤트 배치 디스패치 시도 수

기능 플래그로 제어되는 메트릭#

다음 메트릭은 기능 플래그로 제어할 수 있습니다.

메트릭	기능 플래그
`gitlab_view_rendering_duration_seconds`	`prometheus_metrics_view_instrumentation`
`gitlab_ci_queue_depth_total`	`gitlab_ci_builds_queuing_metrics`
`gitlab_ci_queue_size`	`gitlab_ci_builds_queuing_metrics`
`gitlab_ci_queue_size_total`	`gitlab_ci_builds_queuing_metrics`
`gitlab_ci_queue_iteration_duration_seconds`	`gitlab_ci_builds_queuing_metrics`
`gitlab_ci_current_queue_size`	`gitlab_ci_builds_queuing_metrics`
`gitlab_ci_queue_retrieval_duration_seconds`	`gitlab_ci_builds_queuing_metrics`
`gitlab_ci_queue_active_runners_total`	`gitlab_ci_builds_queuing_metrics`
`gitaly_circuit_breaker_requests_total`	`add_circuit_breaker_to_gitaly`
`gitaly_circuit_breaker_transitions_total`	`add_circuit_breaker_to_gitaly`
`ruby_gvl_wait_seconds_total`	`enable_sidekiq_gvl_metrics`
`ruby_gvl_wait_seconds_total`	`enable_puma_gvl_metrics`

Praefect 메트릭#

Praefect를 구성하여 메트릭을 보고하도록 할 수 있습니다. 사용 가능한 메트릭은 Gitaly Cluster(Praefect) 모니터링을 참고합니다.

Sidekiq 메트릭#

메트릭	유형	버전	레이블	설명
`destroyed_job_artifacts_count_total`	Counter	13.6		삭제된 만료된 job 아티팩트 수
`destroyed_pipeline_artifacts_count_total`	Counter	13.8		삭제된 만료된 파이프라인 아티팩트 수
`geo_ci_secure_files_checksum_failed`	Gauge	15.3	`url`	기본 사이트에서 체크섬 계산에 실패한 보안 파일 수
`geo_ci_secure_files_checksum_total`	Gauge	15.3	`url`	기본 사이트에서 체크섬할 보안 파일 수
`geo_ci_secure_files_checksummed`	Gauge	15.3	`url`	기본 사이트에서 체크섬을 성공적으로 계산한 보안 파일 수
`geo_ci_secure_files_failed`	Gauge	15.3	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 보안 파일 수
`geo_ci_secure_files_registry`	Gauge	15.3	`url`	레지스트리의 보안 파일 수
`geo_ci_secure_files_synced`	Gauge	15.3	`url`	보조 사이트에서 동기화된 동기화 가능한 보안 파일 수
`geo_ci_secure_files_verification_failed`	Gauge	15.3	`url`	보조 사이트에서 검증에 실패한 보안 파일 수
`geo_ci_secure_files_verification_total`	Gauge	15.3	`url`	보조 사이트에서 검증을 시도할 보안 파일 수
`geo_ci_secure_files_verified`	Gauge	15.3	`url`	보조 사이트에서 성공적으로 검증된 보안 파일 수
`geo_ci_secure_files`	Gauge	15.3	`url`	기본 사이트의 보안 파일 수
`geo_container_repositories_checksum_failed`	Gauge	15.10	`url`	기본 사이트에서 체크섬 계산에 실패한 컨테이너 리포지터리 수
`geo_container_repositories_checksum_total`	Gauge	15.10	`url`	기본 사이트에서 성공적으로 체크섬된 컨테이너 리포지터리 수
`geo_container_repositories_checksummed`	Gauge	15.10	`url`	기본 사이트에서 체크섬을 시도한 컨테이너 리포지터리 수
`geo_container_repositories_failed`	Gauge	15.4	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 컨테이너 리포지터리 수
`geo_container_repositories_registry`	Gauge	15.4	`url`	레지스트리의 컨테이너 리포지터리 수
`geo_container_repositories_synced`	Gauge	15.4	`url`	보조 사이트에서 동기화된 컨테이너 리포지터리 수
`geo_container_repositories_verification_failed`	Gauge	15.10	`url`	보조 사이트에서 검증에 실패한 컨테이너 리포지터리 수
`geo_container_repositories_verification_total`	Gauge	15.10	`url`	보조 사이트에서 검증을 시도한 컨테이너 리포지터리 수
`geo_container_repositories_verified`	Gauge	15.10	`url`	보조 사이트에서 검증된 컨테이너 리포지터리 수
`geo_container_repositories`	Gauge	15.4	`url`	기본 사이트의 컨테이너 리포지터리 수
`geo_cursor_last_event_id`	Gauge	10.2	`url`	보조 사이트에서 처리된 이벤트 로그의 마지막 데이터베이스 ID
`geo_cursor_last_event_timestamp`	Gauge	10.2	`url`	보조 사이트에서 처리된 이벤트 로그의 마지막 UNIX 타임스탬프
`geo_db_replication_lag_seconds`	Gauge	10.2	`url`	데이터베이스 복제 지연(초)
`geo_dependency_proxy_blob_checksum_failed`	Gauge	15.6		기본 사이트에서 체크섬 계산에 실패한 dependency proxy 블롭 수
`geo_dependency_proxy_blob_checksum_total`	Gauge	15.6		기본 사이트에서 체크섬할 dependency proxy 블롭 수
`geo_dependency_proxy_blob_checksummed`	Gauge	15.6		기본 사이트에서 체크섬을 성공적으로 계산한 dependency proxy 블롭 수
`geo_dependency_proxy_blob_failed`	Gauge	15.6		보조 사이트에서 동기화에 실패한 dependency proxy 블롭 수
`geo_dependency_proxy_blob_registry`	Gauge	15.6		레지스트리의 dependency proxy 블롭 수
`geo_dependency_proxy_blob_synced`	Gauge	15.6		보조 사이트에서 동기화된 dependency proxy 블롭 수
`geo_dependency_proxy_blob_verification_failed`	Gauge	15.6		보조 사이트에서 검증에 실패한 dependency proxy 블롭 수
`geo_dependency_proxy_blob_verification_total`	Gauge	15.6		보조 사이트에서 검증을 시도할 dependency proxy 블롭 수
`geo_dependency_proxy_blob_verified`	Gauge	15.6		보조 사이트에서 성공적으로 검증된 dependency proxy 블롭 수
`geo_dependency_proxy_blob`	Gauge	15.6		기본 사이트의 dependency proxy 블롭 수
`geo_dependency_proxy_manifests_checksum_failed`	Gauge	15.6	`url`	기본 사이트에서 체크섬 계산에 실패한 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_checksum_total`	Gauge	15.6	`url`	기본 사이트에서 체크섬할 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_checksummed`	Gauge	15.6	`url`	기본 사이트에서 체크섬을 성공적으로 계산한 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_failed`	Gauge	15.6	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_registry`	Gauge	15.6	`url`	레지스트리의 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_synced`	Gauge	15.6	`url`	보조 사이트에서 동기화된 동기화 가능한 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_verification_failed`	Gauge	15.6	`url`	보조 사이트에서 검증에 실패한 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_verification_total`	Gauge	15.6	`url`	보조 사이트에서 검증을 시도할 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests_verified`	Gauge	15.6	`url`	보조 사이트에서 성공적으로 검증된 dependency proxy 매니페스트 수
`geo_dependency_proxy_manifests`	Gauge	15.6	`url`	기본 사이트의 dependency proxy 매니페스트 수
`geo_design_management_repositories_checksum_failed`	Gauge	16.1	`url`	기본 사이트에서 체크섬 계산에 실패한 디자인 리포지터리 수
`geo_design_management_repositories_checksum_total`	Gauge	16.1	`url`	기본 사이트에서 체크섬을 시도한 디자인 리포지터리 수
`geo_design_management_repositories_checksummed`	Gauge	16.1	`url`	기본 사이트에서 성공적으로 체크섬된 디자인 리포지터리 수
`geo_design_management_repositories_failed`	Gauge	16.1	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 디자인 리포지터리 수
`geo_design_management_repositories_registry`	Gauge	16.1	`url`	레지스트리의 디자인 리포지터리 수
`geo_design_management_repositories_synced`	Gauge	16.1	`url`	보조 사이트에서 동기화된 동기화 가능한 디자인 리포지터리 수
`geo_design_management_repositories_verification_failed`	Gauge	16.1	`url`	보조 사이트에서 검증에 실패한 디자인 리포지터리 수
`geo_design_management_repositories_verification_total`	Gauge	16.1	`url`	보조 사이트에서 검증을 시도한 디자인 리포지터리 수
`geo_design_management_repositories_verified`	Gauge	16.1	`url`	보조 사이트에서 검증된 디자인 리포지터리 수
`geo_design_management_repositories`	Gauge	16.1	`url`	기본 사이트의 디자인 리포지터리 수
`geo_group_wiki_repositories_checksum_failed`	Gauge	13.10	`url`	기본 사이트에서 체크섬 계산에 실패한 그룹 위키 수
`geo_group_wiki_repositories_checksum_total`	Gauge	16.3	`url`	기본 사이트에서 체크섬할 그룹 위키 수
`geo_group_wiki_repositories_checksummed`	Gauge	13.10	`url`	기본 사이트에서 체크섬을 성공적으로 계산한 그룹 위키 수
`geo_group_wiki_repositories_failed`	Gauge	13.10	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 그룹 위키 수
`geo_group_wiki_repositories_registry`	Gauge	13.10	`url`	레지스트리의 그룹 위키 수
`geo_group_wiki_repositories_synced`	Gauge	13.10	`url`	보조 사이트에서 동기화된 동기화 가능한 그룹 위키 수
`geo_group_wiki_repositories_verification_failed`	Gauge	16.3	`url`	보조 사이트에서 검증에 실패한 그룹 위키 수
`geo_group_wiki_repositories_verification_total`	Gauge	16.3	`url`	보조 사이트에서 검증을 시도할 그룹 위키 수
`geo_group_wiki_repositories_verified`	Gauge	16.3	`url`	보조 사이트에서 성공적으로 검증된 그룹 위키 수
`geo_group_wiki_repositories`	Gauge	13.10	`url`	기본 사이트의 그룹 위키 수
`geo_job_artifacts_checksum_failed`	Gauge	14.8	`url`	기본 사이트에서 체크섬 계산에 실패한 job 아티팩트 수
`geo_job_artifacts_checksum_total`	Gauge	14.8	`url`	기본 사이트에서 체크섬할 job 아티팩트 수
`geo_job_artifacts_checksummed`	Gauge	14.8	`url`	기본 사이트에서 체크섬을 성공적으로 계산한 job 아티팩트 수
`geo_job_artifacts_failed`	Gauge	14.8	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 job 아티팩트 수
`geo_job_artifacts_registry`	Gauge	14.8	`url`	레지스트리의 job 아티팩트 수
`geo_job_artifacts_synced`	Gauge	14.8	`url`	보조 사이트에서 동기화된 동기화 가능한 job 아티팩트 수
`geo_job_artifacts_verification_failed`	Gauge	14.8	`url`	보조 사이트에서 검증에 실패한 job 아티팩트 수
`geo_job_artifacts_verification_total`	Gauge	14.8	`url`	보조 사이트에서 검증을 시도할 job 아티팩트 수
`geo_job_artifacts_verified`	Gauge	14.8	`url`	보조 사이트에서 성공적으로 검증된 job 아티팩트 수
`geo_job_artifacts`	Gauge	14.8	`url`	기본 사이트의 job 아티팩트 수
`geo_last_event_id`	Gauge	10.2	`url`	기본 사이트의 최신 이벤트 로그 항목의 데이터베이스 ID
`geo_last_event_timestamp`	Gauge	10.2	`url`	기본 사이트의 최신 이벤트 로그 항목의 UNIX 타임스탬프
`geo_last_successful_status_check_timestamp`	Gauge	10.2	`url`	상태가 마지막으로 성공적으로 업데이트된 타임스탬프
`geo_lfs_objects_checksum_failed`	Gauge	14.6	`url`	기본 사이트에서 체크섬 계산에 실패한 LFS 오브젝트 수
`geo_lfs_objects_checksum_total`	Gauge	14.6	`url`	기본 사이트에서 체크섬할 필요가 있는 LFS 오브젝트 수
`geo_lfs_objects_checksummed`	Gauge	14.6	`url`	기본 사이트에서 성공적으로 체크섬된 LFS 오브젝트 수
`geo_lfs_objects_failed`	Gauge	10.2	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 LFS 오브젝트 수
`geo_lfs_objects_registry`	Gauge	14.6	`url`	레지스트리의 LFS 오브젝트 수
`geo_lfs_objects_synced`	Gauge	10.2	`url`	보조 사이트에서 동기화된 동기화 가능한 LFS 오브젝트 수
`geo_lfs_objects_verification_failed`	Gauge	14.6	`url`	보조 사이트에서 검증에 실패한 LFS 오브젝트 수
`geo_lfs_objects_verification_total`	Gauge	14.6	`url`	보조 사이트에서 검증을 시도할 LFS 오브젝트 수
`geo_lfs_objects_verified`	Gauge	14.6	`url`	보조 사이트에서 성공적으로 검증된 LFS 오브젝트 수
`geo_lfs_objects`	Gauge	10.2	`url`	기본 사이트의 LFS 오브젝트 수
`geo_merge_request_diffs_checksum_failed`	Gauge	13.4	`url`	기본 사이트에서 체크섬 계산에 실패한 머지 리퀘스트 diff 수
`geo_merge_request_diffs_checksum_total`	Gauge	13.12	`url`	기본 사이트에서 체크섬할 머지 리퀘스트 diff 수
`geo_merge_request_diffs_checksummed`	Gauge	13.4	`url`	기본 사이트에서 성공적으로 체크섬된 머지 리퀘스트 diff 수
`geo_merge_request_diffs_failed`	Gauge	13.4	`url`	보조 사이트에서 동기화에 실패한 동기화 가능한 머지 리퀘스트 diff 수
`geo_merge_request_diffs_registry`	Gauge	13.4	`url`	레지스트리의 머지 리퀘스트 diff 수

데이터베이스 로드 밸런싱 메트릭#

다음 메트릭을 사용할 수 있습니다.

메트릭	유형	버전	레이블	설명
`db_load_balancing_hosts`	Gauge	12.3		로드 밸런싱 호스트의 현재 수
`sidekiq_load_balancing_count`	Counter	13.11	`queue`, `boundary`, `external_dependencies`, `feature_category`, `job_status`, `urgency`, `data_consistency`, `load_balancing_strategy`	데이터 일관성이 `:sticky` 또는 `:delayed`로 설정된 로드 밸런싱을 사용하는 Sidekiq job 수
`gitlab_transaction_caught_up_replica_pick_count_total`	Counter	14.1	`result`	업데이트된 복제본에 대한 검색 시도 수

데이터베이스 파티셔닝 메트릭#

다음 메트릭을 사용할 수 있습니다.

메트릭	유형	버전	설명
`db_partitions_present`	Gauge	13.4	존재하는 데이터베이스 파티션 수
`db_partitions_missing`	Gauge	13.4	현재 예상되지만 존재하지 않는 데이터베이스 파티션 수

연결 풀 메트릭#

이 메트릭은 데이터베이스 연결 풀의 상태를 기록하며, 모든 메트릭에는 다음 레이블이 있습니다.

class - 기록되는 Ruby 클래스입니다.
- ActiveRecord::Base는 기본 데이터베이스 연결입니다.
- Geo::TrackingBase는 Geo 추적 데이터베이스에 대한 연결입니다(활성화된 경우).
host - 데이터베이스 연결에 사용되는 호스트 이름입니다.
port - 데이터베이스 연결에 사용되는 포트입니다.

메트릭	유형	버전	설명
`gitlab_database_connection_pool_size`	Gauge	13.0	총 연결 풀 용량
`gitlab_database_connection_pool_connections`	Gauge	13.0	풀에 생성된 연결 수.¹
`gitlab_database_connection_pool_busy`	Gauge	13.0	소유자가 아직 살아있는 사용 중인 연결
`gitlab_database_connection_pool_dead`	Gauge	13.0	소유자가 살아있지 않은 사용 중인 연결
`gitlab_database_connection_pool_idle`	Gauge	13.0	생성되었지만 현재 사용되지 않는 연결
`gitlab_database_connection_pool_waiting`	Gauge	13.0	현재 이 큐에서 대기 중인 스레드
`gitlab_database_extended_connection_pool_busy`	Gauge	18.11	소유자가 아직 살아있는 사용 중인 연결(스레드별)
`gitlab_database_extended_connection_pool_dead`	Gauge	18.11	소유자가 살아있지 않은 사용 중인 연결(스레드별)

GitLab 18.11 이상에서는 기본 연결 풀 게이지가 Puma 워커 프로세스 전체에서 집계되므로, 워커별로 하나가 아니라 Pod별로 하나의 시계열이 생성됩니다.

집계에는 GitLab이 사용하는 prometheus-client-mmap 클라이언트가 지원하는 multiprocess_mode 설정을 사용합니다.

gitlab_database_connection_pool_size는 min을 사용합니다. Puma 워커는 같은 구성으로 포크되므로 이 값은 Pod 안의 모든 워커에서 동일하며, min은 그 공통 값을 그대로 나타냅니다.
gitlab_database_connection_pool_connections, gitlab_database_connection_pool_busy, gitlab_database_connection_pool_dead, gitlab_database_connection_pool_idle, gitlab_database_connection_pool_waiting은 max(최악의 경우 워커)를 사용합니다.

단일 워커 프로세스가 풀을 포화시키면, 같은 Pod의 다른 워커가 무엇을 하고 있든 상관없이 그 워커는 요청을 처리할 수 없습니다.

연결 풀 포화 모니터링에는 connections에서 idle을 뺀 값 대신 busy와 dead의 합을 사용합니다.

Ruby 메트릭#

몇 가지 기본 Ruby 런타임 메트릭을 사용할 수 있습니다.

메트릭	유형	버전	설명
`ruby_gc_duration_seconds`	Counter	11.1	Ruby GC에서 소요된 시간
`ruby_gc_stat_...`	Gauge	11.1	GC.stat의 다양한 메트릭
`ruby_gc_stat_ext_heap_fragmentation`	Gauge	15.2	에덴 슬롯 대비 라이브 오브젝트로 측정된 Ruby 힙 단편화 수준(범위 0 ~ 1)
`ruby_gvl_wait_seconds_total`	Gauge	19.4	이 프로세스의 모든 스레드가 Global VM Lock을 기다리며 보낸 시간(초). 기능 플래그로 제어됩니다
`ruby_file_descriptors`	Gauge	11.1	프로세스당 파일 디스크립터
`ruby_sampler_duration_seconds`	Counter	11.1	통계 수집에 소요된 시간
`ruby_process_cpu_seconds_total`	Gauge	12.0	프로세스당 총 CPU 시간
`ruby_process_max_fds`	Gauge	12.0	프로세스당 최대 열린 파일 디스크립터 수
`ruby_process_resident_memory_bytes`	Gauge	12.0	프로세스의 메모리 사용량(RSS/상주 세트 크기)
`ruby_process_resident_anon_memory_bytes`	Gauge	15.6	프로세스의 익명 메모리 사용량(RSS/상주 세트 크기)
`ruby_process_resident_file_memory_bytes`	Gauge	15.6	프로세스의 파일 지원 메모리 사용량(RSS/상주 세트 크기)
`ruby_process_unique_memory_bytes`	Gauge	13.0	프로세스의 메모리 사용량(USS/고유 세트 크기)
`ruby_process_proportional_memory_bytes`	Gauge	13.0	프로세스의 메모리 사용량(PSS/비례 세트 크기)
`ruby_process_start_time_seconds`	Gauge	12.0	프로세스 시작 시간의 UNIX 타임스탬프

Puma 메트릭#

메트릭	유형	버전	설명
`puma_workers`	Gauge	12.0	총 워커 수
`puma_running_workers`	Gauge	12.0	부팅된 워커 수
`puma_stale_workers`	Gauge	12.0	오래된 워커 수
`puma_running`	Gauge	12.0	실행 중인 스레드 수
`puma_queued_connections`	Gauge	12.0	워커 스레드를 기다리는 해당 워커의 "to do" 세트의 연결 수
`puma_active_connections`	Gauge	12.0	요청을 처리 중인 스레드 수
`puma_pool_capacity`	Gauge	12.0	워커가 현재 처리할 수 있는 요청 수
`puma_max_threads`	Gauge	12.0	최대 워커 스레드 수
`puma_idle_threads`	Gauge	12.0	요청을 처리하지 않는 생성된 스레드 수

Redis 메트릭#

메트릭	유형	버전	설명
`gitlab_redis_client_exceptions_total`	Counter	13.2	Redis 클라이언트 예외 수(예외 클래스별로 세분화)
`gitlab_redis_client_requests_total`	Counter	13.2	Redis 클라이언트 요청 수
`gitlab_redis_client_requests_duration_seconds`	Histogram	13.2	Redis 요청 지연 시간(차단 명령 제외)
`gitlab_redis_client_redirections_total`	Counter	15.10	Redis 클러스터 MOVED/ASK 리디렉션 수(리디렉션 유형별로 세분화)
`gitlab_redis_client_requests_pipelined_commands`	Histogram	16.4	단일 Redis 서버에 전송된 파이프라인당 명령 수
`gitlab_redis_client_pipeline_redirections_count`	Histogram	17.0	파이프라인의 Redis 클러스터 리디렉션 수

Git LFS 메트릭#

다양한 Git LFS 기능을 추적하는 메트릭입니다.

메트릭	유형	버전	설명
`gitlab_sli_lfs_update_objects_total`	Counter	16.10	총 업데이트된 LFS 오브젝트 수
`gitlab_sli_lfs_update_objects_error_total`	Counter	16.10	총 업데이트된 LFS 오브젝트 오류 수
`gitlab_sli_lfs_check_objects_total`	Counter	16.10	총 확인된 LFS 오브젝트 수
`gitlab_sli_lfs_check_objects_error_total`	Counter	16.10	총 확인된 LFS 오브젝트 오류 수
`gitlab_sli_lfs_validate_link_objects_total`	Counter	16.10	총 검증된 LFS 연결 오브젝트 수
`gitlab_sli_lfs_validate_link_objects_error_total`	Counter	16.10	총 검증된 LFS 연결 오브젝트 오류 수

시크릿 탐지 파트너 토큰 검증 메트릭#

히스토리

GitLab 18.6에서 도입되었습니다.

외부 파트너 API(AWS, GCP, Postman 등)를 통한 시크릿 탐지 파트너 토큰 검증을 추적하는 메트릭입니다.

메트릭	유형	버전	레이블	설명
`validity_check_partner_api_duration_seconds`	Histogram	18.6	`partner`	파트너 토큰 검증 요청에 대한 API 응답 시간 추적. 히스토그램 버킷: [0.1, 0.25, 0.5, 1, 2, 5, 10] 초.
`validity_check_partner_api_requests_total`	Counter	18.6	`partner`, `status`, `error_type`	파트너 API 검증 요청의 총 수. `status`는 `success` 또는 `failure`일 수 있습니다. `error_type`은 실패한 경우에만 포함됩니다(예: `network_error`, `rate_limit`, `response_error`).
`validity_check_network_errors_total`	Counter	18.6	`partner`, `error_class`	파트너 API 호출 중 발생한 네트워크 오류의 총 수. `error_class`는 오류 유형을 나타냅니다(예: `Timeout`, `ConnectionRefused`, `HTTPError`).
`validity_check_rate_limit_hits_total`	Counter	18.6	`limit_type`	토큰 검증 중 속도 제한에 도달한 총 횟수. `limit_type`은 파트너 속도 제한 키에 해당합니다(예: `partner_aws_api`, `partner_gcp_api`, `partner_postman_api`).

파트너 레이블#

partner 레이블은 다음 값을 가질 수 있습니다.

aws - Amazon Web Services 토큰
gcp - Google Cloud Platform 토큰
postman - Postman API 토큰

메트릭 공유 디렉터리#

이 디렉터리의 위치는 환경 변수 prometheus_multiproc_dir로 구성합니다. 최상의 성능을 위해 이 디렉터리를 tmpfs에 생성합니다.

GitLab을 Linux 패키지로 설치했고 tmpfs를 사용할 수 있으면 GitLab이 메트릭 디렉터리를 자동으로 구성합니다.

idle은 사용 중이 아닌 초기화된 연결만 계산하므로, busy, dead, idle 연결의 합계는 전체 연결 수보다 작거나 같을 수 있습니다. ↩

GitLab Prometheus 메트릭

메트릭 수집#

사용 가능한 메트릭#

CI/CD 실패 사유 메트릭#

job 실패 사유#

파이프라인 실패 사유#

Zoekt 메트릭#

요청별 및 job별 메트릭#

데이터베이스에서 파생된 Zoekt 메트릭(GitLab exporter)#

SLI 메트릭#

Zoekt 작업 SLI 메트릭#

감사 이벤트 스트리밍 SLI 메트릭#

기능 플래그로 제어되는 메트릭#

Praefect 메트릭#

Sidekiq 메트릭#

데이터베이스 로드 밸런싱 메트릭#

데이터베이스 파티셔닝 메트릭#

연결 풀 메트릭#

Ruby 메트릭#

Puma 메트릭#

Redis 메트릭#

Git LFS 메트릭#

시크릿 탐지 파트너 토큰 검증 메트릭#

파트너 레이블#

메트릭 공유 디렉터리#

Footnotes

GitLab Prometheus 메트릭

메트릭 수집#

사용 가능한 메트릭#

CI/CD 실패 사유 메트릭#

job 실패 사유#

파이프라인 실패 사유#

Zoekt 메트릭#

요청별 및 job별 메트릭#

데이터베이스에서 파생된 Zoekt 메트릭(GitLab exporter)#

SLI 메트릭#

Zoekt 작업 SLI 메트릭#

감사 이벤트 스트리밍 SLI 메트릭#

기능 플래그로 제어되는 메트릭#

Praefect 메트릭#

Sidekiq 메트릭#

데이터베이스 로드 밸런싱 메트릭#

데이터베이스 파티셔닝 메트릭#

연결 풀 메트릭#

Ruby 메트릭#

Puma 메트릭#

Redis 메트릭#

Git LFS 메트릭#

시크릿 탐지 파트너 토큰 검증 메트릭#

파트너 레이블#

메트릭 공유 디렉터리#

Footnotes