내부 애널리틱스

GitLab 인스턴스에서 사용자 행동 및 시스템 상태를 추적하는 내부 애널리틱스 시스템의 개념, 계측 방법, 데이터 탐색 및 데이터 흐름을 설명합니다.

내부 애널리틱스 시스템은 고객 성공 서비스와 제품 개발 방향을 결정하기 위해 GitLab 인스턴스의 사용자 행동 및 시스템 상태를 추적하는 기능을 제공합니다. 이 문서 페이지들은 새로운 기능을 개발하거나 기존 기능을 계측할 때 GitLab의 내부 애널리틱스 기능을 활용하는 방법에 대한 가이드와 정보를 제공합니다. 기본 개념 # 이벤트와 메트릭의 개념 에 관한 동영상을 참조하세요. 이벤트와 메트릭은 내부 애널리틱스 시스템의 기반입니다. 두 개념 간의 차이를 이해하는 것이 시스템을 올바르게 사용하는 데 필수적입니다. 이벤트 # 이벤트는 GitLab 인스턴스 내에서 발생한 작업의 기록입니다. 작업의 예로는 이슈 페이지 방문이나 상단 내비게이션 검색 위로 마우스 커서를 올리는 것과 같은 사용자 상호작용이 있습니다. 다른 작업은 예약된 파이프라인 성공이나 서드파티 시스템으로부터 API 호출을 수신하는 것과 같은 백그라운드 시스템 처리에서 발생할 수 있습니다. 모든 작업이 추적되어 자동으로 기록된 이벤트로 전환되는 것은 아닙니다. 대신, 작업이 제품 인사이트를 도출하고 보다 근거 있는 비즈니스 결정을 내리는 데 도움이 된다면, 해당 작업이 발생할 때 이벤트를 추적할 수 있습니다. 생성된 이벤트 기록은 최소한 해당 작업이 발생했다는 정보를 포함하며, 이 작업에 수반된 컨텍스트에 대한 추가 세부 정보를 포함할 수도 있습니다. 컨텍스트의 예로는 작업을 수행한 사람에 대한 정보나 작업 시점의 시스템 상태가 있습니다. 메트릭 # 단일 이벤트 기록은 충분한 정보를 제공하지 못하며 우연의 일치에 의한 것일 수도 있습니다. 분석의 기초를 마련하려면 공통 특성을 공유하는 이벤트 집합을 살펴봐야 합니다. 이것이 바로 메트릭이 활용되는 지점입니다. 메트릭은 정보 조각들에 대해 수행되는 계산입니다. 예를 들어, 새 기능이 출시된 후 유료 사용자가 해당 기능 페이지를 방문한 단일 이벤트만으로는 이 새 기능의 성공 여부를 알 수 없습니다. 그러나 새 기능 출시 전 일주일 동안 발생한 페이지 조회 이벤트 수를 기능 출시 후 일주일 동안의 이벤트 수와 비교하면, 새 기능 출시로 인한 관심 증가에 대한 인사이트를 도출할 수 있습니다. 이 과정에서 우리가 메트릭이라고 부르는 것이 생성됩니다. 이벤트 기반 메트릭은 전체 또는 지정된 기간 내에 이벤트가 발생한 횟수를 계산합니다. 동일한 이벤트를 여러 메트릭에서 사용할 수 있으며, 메트릭은 하나 또는 여러 이벤트를 계산할 수 있습니다. 계산은 이벤트를 수행한 고유 사용자만 계산하는 것과 같은 고유성 기준에 기반할 수 있지만, 반드시 그럴 필요는 없습니다. 메트릭이 반드시 이벤트에 기반할 필요는 없습니다. 메트릭은 설정 값이나 데이터베이스(DB) 테이블의 행 수와 같이 GitLab 인스턴스 자체의 상태에 대한 관측값이 될 수도 있습니다. 계측 # 계측 계획을 만들려면 이 템플릿 을 사용하세요. 이벤트 기반 메트릭을 계측하려면 내부 이벤트 추적 빠른 시작 가이드 를 참조하세요. GitLab 인스턴스 상태를 관측하는 메트릭을 계측하려면 메