Redis를 운영하다 보면 “native tool로 점검해봐”라는 말을 자주 듣게 됩니다.
여기서 말하는 Native Tool은 Redis에 기본적으로 포함되어 있는 공식 CLI 및 유틸리티 도구를 의미합니다. 별도의 프로그램을 설치하지 않아도 Redis를 설치하면 함께 제공되는 강력한 점검 도구들이죠.
이번 글에서는 Redis의 Native Tool 종류와 활용 방법을 정리해봤습니다.
1️⃣ redis-cli — Redis 점검의 핵심 도구
redis-cli는 Redis와 직접 통신할 수 있는 명령줄 인터페이스(Command Line Interface)입니다.
운영 환경에서 key 조회, value 확인, 서버 상태 점검 등에 가장 널리 쓰입니다.
📌 주요 기능
- TCP를 통한 Redis 서버 직접 접속 (기본 6379 포트)
- 모든 Redis 명령어를 실시간으로 실행 가능
- SCAN, MONITOR, INFO 등 운영 점검에 필수적인 명령 지원
🧪 사용 예시
# 로컬 접속
redis-cli
# 원격 서버 접속
redis-cli -h 10.0.0.15 -p 6379
# 비밀번호가 있는 경우
redis-cli -h 10.0.0.15 -a 'MySecretPassword'
# 특정 key 조회
GET mykey
# key 목록 스캔 (user:로 시작하는 key 100개씩)
SCAN 0 MATCH user:* COUNT 100
# 서버 상태 확인
INFO운영 중 가장 자주 쓰는 명령은 INFO와 SCAN입니다.
특히 INFO replication, INFO memory는 장애 상황에서 빠른 진단에 매우 유용합니다.
2️⃣ redis-benchmark — 성능 측정 및 부하 테스트
redis-benchmark는 Redis의 성능을 측정하거나, 간단한 부하 테스트를 할 수 있는 기본 제공 벤치마크 툴입니다. 별도의 JMeter나 Locust 없이도 Redis 자체 성능을 빠르게 진단할 수 있습니다.
📌 주요 기능
- TPS, 지연 시간(Latency) 측정
- 특정 명령(GET, SET 등)만 집중 테스트 가능
- 동시 접속 수, 요청 수 등 세부 옵션 설정 가능
🧪 사용 예시
# 기본 테스트 (10000건, 50동시 접속)
redis-benchmark -n 10000 -c 50
# 특정 명령만 테스트 (GET/SET)
redis-benchmark -t GET,SET -n 50000 -q
# 특정 서버 대상으로 실행
redis-benchmark -h 10.0.0.15 -p 6379 -a 'MySecretPassword'이 툴은 운영 전 성능 확인이나, 클러스터 구성 후 성능 비교할 때 유용하게 쓰입니다.
3️⃣ 기타 Native Tool
Redis에는 CLI와 벤치마크 외에도 파일 점검 및 메모리 테스트를 위한 유틸리티가 기본 포함돼 있습니다.
도구 이름용도기본 포함
| redis-check-rdb | RDB 스냅샷 파일 점검 및 복구 | ✅ |
| redis-check-aof | AOF 로그 파일 점검 및 복구 | ✅ |
| redis-server --test-memory | 메모리 점검 (시스템 호환성 테스트) | ✅ |
4️⃣ Redis Insight — 공식 GUI 관리 도구 (선택)
Redis Labs에서 제공하는 Redis Insight는 브라우저 기반 GUI 툴로, key 관리, 모니터링, 쿼리 분석 등을 편리하게 제공합니다.
엄밀히 말해 “native”라기보단 공식 제공 GUI 툴에 가깝습니다.
📝 정리
도구 이름역할비고
| redis-cli | 기본 명령 실행, 상태 점검 | 운영 점검 필수 |
| redis-benchmark | 성능 테스트, TPS/Latency 측정 | 사전 성능 검증 필수 |
| redis-check-rdb/aof | 파일 무결성 점검 | 장애 대응용 |
| redis-server --test-memory | 메모리 테스트 | 시스템 점검용 |
| Redis Insight | GUI 기반 관리 | 선택 설치 가능 |
🚀 마무리
Redis의 Native Tool들은 단순한 CLI 수준을 넘어서,
운영, 점검, 성능 테스트, 복구까지 폭넓은 기능을 제공합니다.
특히 redis-cli와 redis-benchmark만 제대로 익혀도 대부분의 운영 점검 상황에 빠르게 대응할 수 있습니다.