메트릭 보고서

성능, 메모리 및 커스텀 메트릭을 추적하고 비교합니다.

메트릭 보고서는 브랜치 간의 성능, 메모리 사용량 및 기타 측정값을 추적하기 위해 머지 리퀘스트에 커스텀 메트릭을 표시합니다. 메트릭 보고서를 사용하여 다음을 수행할 수 있습니다: 메모리 사용량 변화 모니터링. 부하 테스트 결과 추적. 코드 복잡도 측정. 코드 커버리지 통계 비교. 메트릭 처리 워크플로 # 파이프라인이 실행되면 GitLab은 보고서 아티팩트에서 메트릭을 읽고 비교를 위해 문자열 값으로 저장합니다. 기본 파일 이름은 metrics.txt 입니다. 머지 리퀘스트의 경우 GitLab은 피처 브랜치의 메트릭을 대상 브랜치의 값과 비교하여 다음 순서로 머지 리퀘스트 위젯에 표시합니다: 값이 변경된 기존 메트릭. 머지 리퀘스트에 의해 추가된 메트릭( New 배지로 표시). 머지 리퀘스트에 의해 제거된 메트릭( Removed 배지로 표시). 값이 변경되지 않은 기존 메트릭. 메트릭 보고서 구성 # CI/CD 파이프라인에 메트릭 보고서를 추가하여 머지 리퀘스트에서 커스텀 메트릭을 추적합니다. 전제 조건: 메트릭 파일은 OpenMetrics 텍스트 형식을 사용해야 합니다. 메트릭 보고서를 구성하려면: .gitlab-ci.yml 파일에 메트릭 보고서를 생성하는 job을 추가합니다. job에 OpenMetrics 형식으로 메트릭을 생성하는 스크립트를 추가합니다. artifacts:reports:metrics 로 메트릭 파일을 업로드하도록 job을 구성합니다. 예시: metrics: stage: test script: - echo 'memory_usage_bytes 2621440' > metrics.txt - echo 'response_time_seconds 0.234' >> metrics.txt - echo 'test_coverage_percent 87.5' >> metrics.txt - echo '# EOF' >> metrics.txt artifacts: reports: metrics: metrics.txt 파이프라인이 실행된 후 메트릭 보고서가 머지 리퀘스트 위젯에 표시됩니다. 추가 형식 사양 및 예시는 Prometheus 텍스트 형식 세부 사항 을 참조하세요. 문제 해결 # 메트릭 보고서로 작업할 때 다음 문제가 발생할 수 있습니다. 메트릭 보고서가 변경되지 않음 # 머지 리퀘스트에서 메트릭 보고서를 볼 때 Metrics report scanning detected no new changes 가 표시될 수 있습니다. 이 문제는 다음과 같은 경우에 발생합니다: 대상 브랜치에 비교를 위한 기본 메트릭 보고서가 없는 경우. GitLab 구독에 메트릭 보고서가 포함되어 있지 않은 경우(Premium 또는 Ultimate 필요). 이 문제를 해결하려면: GitLab 구독 등급에 메트릭 보고서가 포함되어 있는지 확인합니다. 대상 브랜치에 메트릭 보고서가 구성된 파이프라인이 있는지 확인합니다. 메트릭 파일이 유효한 OpenMetrics 형식을 사용하는지 확인합니다.