메트릭 정의 가이드

내부 이벤트 계측에서 사용하는 메트릭 정의 YAML 파일의 구조, 지원 메트릭 유형, 이벤트 선택 규칙, 집계 메트릭 작성 방법을 설명합니다.

메트릭은 config/metrics 및 ee/config/metrics 의 하위 폴더에 위치한 YAML 파일로 정의됩니다. 이 YAML 파일들을 메트릭 정의라고 합니다. 이 페이지에서는 data_source: internal_events 를 사용하는 메트릭 정의의 하위 섹션을 설명합니다. 메트릭 정의 파일에 대한 일반적인 개요는 메트릭 딕셔너리 가이드 에서 확인할 수 있습니다. 지원되는 메트릭 유형 # 내부 이벤트는 다음과 같이 그룹화된 세 가지 메트릭 유형을 지원합니다: 전체 기간 합계 카운터 시간 범위 합계 카운터 시간 범위 고유 카운터 카운트 유형 / 시간 범위 7d / 28d all 합계 카운트 시간 범위 합계 카운터 전체 기간 합계 카운터 고유 카운트 시간 범위 고유 카운터 메트릭이 고유 값을 카운트하는지 또는 합계 값을 카운트하는지는 이벤트 선택 규칙 을 통해 확인할 수 있습니다. 고유 메트릭의 스니펫 예시는 다음과 같습니다. create_merge_request 이벤트의 고유 값 카운트에 사용되는 식별자 를 정의하는 unique 속성에 주목하세요. events: - name: create_merge_request unique: user.id 마찬가지로, 합계 카운트 메트릭의 스니펫은 다음과 같습니다. unique 속성이 없다는 점에 주목하세요. events: - name: create_merge_request 집계 메트릭 을 통해 하나의 메트릭 내에서 여러 이벤트를 추적할 수 있습니다. 전체 기간 합계 카운터 # 예시: /groups/:group/-/analytics/productivity_analytics 에 대한 전체 기간 방문 합계 data_category: optional key_path: counts.productivity_analytics_views description: Total visits to /groups/:group/-/analytics/productivity_analytics all time product_group: optimize value_type: number status: active time_frame: all data_source: internal_events events: - name: view_productivity_analytics tiers: - premium - ultimate performance_indicator_type: [] milestone: "<13.9" time_frame: all 과 view_productivity_analytics 이벤트를 참조하는 events 하위의 이벤트 선택 규칙의 조합은 이것이 "전체 기간 합계 카운트" 메트릭임을 의미합니다. 시간 범위 합계 카운터 # 예시: Runner 사용량 CSV 보고서 내보내기의 주간 카운트 key_path: counts.count_total_export_runner_usage_by_project_as_csv_weekly description: Weekly count of Runner usage CSV rep