레디스 클라이언트

다운로드 1
업데이트 2026. 11. 18.

설치 매뉴얼

개요

Redis 클라이언트 앱은 쿼리에서 Redis 서버의 키와 리스트를 조회하고 쓰는 확장 명령어와 Redis 접속 프로파일을 제공합니다. 수집기는 제공하지 않으며, 설치 후 접속 프로파일만 만들면 바로 명령어를 사용할 수 있습니다.

Redis 서버 준비

  • Standalone 또는 Sentinel 구성의 Redis 서버가 필요합니다(Cluster는 지원하지 않습니다). Redis 7.2에서 동작을 확인했습니다.
  • 소나 서버에서 Redis 서버의 포트(기본 6379)로 접속할 수 있어야 합니다. Sentinel이면 Sentinel 포트(기본 26379)와 Sentinel이 알려주는 마스터 주소에도 접속할 수 있어야 합니다.
  • 인증이 필요하면 암호나 ACL 계정이 필요합니다. Sentinel 접속에는 SENTINEL 명령 권한이 필요합니다.
  • TLS를 사용하는 Redis가 사설 CA 인증서를 쓰면 소나 서버의 JVM 신뢰 저장소에 해당 CA 인증서를 등록해야 하고, 접속 주소가 인증서의 SAN과 일치해야 합니다.

접속 프로파일에 사용할 Redis 계정에 사용할 명령어에 해당하는 권한이 있어야 합니다.

확장 명령어필요한 Redis 명령
redis-getGET
redis-lrangeLRANGE
redis-set-batchSET
redis-lpush-batchLPUSH
redis-del-batchDEL
Note
redis-set-batch의 keep-ttl 옵션은 Redis 6.0 이상에서만 동작합니다.

로그프레소 설정

단계 1: 접속 프로파일 추가

시스템 > 접속 프로파일에서 추가를 클릭하고 Redis 구성에 맞는 유형을 선택합니다.

  • 단일 Redis 서버: Redis 클라이언트 (Standalone)
  • Sentinel로 마스터를 관리하는 구성: Redis 클라이언트 (Sentinel)

Redis 클라이언트 (Standalone)

Redis 클라이언트 (Standalone) 접속 프로파일 추가

구분항목설정
필수호스트Redis 서버의 IP 주소 또는 호스트명
필수포트1~65535, 기본값 6379
선택계정Redis ACL 계정명. 비워두면 암호 전용 인증을 사용합니다
선택암호Redis 암호
선택데이터베이스 번호0~15, 기본값 0
선택SSL/TLSTLS 연결 사용 여부. 기본값 false
선택타임아웃밀리초 단위 접속/명령 타임아웃. 0~1800000, 기본값 2000

Redis 클라이언트 (Sentinel)

Redis 클라이언트 (Sentinel) 접속 프로파일 추가

구분항목설정
필수Sentinel 목록Sentinel 노드의 host:port 목록. 콤마로 구분. 예: 192.0.2.1:26379,192.0.2.2:26379
필수마스터 이름Sentinel이 감시하는 마스터 이름
선택Sentinel 암호Sentinel 노드의 암호. Sentinel에 인증이 없으면 비워둡니다
선택Sentinel SSL/TLSSentinel 노드 연결에 TLS 사용 여부. 기본값 false
선택계정마스터의 Redis ACL 계정명. 비워두면 암호 전용 인증을 사용합니다
선택암호마스터의 암호
선택데이터베이스 번호0~15, 기본값 0
선택SSL/TLS마스터 연결에 TLS 사용 여부. 기본값 false
선택타임아웃밀리초 단위 접속/명령 타임아웃. 0~1800000, 기본값 2000
Note
확장 명령어는 접속 프로파일의 사용 권한이 있는 계정만 실행할 수 있습니다. 다른 계정이 사용해야 하면 접속 프로파일의 사용 권한을 부여합니다.

단계 2: 연결 확인

분석 > 로그에서 아래 쿼리를 실행해 접속 프로파일이 동작하는지 확인합니다. my_redis는 단계 1에서 만든 접속 프로파일 이름으로 바꿉니다.

redis-get profile=my_redis key=healthcheck

접속에 성공하면 key와 value가 담긴 행이 출력됩니다. 키가 없으면 value는 비어 있습니다. 실패하면 _error 필드에 원인이 출력됩니다.