Skip to content

redis.io Redis Signals Handling

This document provides information about how Redis reacts to the reception of different POSIX signals such as SIGTERM, SIGSEGV and so forth.

The information contained in this document is only applicable to Redis version 2.6 or greater.

Handling of SIGTERM

The SIGTERM signals tells Redis to shutdown gracefully. When this signal is received the server does not actually exits as a result, but it schedules a shutdown very similar to the one performed when the SHUTDOWN command is called. The scheduled shutdown starts ASAP, specifically as long as the current command in execution terminates (if any), with a possible additional delay of 0.1 seconds or less.

NOTE: 处理SIGTERM的过程和处理SHUTDOWN命令的过程类似，服务器采用的措施是： schedules a shutdown very similar to the one performed when the SHUTDOWN command is called

In case the server is blocked by a Lua script that is taking too much time, if the script is killable with SCRIPT KILL the scheduled shutdown will be executed just after the script is killed, or if terminates spontaneously.

NOTE: or if表示的是和前面的if所举的相反的情况

NOTE:

如果当前server阻塞在一个需要很多时间才能够完成的Lua script中，此时服务器采取的措施是：

1、如果这个Lua script是killable ，则服务器会调用SCRIPT KILL ，然后在执行the scheduled shutdown

2、如果Lua script不是killable ，则自动终止（此处的自动终止的含义是server不会调用SCRIPT KILL ，而是等正在执行的Lua scripte执行完成后才执行the scheduled shutdown

The Shutdown performed in this condition includes the following actions:

1、If there is a background child saving the RDB file or performing an AOF rewrite, the child is killed.

2、If the AOF is active, Redis calls the fsync system call on the AOF file descriptor in order to flush the buffers on disk.

3、If Redis is configured to persist on disk using RDB files, a synchronous (blocking) save is performed. Since the save is performed in a synchronous way no additional memory is used.

4、If the server is daemonized, the pid file is removed.

5、If the Unix domain socket is enabled, it gets removed.

6、The server exits with an exit code of zero.

In case the RDB file can't be saved, the shutdown fails, and the server continues to run in order to ensure no data loss. Since Redis 2.6.11 no further attempt to shut down will be made unless a new SIGTERM will be received or the SHUTDOWN command issued.

Handling of SIGSEGV, SIGBUS, SIGFPE and SIGILL

NOTE:

它的处理策略是值得借鉴的

The following follow signals are handled as a Redis crash:

1、SIGSEGV

2、SIGBUS

3、SIGFPE

4、SIGILL

Once one of these signals is trapped（被捕捉）, Redis aborts any current operation and performs the following actions:

1、A bug report is produced on the log file. This includes a stack trace, dump of registers, and information about the state of clients.

NOTE:

非常值得借鉴

2、Since Redis 2.8 a fast memory test is performed as a first check of the reliability of the crashing system.

3、If the server was daemonized, the pid file is removed.

4、Finally the server unregisters its own signal handler for the received signal, and sends the same signal again to itself, in order to make sure that the default action is performed, for instance dumping the core on the file system.

What happens when a child process gets killed

When the child performing the Append Only File rewrite gets killed by a signal, Redis handles this as an error and discards the (probably partial or corrupted) AOF file. The rewrite will be re-triggered again later.

When the child performing an RDB save is killed Redis will handle the condition as a more severe error, because while the effect of a lack of AOF file rewrite is a the AOF file enlargement, the effect of failed RDB file creation is lack of durability.

NOTE: 当执行RDB保存的子节点被杀死时，Redis将处理该条件作为更严重的错误，因为虽然缺少AOF文件重写的效果是AOF文件放大，但是失败的RDB文件创建的效果缺乏持久性。

As a result of the child producing the RDB file being killed by a signal, or when the child exits with an error (non zero exit code), Redis enters a special error condition where no further write command is accepted.

  • Redis will continue to reply to read commands.
  • Redis will reply to all write commands with a MISCONFIG error.

This error condition is cleared only once it will be possible to create an RDB file with success.

Killing the RDB file without triggering an error condition

However sometimes the user may want to kill the RDB saving child without generating an error. Since Redis version 2.6.10 this can be done using the special signal SIGUSR1 that is handled in a special way: it kills the child process as any other signal, but the parent process will not detect this as a critical error and will continue to serve write requests as usually.