Redis SENTINEL PENDING-SCRIPTS

레디스 센티널 교육 신청 레디스 정기점검/기술지원
Redis Technical Support
레디스 엔터프라이즈 서버
Redis Enterprise Server

Redis SENTINEL PENDING-SCRIPTS

센티널은 경고(warning) 이벤트가 발생하면 notification_script에 지정된 파일을 실행해서 관리자에게 알린다.   발생한 이벤트를 스크립트 잡 큐(Script job queue)에 넣고 실행하는데, 실행 시간이 좀 걸린다면 현재 실행중이거나 대기 중인 스크립트가 남아있다.   이 명령은 현재 실행중이거나 대기 중인 스크립트와 이벤트 정보를 보여준다.

사용법

명령: SENTINEL PENDING-SCRIPTS
일반적으로 스크립트는 매우 빠르게 실행되기 때문에 조회가 되지 않는 경우가 대부분이다.   여기서는 데스트 목적으로 쉘 스크립트 안에 5초 대기(sleep 5)를 넣고 실행한 것이다.
명령 실행 예)

127.0.0.1:7111> sentinel pending-scripts
1) 1) "argv"
   2) 1) "/root/redis-3.2.2/notify/redis-notify.sh"
      2) "+promoted-slave"
      3) "slave 127.0.0.1:7121 127.0.0.1 7121 @ Xmaster 127.0.0.1 7124"
  3) "flags"
  4) "running"
  5) "pid"
  6) "23783"
  7) "run-time"
  8) "4189"
  9) "retry-num"
 10) "1"
2) 1) "argv"
   2) 1) "/root/redis-3.2.2/notify/redis-notify.sh"
      2) "+failover-state-reconf-slaves"
      3) "master Xmaster 127.0.0.1 7124"
  3) "flags"
  4) "running"
  5) "pid"
  6) "23784"
  7) "run-time"
  8) "4189"
  9) "retry-num"
 10) "1"

현재 실행중이거나 대기 중인 스크립트는 info sentinel 명령으로 개수를 확인할 수 있다.   sentinel_running_scripts는 현재 실행중인 스크립트 수이고, sentinel_scripts_queue_length는 큐에 남아있는 스크립트 수이다.

127.0.0.1:7111> info sentinel
# Sentinel
sentinel_masters:1
sentinel_tilt:0
sentinel_running_scripts:2
sentinel_scripts_queue_length:2
sentinel_simulate_failure_flags:0
master0:name=Xmaster,status=ok,address=127.0.0.1:7124,slaves=4,sentinels=5,quorum=3

센티널은 큐에 있는 스크립트를 비동기로 실행한다.   그러므로 스크립트 실행후 끝나기를 기다리지 않고 바로 다음 스크립트를 실행한다.   스크립트 실행은 자식 프로세스(child process)을 fork하고 그 자식 프로세스가 execve()로 스크립트를 실행한다.   execve()는 다른 프로그램을 실행하고 자신은 종료하는 함수이다.   일반적인 상황에서는 큐(sentinel_scripts_queue_length) 개수와 실행중인(sentinel_running_scripts) 개수가 같다.

센티널이 스크립트를 비동기로 실행하기는 하지만 동시에 16개까지만 실행할 수 있다.   스크립트 1개의 최대 실행 시간은 60초이다.   시간초과가 발생하면 "-script-timeout" 이벤트가 발생하고 스크립트를 종료(kill) 시킨다.   만약 자식 프로세스 fork 할때 실패하면 "-script-error" 이벤트를 발생하고 로그에 남긴다.   성공하지 못한 스크립트는 10번까지 재 시도하는데, 공백 시간을 둔 다음 재 시도한다.   공백 시간은 처음 실패하면 30초 후에 재 시도하고,   두 번째 실행하면 60초, 세 번째는 2분, 4분, 8분, 16분, 32분, 64분, 마지막에 열 번째는 128분 후에 시도한다.   열번째까지 실패하면 더 이상 시도하지 않는다.

여기 언급한 숫자(동시 실행 16, 스크립트 최대 실행 시간 60초, 재 시도 횟수 10번, 공백 시간)는 모두 소스에 정의되어 있어 파라미터나 SET 명령으로 변경할 수 없다.

항목

조회되는 항목

  • argv 1 : script file
  • argv 2 : 이벤트 타입
  • argv 3 : 이벤트 내용
  • flags : 스크립트가 실행중일 경우는 "running", 대기 중일 경우는 "scheduled"로 표시된다.   실행중일 경우 "ps -ef|grep redis" 명령으로 해당 프로세스 ID를 볼 수 있다.
  • pid : 23784, 실행중일 경우 자식 프로세스 ID가 표시된다. 대기 중일 경우는 "0"이다.
  • run-time : 4189, 실행중일 경우 "run-time"이 표시되고, 대기 중일 경우 "run-delay"가 표시된다.   run-time은 실행 시작 부터 현재까지 시간이다.   이 시간이 60초가 넘으면 시간초과가 되어 센티널은 자식 프로세스를 종료시킨다.
    시간초과가 된 스크립트는 flags가 "scheduled"로 바뀐다.   재 시도할 경우 공백시간을 더해서 다음 시작 시각(start_time) 세팅한다.   공백시간은 위에서 설명한 것처럼 30초, 60초, 이런 식으로 2배씩 늘어난다.   "run-delay" 시간은 start_time에서 현재 시각을 뺀 시간이다.   "run-delay"가 0이 되면 센티널은 시크립트를 실행시킨다.
  • retry-num : 1, 재 시도 횟수를 나타낸다.

명령문

SENTINEL PENDING-SCRIPTS

  • 이 명령은 version 2.8.0 부터 사용할 수 있다.
  • 이 문서는 버전 3.2.2을 기준으로 만들었다.

Clients for Java Jedis, Lettuce
Clients for C Hiredis

<< INFO-CACHE PENDING-SCRIPTS DOWN-AFTER-MILLISECONDS >>

조회수 :

Email 답글이 올라오면 이메일로 알려드리겠습니다.