메트릭 보고서

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

메트릭 보고서는 브랜치 간의 성능, 메모리 사용량 및 기타 측정값을 추적하기 위해 머지 리퀘스트에 커스텀 메트릭을 표시합니다. 메트릭 보고서를 사용하여 다음을 수행할 수 있습니다: 메모리 사용량 변화 모니터링. 부하 테스트 결과 추적. 코드 복잡도 측정. 코드 커버리지 통계 비교. 메트릭 처리 워크플로 # 파이프라인이 실행되면 GitLab은 보고서 아티팩트에서 메트릭을 읽고 비교를 위해 문자열 값으로 저장합니다. 기본 파일 이름은 metrics.txt 입니다. 머지 리퀘스트의 경우 GitLab은 소스 브랜치의 메트릭을 대상 브랜치의 기준 파이프라인 값과 비교합니다. 머지 리퀘스트 위젯은 메트릭을 다음 순서로 표시합니다: 값이 변경된 기존 메트릭. 머지 리퀘스트에 의해 추가된 메트릭( New 배지로 표시). 머지 리퀘스트에 의해 제거된 메트릭( Removed 배지로 표시). 값이 변경되지 않은 기존 메트릭. 기준 파이프라인에 메트릭 보고서 아티팩트가 없으면 소스 브랜치의 모든 메트릭이 신규로 표시됩니다. 메트릭 비교 위젯은 소스 브랜치 파이프라인이 완료 상태이고 메트릭 보고서 아티팩트가 있을 때만 나타납니다. 메트릭 보고서 구성 # CI/CD 파이프라인에 메트릭 보고서를 추가하여 머지 리퀘스트에서 커스텀 메트릭을 추적합니다. 사전 요구 사항: 메트릭 파일은 한 줄에 메트릭 하나씩 <name> <value> 형식을 사용하는 텍스트 파일이어야 합니다. OpenMetrics 텍스트 형식이 이 요건을 충족합니다. 메트릭 보고서를 구성하려면: .gitlab-ci.yml 파일에 메트릭 보고서를 생성하는 job을 추가합니다. 한 줄에 <name> <value> 하나씩 메트릭을 생성하는 스크립트를 job에 추가합니다. 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 구독에 메트릭 보고서가 포