REDIS HEALTH
SAFE OPERATING BOUNDARY
CONFIG SET 전 기록한 maxmemory와 maxmemory-policy를 같은 승인된 연결로 원복하고 INFO memory·stats를 다시 확인합니다. 정책 원복은 이미 evict된 키를 되살리지 않으므로 백업·권위 데이터 원본에서 복구해야 합니다. 영구 설정은 작업 전 백업과 배포 관리 소스를 사용하고 CONFIG REWRITE를 즉흥적으로 실행하지 않습니다.
BEFORE YOU START
CHECK THE BRANCH
주소·포트가 맞다면 Redis 프로세스와 listen socket, bind·protected mode, 컨테이너 포트 매핑을 확인합니다. 외부 노출을 위해 bind를 전체 주소로 넓히지 않습니다.
네트워크 단절 외에 blocking command, 느린 fork·persistence, swap, 큰 client output buffer를 확인합니다. 재시도 횟수만 늘리면 부하가 증폭될 수 있습니다.
자격증명이 틀렸거나 ACL user의 command/key pattern 권한이 부족할 수 있습니다. default user 활성화나 광범위 +@all로 우회하지 말고 최소 ACL을 검토합니다.
used_memory와 maxmemory뿐 아니라 mem_not_counted_for_evict, RSS, fragmentation, client buffer, persistence fork 여유를 함께 봅니다. 캐시와 영구 데이터는 eviction 정책을 다르게 선택해야 합니다.
FOLLOW THE FLOW
APPROVED_REDIS_CLI는 TLS와 --askpass 또는 로컬 socket을 적용한 조직 표준 redis-cli 명령으로 바꿉니다. 비밀번호를 명령행에 직접 넣지 않습니다.
<APPROVED_REDIS_CLI> PING<APPROVED_REDIS_CLI> INFO server
<APPROVED_REDIS_CLI> INFO replication<APPROVED_REDIS_CLI> INFO memory<APPROVED_REDIS_CLI> INFO stats
<APPROVED_REDIS_CLI> INFO clientsPING 실패는 연결/인증 분기입니다. PING 성공 뒤 used_memory가 maxmemory에 가깝거나 evicted_keys·rejected_connections가 증가하면 메모리/부하 분기로 이동합니다.
INFO 출력의 run_id, 주소, replica 정보는 외부 공유 전에 마스킹합니다.
애플리케이션과 같은 호스트·네트워크에서 이름 해석과 TCP/TLS를 확인하고 Redis ACL identity를 읽습니다.
getent ahosts <REDIS_HOST>nc -vz -w 3 <REDIS_HOST> <REDIS_PORT>openssl s_client -connect <REDIS_HOST>:<TLS_PORT> -servername <REDIS_HOST> -verify_return_error </dev/null<APPROVED_REDIS_CLI> ACL WHOAMITCP부터 실패하면 listen/방화벽/경로, TLS만 실패하면 CA·이름·시간, PING에서 NOAUTH/NOPERM이면 ACL 분기입니다.
네트워크 개방과 ACL 확대를 동시에 하지 말고 실패 계층 하나만 수정안으로 준비합니다.
runtime 설정과 메모리 통계를 조회해 dataset, allocator, client, replication/persistence buffer를 구분합니다.
<APPROVED_REDIS_CLI> CONFIG GET maxmemory
<APPROVED_REDIS_CLI> CONFIG GET maxmemory-policy<APPROVED_REDIS_CLI> MEMORY STATS<APPROVED_REDIS_CLI> INFO keyspace<APPROVED_REDIS_CLI> LATENCY DOCTORnoeviction은 한도 도달 시 쓰기 오류, allkeys/volatile 정책은 조건에 맞는 키 제거를 의미합니다. evicted_keys가 늘면 데이터가 이미 제거됐으므로 단순 설정 원복으로 복구되지 않습니다.
캐시인지 권위 데이터인지, TTL 적용률과 허용 가능한 eviction을 데이터 소유자와 확인합니다.
Redis 호스트에서 RSS, swap, OOM, fork/persistence 상태와 큰 client buffer를 확인합니다. CLIENT KILL이나 FLUSH 명령은 실행하지 않습니다.
free -h
ps -C redis-server -o pid,user,%cpu,%mem,rss,vsz,etime,cmdsudo journalctl -u redis-server.service --since '-30 min' --no-pagersudo journalctl -k --since '-30 min' --no-pager | grep -E 'redis|Out of memory|Killed process'<APPROVED_REDIS_CLI> INFO persistence<APPROVED_REDIS_CLI> CLIENT LIST TYPE NORMALRSS가 used_memory보다 큰 이유를 fragmentation·allocator·fork·client buffer로 나눕니다. rdb/aof 작업 실패나 OS OOM이면 eviction 정책만 바꿔서는 해결되지 않습니다.
백업·replica 상태, 여유 메모리, 데이터 성격을 확인한 뒤 용량·TTL·정책·client 제한 중 하나의 변경을 승인받습니다.
CONFIG SET은 즉시 동작을 바꾸며 정책에 따라 키가 제거될 수 있습니다. 기존 값과 백업·replica를 기록하고 데이터 소유자가 승인한 경우에만 한 분기씩 적용합니다.
<APPROVED_REDIS_CLI> CONFIG GET maxmemory
<APPROVED_REDIS_CLI> CONFIG GET maxmemory-policy
<APPROVED_REDIS_CLI> INFO memory
<APPROVED_REDIS_CLI> INFO persistence<APPROVED_REDIS_CLI> CONFIG SET maxmemory <APPROVED_BYTES><APPROVED_REDIS_CLI> CONFIG SET maxmemory-policy <APPROVED_POLICY><APPROVED_REDIS_CLI> CONFIG GET maxmemory
<APPROVED_REDIS_CLI> CONFIG GET maxmemory-policy
<APPROVED_REDIS_CLI> INFO memory
<APPROVED_REDIS_CLI> INFO statsOOM 오류가 멈추고 latency·evicted_keys·keyspace hit/miss와 host available memory가 허용 범위여야 합니다. eviction이 예상보다 빠르면 즉시 추가 변경을 멈춥니다.
runtime 변경은 재시작 후 사라질 수 있으므로 검증 뒤 소스 관리 설정에 동일 값을 백업·리뷰 절차로 반영합니다. 실패하면 기록한 이전 CONFIG SET 값으로 원복하되 제거된 키는 백업·원본 시스템에서 복구하고, 재발 방지를 위해 메모리·eviction·client buffer·persistence 경보를 둡니다.
PRIMARY REFERENCES
배포판과 버전에 따라 옵션·로그 위치가 다를 수 있습니다. 실행 전 서버의 --help와 로컬 매뉴얼을 함께 확인하세요.