Internal Event 추적 빠른 시작
Internal Event Tracking을 사용하여 GitLab 코드베이스에서 이벤트를 정의하고, 메트릭을 생성하며, 백엔드 및 프론트엔드에서 이벤트를 트리거하는 방법을 설명합니다.
보다 효율적이고 확장 가능하며 통합된 추적 API를 제공하기 위해 GitLab은 기존의 RedisHLL 및 Snowplow 추적을 더 이상 사용하지 않을 예정입니다. 대신, 새로운 track_event (백엔드) 및 trackEvent (프론트엔드) 메서드를 구현하고 있습니다. 이 접근 방식을 사용하면 기본 구현에 대한 걱정 없이 RedisHLL 카운터를 업데이트하고 Snowplow 이벤트를 전송할 수 있습니다. 중요 : GitLab 18.0부터 GitLab Self-Managed 인스턴스에서도 이벤트 데이터를 수집하여, 이전 버전에서 수집된 집계 메트릭보다 더 상세한 인사이트를 제공합니다. Internal Events 추적으로 코드를 계측하려면 세 가지 작업이 필요합니다: 이벤트 정의 하나 이상의 메트릭 정의 이벤트 트리거 이벤트 및 메트릭 정의 # 이벤트 및/또는 메트릭 정의를 생성하려면 gitlab_internal_events_cli gem 을 사용합니다. gem install gitlab_internal_events_cli gem exec gitlab_internal_events_cli 이 CLI gem은 특정 사용 사례에 맞는 올바른 정의 파일을 생성하는 데 도움을 주며, 계측 및 테스트를 위한 코드 예제도 제공합니다. 이벤트 이름은 <action>_<target_of_action>_<where/when> 형식으로 지정해야 하며, 유효한 예로는 create_ci_build 또는 click_previous_blame_on_blob_page 가 있습니다. 계측 에이전트로 계측 구현 # Analytics Instrumentation 그룹은 Internal Events 계측을 계획, 구현, 리뷰하는 GitLab Duo Agent Platform 에이전트와 플로를 유지 관리합니다. 에이전트를 함께 사용해 분석 계측을 처음부터 끝까지 구현합니다. 플래너 에이전트가 추적 아이디어를 바로 구현할 수 있는 이슈로 만듭니다. 구현 에이전트가 이슈나 프롬프트에 설명된 추적을 구현하고 머지 리퀘스트를 엽니다. 리뷰어 에이전트가 머지 리퀘스트를 리뷰합니다. 각 에이전트를 단독으로 사용할 수도 있습니다. 에이전트를 호출하고 채팅에서 함께 작업합니다. 플로는 해당 에이전트와 같은 지침을 사용합니다. 이슈나 머지 리퀘스트에서 플로를 트리거하면 플로가 그곳에 결과를 게시합니다. 이름 유형 기능 시작 방법 Instrumentation Planner Agent 에이전트 추적 아이디어를 Analytics Instrumentation Agent Issue 템플릿 을 사용하는 구현 준비 완료 이슈로 만들거나 기존 이슈에 조사 내용을 추가합니다. 채팅에서 추적할 내용을 설명하거나, 이슈를 참조하거나, 페이지 URL과 UI 상호작용 목록을 제공합니다. Instrumentation Implementation Agent 에이전트 이벤트 및 메트릭 정의, 계측 코드, 스펙을 만든 다음 머지 리퀘스트를 열거나 업데이트합니다. 채팅에서 추적할 내용을 설