GitLab Duo 도입 메트릭 및 분석

CI 기반 데이터 수집 파이프라인, GraphQL API 클라이언트, Duo Analytics 대시보드를 사용하여 GitLab Duo 도입 및 사용량을 측정하고 시각화합니다.

GitLab Duo 도입 메트릭 및 분석 # 이 프로젝트는 다음을 결합하여 엔드투엔드 GitLab Duo 사용 분석을 제공합니다: Duo GraphQL 데이터 수집 – GitLab GraphQL API 클라이언트를 기반으로 하는 Duo 수집기 스크립트를 호출하는 범용 Python 오케스트레이터. Duo 사용 메트릭 파이프라인 – GitLab 그룹의 Duo 사용 데이터를 주기적으로 수집하고 집계하는 CI 작업. Duo Analytics 대시보드 – Duo 도입, 사용 강도, 참여 트렌드를 보여주는 GitLab Pages 호스팅 대시보드. 시작하기 # 다음 프로젝트 CI/CD 변수 를 설정하여 실행할 분석 파이프라인을 제어할 수 있습니다: 변수 Duo 설정 설명 ENABLE_DUO_METRICS "true" Duo AI 메트릭 파이프라인 활성화/비활성화. ENABLE_PROJECT_METRICS "false" Duo 도입에만 관심이 있는 경우 기존 프로젝트 중심 메트릭 비활성화. DUO_TOKEN TOKEN VALUE Duo 사용 수집을 위한 read_api 및 ai_features 권한이 있는 개인 액세스 토큰. GROUP_PATH example_group Duo 메트릭을 수집할 최상위 그룹 또는 하위 그룹 경로. 빠른 시작 단계 이 저장소를 포크합니다. 프로젝트 설정 → CI/CD → 변수 로 이동합니다. 환경에 적합한 값으로 위의 변수를 추가합니다. 원하는 간격으로 예약된 파이프라인 을 구성합니다. Duo 사용 수집은 리소스를 많이 사용할 수 있으므로 하루에 한 번 실행을 권장합니다. 예약된 파이프라인을 수동으로 실행하거나 예약을 기다립니다. 파이프라인이 완료된 후 배포 → Pages 에서 Pages 애플리케이션을 열어 Duo Analytics 대시보드에 액세스합니다. GitLab Pages 배포 (Duo 메트릭) # Duo 메트릭이 활성화되면 Duo 파이프라인이 완료된 후 Pages 배포가 자동으로 수행됩니다: Duo 메트릭 파이프라인 → https://your-username.gitlab.io/project-name/duo-metrics/ 와 같은 URL에 배포됩니다. 메인 랜딩 페이지 → https://your-username.gitlab.io/project-name/ 에서 사용 가능하며, 사용 가능한 대시보드 링크가 있습니다. 랜딩 페이지는 어떤 대시보드가 있는지 자동으로 감지하고 ENABLE_DUO_METRICS="true" 인 경우 Duo 관련 링크를 표시합니다. 로컬 개발 및 테스트 # CI 없이 Duo 분석을 로컬에서 테스트하려면: Python과 의존성이 설치되어 있는지 확인합니다(예: 저장소 루트에서 poetry install 사용). 로컬 .env 또는 쉘 세션에서 필요한 환경 변수를 설정합니다: DUO_TOKEN GROUP_PATH 원시 Duo 사용 데이터를 수집하기 위해 범용 오케스트레이터 스크립트를 실행합니다: python ai_raw_data_collection.py 설정에 따라 로컬 public/ 또는 doc