설치 매뉴얼
개요
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-get | GET |
| redis-lrange | LRANGE |
| redis-set-batch | SET |
| redis-lpush-batch | LPUSH |
| redis-del-batch | DEL |
Note
redis-set-batch의 keep-ttl 옵션은 Redis 6.0 이상에서만 동작합니다.
로그프레소 설정
단계 1: 접속 프로파일 추가
시스템 > 접속 프로파일에서 추가를 클릭하고 Redis 구성에 맞는 유형을 선택합니다.
- 단일 Redis 서버: Redis 클라이언트 (Standalone)
- Sentinel로 마스터를 관리하는 구성: Redis 클라이언트 (Sentinel)
Redis 클라이언트 (Standalone)
| 구분 | 항목 | 설정 |
|---|---|---|
| 필수 | 호스트 | Redis 서버의 IP 주소 또는 호스트명 |
| 필수 | 포트 | 1~65535, 기본값 6379 |
| 선택 | 계정 | Redis ACL 계정명. 비워두면 암호 전용 인증을 사용합니다 |
| 선택 | 암호 | Redis 암호 |
| 선택 | 데이터베이스 번호 | 0~15, 기본값 0 |
| 선택 | SSL/TLS | TLS 연결 사용 여부. 기본값 false |
| 선택 | 타임아웃 | 밀리초 단위 접속/명령 타임아웃. 0~1800000, 기본값 2000 |
Redis 클라이언트 (Sentinel)
| 구분 | 항목 | 설정 |
|---|---|---|
| 필수 | Sentinel 목록 | Sentinel 노드의 host:port 목록. 콤마로 구분. 예: 192.0.2.1:26379,192.0.2.2:26379 |
| 필수 | 마스터 이름 | Sentinel이 감시하는 마스터 이름 |
| 선택 | Sentinel 암호 | Sentinel 노드의 암호. Sentinel에 인증이 없으면 비워둡니다 |
| 선택 | Sentinel SSL/TLS | Sentinel 노드 연결에 TLS 사용 여부. 기본값 false |
| 선택 | 계정 | 마스터의 Redis ACL 계정명. 비워두면 암호 전용 인증을 사용합니다 |
| 선택 | 암호 | 마스터의 암호 |
| 선택 | 데이터베이스 번호 | 0~15, 기본값 0 |
| 선택 | SSL/TLS | 마스터 연결에 TLS 사용 여부. 기본값 false |
| 선택 | 타임아웃 | 밀리초 단위 접속/명령 타임아웃. 0~1800000, 기본값 2000 |
Note
확장 명령어는 접속 프로파일의 사용 권한이 있는 계정만 실행할 수 있습니다. 다른 계정이 사용해야 하면 접속 프로파일의 사용 권한을 부여합니다.
단계 2: 연결 확인
분석 > 로그에서 아래 쿼리를 실행해 접속 프로파일이 동작하는지 확인합니다. my_redis는 단계 1에서 만든 접속 프로파일 이름으로 바꿉니다.
접속에 성공하면 key와 value가 담긴 행이 출력됩니다. 키가 없으면 value는 비어 있습니다. 실패하면 _error 필드에 원인이 출력됩니다.

