메트릭 수명 주기

GitLab 내부 분석 메트릭의 추가, 변경, 제거 및 그룹 이름 변경 등 각 수명 주기 단계별 절차를 설명합니다.

다음 가이드라인은 메트릭 수명 주기의 각 단계에서 따라야 할 절차를 설명합니다. 새 메트릭 추가 # 메트릭 계측 가이드를 따르세요. 기존 메트릭 변경 # 메트릭의 계산 로직이나 중요한 속성의 변경은 방지 하고자 합니다. 이를 변경하면 GitLab의 서로 다른 버전 간 동일 메트릭 비교가 무효화되기 때문입니다. 메트릭을 변경하는 경우, 모든 GitLab 인스턴스가 최신 버전으로 실행되고 있지 않을 수 있다는 점을 고려해야 합니다. 구버전 인스턴스는 계속해서 이전 버전의 메트릭을 보고합니다. 또한, 메트릭의 보고된 수치는 주로 이전에 보고된 수치와 비교할 때 의미가 있습니다. 따라서 메트릭의 다음 항목 중 하나를 변경해야 하는 경우, 기존 메트릭을 변경하는 대신 새 메트릭을 추가해야 합니다. 기존 메트릭을 새 메트릭과 함께 유지할지, 아니면 제거 할지는 선택 사항입니다. 계산 로직 : 이전 구현과 다른 값을 생성할 수 있는 모든 변경 사항 YAML 속성 : 다음 속성들은 분석이나 계산에 직접 사용됩니다: key_path , time_frame , value_type , data_source . 메트릭의 performance_indicator_type 속성을 변경하거나 위에 명시된 규칙의 예외가 필요하다고 판단되는 경우, 머지 리퀘스트 또는 이슈의 댓글에서 해당 그룹을 @ 멘션하여 Customer Success Ops 팀( @csops-team ), Analytics Engineers( @gitlab-data/analytics-engineers ), Product Analysts( @gitlab-data/product-analysts ) 팀에 알리세요. 계산이나 분석에 영향을 주지 않고 다른 속성들은 변경할 수 있습니다. 메트릭 속성 업데이트에 도움이 되는 이 동영상 튜토리얼 을 참조하세요. 현재 Metrics Dictionary 는 하루에 한 번 자동으로 빌드됩니다. 메트릭의 YAML 파일을 변경하면 24시간 이내에 딕셔너리에서 변경 사항을 확인할 수 있습니다. 메트릭 제거 # 아직 이슈가 없다면, 메트릭 제거를 위한 이슈를 생성하세요. 이슈에는 해당 메트릭을 제거해야 하는 이유가 포함되어야 합니다. 이 이슈를 제거 프로세스를 문서화하는 데 사용할 수 있습니다. 메트릭에 [x]mau 또는 customer_health_score 유형의 performance_indicator_type 이 하나 이상 있는 경우 : 이슈의 댓글에서 해당 그룹을 @ 멘션하여 Customer Success Ops 팀( @csops-team ), Analytics Engineers( @gitlab-data/analytics-engineers ), Product Analysts( @gitlab-data/product-analysts )에 알리세요. 이러한 메트릭이 예기치 않게 변경되면 리포팅이 중단될 수 있습니다. 메트릭이 제거를 수행하는 그룹이 아닌 다른 그룹이 소유한 경우 : stages 파일 에 따라 소유 그룹의 PM과 EM을 태그하세요. data_source 에