redisgate Gent ent_server ent_server_admin

Enterprise Administration

레디스 엔터프라이즈 서버 Active 3노드 운영 가이드(주의사항)

운영 가이드

레디스 서버 상태(CPU, Memory 등) 기록

레디스 서버 상태(CPU, Memory 등)를 주기적으로 기록합니다.

• 파일: log/stat.log
• 기록 형식 2024-04-04 10:17:49 Cpu=96.8%,Mem_rss=567.63M,Keys=5064423,Cmds=117304,Clients=52 2024-04-04 10:17:50 Cpu=87.4%,Mem_rss=568.11M,Keys=5064423,Cmds=113982,Clients=52 2024-04-04 10:17:51 Cpu=99.6%,Mem_rss=568.46M,Keys=5064423,Cmds=117473,Clients=52 2024-04-04 10:17:52 Cpu=99.7%,Mem_rss=569.59M,Keys=5064423,Cmds=117322,Clients=52
• 항목 설명
  • Cpu: CPU 사용률 표시.
    AOF/RDB background save 시 작동하는 자식 프로세스의 CPU 사용률은 포함하지 않습니다.
  • Mem_rss: Memory 사용량 표시.
    레디스 info memory 명령 used_memory_rss_human 항목, 리눅스 top 명령 RES 항목과 같습니다.
  • Keys: 레디스 서버의 키 개수. 레디스 info keyspace 명령에 나오는 DB별 키 개수의 총계입니다.
  • Cmds: 레디스 서버에서 1초 동안 실행한 명령 개수입니다. (입력/수정/삭제/조회 모두 포함)
  • Clients: 레디스 서버에 접속한 클라이언트 수 표시
• redis.conf: stat-log-interval-time 60 (단위:초) : 60초(1분)마다 기록합니다.
  config set stat-log-interval-time 60 : 운영중 변경 가능, 바로 적용됩니다.
  0으로 설정하면 기록하지 않습니다.
• 적용 버전: 7.4.6

클라이언트(복제) 출력 버퍼 크기 기록: client(replica) output buffer size

client(replica) output buffer(memory)를 얼마나 사용하고 있는지 크기(바이트)를 주기적으로 기록합니다.
redis.conf: "client-output-buffer-limit replica 512mb 512mb 60" 와 관계가 있습니다.
위 설정으로 동기화 중인 서버와 연결이 끊길 경우 모니터링 용으로 사용합니다.

• 파일: log/redis.log
• 기록 형식 BufferLimits from_clones client id:5(master) obufmem:0 BufferLimits to_clones client id:4(slave) obufmem:0
• 항목 설명
  • from_clones: 상대 동기화 서버로 부터 데이터를 받는 클라이언트
    to_clones: 상대 동기화 서버로 데이터를 보내는 클라이언트
  • client id:5(master/slave): client id와 client type(master/slave) 표기
  • obufmem: client-output-buffer 사용량(바이트) 표기.
    이 사용량이 "client-output-buffer-limit replica" 에서 설정한 512mb를 초과하면 해당 복제 클라이언트 연결을 끊습니다.
• 만약 연결이 끊기면 client-output-buffer-limit replica 설정 값을 크게 늘리시거나(예: 10gb) 또는 normal과 같이 "0 0 0"으로 설정할 해도 됩니다.
• redis.conf: replica-output-buffer-limit-check-period 60 (단위:초) : 60초(1분)마다 기록합니다.
  config set replica-output-buffer-limit-check-period 60 : 운영중 변경 가능, 바로 적용됩니다.
  0으로 설정하면 기록하지 않습니다.
• 적용 버전: 7.4.6

레디스 서버 상태 정보(모니터링) 조회

레디스 서버 모니터링 용으로 상태 정보를 매초 조회합니다.
CPU, Memory, Keys 등 항목을 조회할 수 있습니다.

• 실행 방법: redis-ecli -p port --mon -> mon.sh
• 조회 형식 ------------------------------------------------------------------------------------------------------------------------------ date time ip:port role keys cpu memory clients commands from to child ------------------------------------------------------------------------------------------------------------------------------ 2024-04-04 16:33:11 18:18504 master 4 64.5% 21.2M 53 28340 1 1 2024-04-04 16:33:12 18:18504 master 4 67.8% 21.2M 53 16066 1 1 2024-04-04 16:33:13 18:18504 master 4 62.0% 21.1M 53 22018 1 1 2024-04-04 16:33:14 18:18504 master 4 59.7% 21.1M 53 22088 1 1
• 항목 설명
  • date: 일자를 yyyy-mm-dd 형식으로 표시합니다.
  • time: 시각을 hh:mm:ss 형식으로 표시합니다.
  • ip:port: ip 끝자리와 port를 표시합니다. 여러 대 서버를 모니터링 할 경우 구분하기 위해서 표시했습니다.
  • role: 레디스 서버의 역할을 표시합니다.
  • keys: 키 개수를 표시합니다.
  • cpu: CPU 사용률을 표시합니다. 자식(child) 프로세스의 CPU 사용률은 포함하지 않습니다.
  • memory: 레디스 서버가 사용하는 메모리(used_memory)를 표시합니다.
    info memory 명령 used_memory_human 항목과 같습니다.
  • clients: 클라이언트 수를 표시합니다.
  • commands: 초당 실행된 명령 수를 표시합니다.
  • from: 데이터를 받는 서버(동기화) 대수를 표시합니다.
  • to: 데이터를 보내는 서버(동기화) 대수를 표시합니다.
  • child: 자식 프로세스를 표시합니다.
    - AOF rewrite: AOF 표시.
    - RDB bgsave: RDB 표시.
    - LOAD(%): 레디스 서버 시작할 때 AOF/RDB 파일 로드 시 표시. 이 경우 진행률(%)도 같이 표시합니다. 전체 데이터 동기화할 때도 LOAD로 표시됩니다. LOAD는 자식 프로세스는 아닙니다.
• 적용 버전: 7.4.5
  이 기능은 이전 버전에도 있었으나 CPU 사용률, 초당 실행된 명령 수는 7.4.5 버전에 추가되었습니다.

CLIENT SETINFO, NO-TOUCH, NO-EVICT

Client 명령에 setinfo, no-touch, no-evict 옵션을 추가했습니다.
이것은 redis 커뮤니티 버전 7.2.0에 추가된 기능입니다.
Lettuce 6.3.0을 지원하기 위해서 추가했습니다.
Enterprise 7.4.4 이전 버전에서는 Lettuce 6.2.7을 사용하면 됩니다.

• 적용 버전: 7.4.4
  

redis.conf myip 추가

레디스 서버가 사용하는 IP를 등록한다.
이 IP는 서버간 동기화용으로 사용하고, 라이선스 확인할 때도 사용한다.
이렇게 함으로써 redis.conf bind에 IP를 0.0.0.0으로 등록할 수 있게 되었다.

• 적용 버전: 7.4.4
  

Client 연결, 해제(종료) 로그

loglevel을 verbose로 설정하면 client 연결, 해제(종료) 로그가 redis.log에 기록됩니다.
많은 로그가 남을 수 있으니 필요한 경우만 사용하시기 바랍니다.
L4 스위치 설정에 따라 초당 수십 건의 연결과 해제가 반복될 수 있습니다.

• 설정 방법: > cofig set loglevel verbose
• 기록 형식 24874:M 2024-04-05 10:44:35.603554 - Connected client: 127.0.0.1:40068 24874:M 2024-04-05 10:45:25.864360 - Disconnected client: 127.0.0.1:40068
• 적용 버전: 7.4.3
  

명령 로그

레디스 서버가 실행하는 명령를 기록합니다.
loglevel verbose: 일반 클라이언트(pubsub 클라이언트 포함) 명령 기록
loglevel debug: 모든 클라이언트(동기화용 클라이언트 포함) 명령 기록
매우 많은 로그가 남을 수 있으니 꼭 필요한 경우만 사용하시기 바랍니다.

• 설정 방법: cofig set loglevel verbose/debug
• 기록 형식 24874:M 2024-04-05 10:49:28.816596 - Accepted 127.0.0.1:40174 24874:M 2024-04-05 10:49:28.816750 - 127.0.0.1:40174: AUTH default password 24874:M 2024-04-05 10:49:28.816918 - 127.0.0.1:40174: HELLO 3 24874:M 2024-04-05 10:49:28.817331 - 127.0.0.1:40174: COMMAND
• 적용 버전: 7.4.3
  

관리 명령 로그

중요한 관리 명령은 로그 파일(redis.log)에 기록합니다. 이것은 loglevel이 notice입니다.
대상 명령: CONFIG SET, SAVE, BGSAVE, BGREWRITEAOF, SHUTDOWN

• 기록 형식 24874:M 2024-04-05 10:49:35.476419 - 127.0.0.1:40174: config set loglevel notice 24874:M 2024-04-05 11:09:58.888326 # BGSAVE - 127.0.0.1:40490
• 적용 버전: 7.4.1
  

config set 명령으로 dir 변경 불가

config set 명령으로 dir 변경할 수 없도록 했습니다.
이것은 해킹 방지용으로 도입되었습니다. 커뮤니티 버전에서는 변경 가능합니다.
해킹 관련 사례는 여기를 참고하세요.

• 적용 버전: 7.4.1
  

동기화 시 데이터 입력 막는 시간

동기화 시 데이터 불일치를 막기 위해서 로딩이 완료(loading_end_time)되고 sync_start_wait_time 후에 일반 입력을 받는다.
redis.conf: sync-start-wait-time 10 (단위:초)
이 지시자(sync-start-wait-time)는 6.1.3 버전에 최초 도입되었다. 처음에는 동기화 시 데이터 불일치를 막기 위해서 이 시간 동안 입력 명령을 받지 않았는데, 이 값을 동기화 로딩 시간에 맞추어야 하는 불편함이 있어서, 7.3.9에서 로딩 후 이 시간 동안 막는 것으로 변경했다.

• 적용 버전: 7.3.9
  

license 명령 memory fault 버그 수정

라이선스를 확인하기 위해서 license 명령 사용 시 발생할 수 있는 memory fault 버그 수정했다.
이전 버전에서는 license 명령을 사용하면 안된다.
7.1.6 ~ 7.3.4: license 명령 -> OK 리턴.
7.3.5 부터 만료일 리턴 -> 7.3.5 ~ 7.3.8까지 license 명령 사용 금지.
7.3.9 부터 사용 가능.

• 적용 버전: 7.3.9
  

휴지통 Recyclebin 기능

rm 명령으로 키를 삭제했을 경우 완전히 삭제되지 않고 휴지통에 들어간다. 되살릴 수 있다.
간단한 사용 예)
> set key1 value1
> get key1 -> "value1"
> rm key1 -> 1
> get key1 -> (nil)
> reuse key1 -> 1
> get key1 -> "value1"

휴지통은 매일 지정된 시각에 자동으로 비워집니다. redis.log에 기록됩니다.
redis.conf: flush-recyclebin-spec-time "05:00"
config set 명령으로 변경 가능합니다.

휴지통 기능 소개와 각 명령에 대한 설명은 아래 링크를 참조하세요.

• 휴지통 Recyclebin 기능 소개
• RM 명령
• REUSE 명령
• RMKEYBIN 명령
• FLUSHRECYCLEBIN 명령
• FLUSHRECYCLEBINALL 명령
• RECYCLEBIN 명령
• 적용 버전: 7.3.3
  

redis.conf loading-count

rdb, aof loading count
redis.conf loading-count
로딩 시간이 매우 오래 걸리는 경우가 발생해서 추가했다.
(디스크 문제였다)