---
title: hyperfine — 명령어 벤치마크 도구
date: 2026-10-18
time: 12:00
model: admin
category: programs
author_type: human
summary: 명령어 실행 속도를 통계적으로 벤치마크합니다. 워밍업·반복·스테이티컬 테스트까지 내장합니다.
tags: 프로그램, 장애 진단 및 복구, hyperfine
---

**💬 "hyperfine 명령어"**

hyperfine는 **명령어 벤치마크 도구** 명령어 실행 속도를 통계적으로 벤치마크합니다. 워밍업·반복·스테이티컬 테스트까지 내장합니다.

자동 워밍업 실행을 지원합니다. 다중 반복 후 통계(평균·표준편차·최소/최대)를 출력합니다.

- **개념**: 자동 워밍업 실행을 지원합니다.
- **주요 기능**: 다중 반복 후 통계(평균·표준편차·최소/최대)를 출력합니다.
- **장점**: 셸 렌더링과 파이프라인을 모두 지원합니다.
- **활용**: 실행 결과 JSON 내보내기가 가능합니다.
## 설치 및 다운로드

hyperfine는 패키지 매니저 또는 공식 스크립트로 설치합니다.

| 환경 | 명령 |
| --- | --- |
| Ubuntu / Debian | sudo apt install hyperfine |
| macOS (brew) | brew install hyperfine |
| Rust cargo | cargo install hyperfine |
| 공식 바이너리 | github.com/sharkdp/hyperfine/releases |
| 확인 | hyperfine --version |

설치 확인은 `hyperfine --version`으로 합니다.

## 자주 쓰는 옵션

| 옵션 | 설명 |
| --- | --- |
| hyperfine '<cmd>' | 기본 벤치마크 |
| -w, --warmup <n> | 워밍업 실행 횟수 |
| -r, --runs <n> | 측정 실행 횟수 |
| -p, --prepare <cmd> | 각 측정 전 준비 명령 |
| --export-json <file> | JSON으로 결과를 내보냅니다 |

## 필수 명령어 조합 3가지

- `hyperfine 'grep pattern file' 'ripgrep pattern file'` — 두 도구 비교
- `hyperfine -w 3 -r 10 '<cmd>'` — 워밍업 3회 + 측정 10회
- `hyperfine --export-json result.json '<cmd>'` — CI에서 결과 저장
**💬 "실제 서버에서 hyperfine를 사용하는 예시를 보여줘"**

실제 운영 중인 서버에서 자주 만나는 상황을 순서대로 정리했습니다.

### 1단계 · 설치 확인

설치 여부를 확인합니다.

```
hyperfine --version || sudo apt install -y hyperfine
```

### 2단계 · 단독 측정

명령어 속도를 측정합니다.

```
hyperfine --warmup 3 'grep -c ERROR /var/log/nginx/access.log'
```

### 3단계 · 비교 측정

두 도구를 비교합니다.

```
hyperfine 'grep ...' 'rg ...'
```

## 실제 실행 화면

hyperfine으로 grep 속도를 측정한 결과입니다.

![hyperfine 명령어 실행 결과](https://games.cursorai.co.kr/assets/hyperfine-demo.png)

실제 운영 중인 서버

## 실무에서는 이렇게 씁니다

### 1. 도구 속도 비교

**상황** — grep과 ripgrep을 비교합니다.

```
hyperfine 'grep -c ERROR /var/log/nginx/access.log' 'rg -c ERROR /var/log/nginx/access.log'
```

**결과** — ripgrep이 6.42배 빠릅니다.

**포인트** — 표준편차까지 포함된 신뢰할 수 있는 비교입니다.

### 2. CI 성능 회귀 감지

**상황** — CI에서 빌드 시간을 추적합니다.

```
hyperfine --export-json result.json 'make build'
```

**결과** — JSON으로 결과가 저장됩니다.

**포인트** — 이전 커밋과 비교해 회귀를 감지합니다.

## 실제 실행 화면

hyperfine으로 grep과 ripgrep을 비교한 결과입니다.

![hyperfine 명령어 실행 결과 2](https://games.cursorai.co.kr/assets/hyperfine-demo2.png)

실제 운영 중인 서버

## 주의할 점

- 측정 시 다른 프로세스의 간섭이 있을 수 있습니다. 서버는 전용 환경에서 측정합니다.
- 워밍업 없이 측정하면 첫 실행의 캐시 효과가 결과에 반영됩니다. 최소 warmup 1~3회를 권장합니다.
- 셸 렌더링은 셸 오버헤드가 포함됩니다. 극단적으로 짧은 명령은 -N 옵션으로 셸 없이 실행합니다.

---
원문(HTML): https://games.cursorai.co.kr/programs/linux/troubleshooting/hyperfine.html