[Rust 공식문서 한국어 정리] 80. Rust Criterion 가이드

[Rust 공식문서 한국어 정리] 80. Rust Criterion 가이드



원문 제목: Criterion.rs User Guide

작성자: Brook Heisler



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📌 1. 서론 — 이 문서가 다루는 내용

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



이 문서는 Rust의 사실상 표준 벤치마크 라이브러리인 Criterion.rs의 사용법을 설명합니다.

안정적인 Rust 채널에서 동작하며, 통계적 분석, HTML 리포트, 그리고 회귀 감지 기능을 제공합니다.

벤치마크 함수 작성, 커스텀 측정, 비교 벤치마크, 그리고 CI 통합 방법을 중심으로 설명합니다.

정확하고 신뢰할 수 있는 성능 측정을 위해 노이즈 제거, 워밍업, 반복 실행의 중요성을 강조합니다.

성능이 중요한 Rust 코드의 품질을 지속적으로 모니터링하려는 개발자에게 필수적인 가이드입니다.



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔑 2. 핵심 개념 4가지

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



① Criterion: Rust의 통계 기반 벤치마크 프레임워크로, 안정 채널에서 동작합니다.

② Throughput: 초당 처리량을 측정하여, I/O나 데이터 처리 성능을 평가합니다.
③ Comparison: 두 구현체의 성능을 통계적으로 비교하여, 유의미한 차이인지 판단합니다.

④ HTML Report: 벤치마크 결과를 시각화하여, 변화 추이와 분포를 확인할 수 있습니다.



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📖 3. 주요 내용 상세

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



Criterion은 Cargo의 기본 벤치마크 시스템을 대체합니다.

Cargo.toml의 [dev-dependencies]에 criterion을 추가하고, benches/ 디렉토리에 벤치마크 파일을 작성합니다.

fn benchmark(c: &mut Criterion) { c.bench_function("my_func", |b| b.iter(|| my_func())); } 형태입니다.



측정은 통계적으로 신뢰할 수 있도록 설계되었습니다.

여러 번의 반복 실행으로 이상치를 제거하고, 중간값과 표준 편차를 계산합니다.

환경 노이즈를 줄이기 위해 워밍업 실행을 포함하며, 결과의 변동성을 보고합니다.



Throughput 측정은 데이터 처리량을 평가합니다.

c.throughput(Throughput::Bytes(data.len()))로 측정 대상의 크기를 지정하면,

초당 처리량(B/s)으로 성능을 비교할 수 있습니다.



비교 벤치마크는 두 구현체를 동일한 조건에서 비교합니다.

BenchmarkId::new("algo", size)로 여러 입력 크기에 대한 벤치마크를 그룹화하고,

변화율과 신뢰 구간으로 성능 변화의 유의미함을 판단합니다.



HTML 리포트는 target/criterion/report/에 생성됩니다.

벤치마크별 실행 시간 분포, 변화 추이, 비교 결과를 시각화하여 제공합니다.

CI에서 아티팩트로 저장하여, PR 단계에서 성능 변화를 리뷰할 수 있습니다.



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🛠 4. 실전 활용

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



알고리즘 개선 전후 Criterion으로 벤치마크를 실행하여, 통계적으로 유의미한 성능 향상인지 검증합니다.

CI에 벤치마크 잡을 추가하고, 기준값 대비 10% 이상 저하 시 알림을 설정합니다.

HTML 리포트를 팀 위키에 게시하여, 성능 변화를 투명하게 공유합니다.



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ 5. 정리

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



Criterion은 Rust 벤치마크의 사실상 표준으로, 통계적 신뢰성과 풍부한 리포트를 제공합니다.

안정 채널에서 동작하므로, nightly 없이도 프로덕션 코드의 성능을 지속적으로 추적할 수 있습니다.

정확한 성능 측정과 회귀 방지를 위해 Criterion을 표준 도구로 채택하세요.



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔗 출처 링크

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



원문: https://bheisler.github.io/criterion.rs/book/

Criterion.rs: https://github.com/bheisler/criterion.rs



#Rust #Criterion #Benchmarking #Performance #Optimization #CI #번역