Add log message for log rotate; update docs 7140/head
authorMichael Friedrich <michael.friedrich@icinga.com>
Wed, 24 Apr 2019 09:33:43 +0000 (11:33 +0200)
committerMichael Friedrich <michael.friedrich@icinga.com>
Wed, 24 Apr 2019 09:53:27 +0000 (11:53 +0200)
refs #6737

doc/14-features.md
lib/base/application.cpp

index 6411be836cf2bab0541ef44f50a8294aa977130d..3bdbd6743ab4ea6b07cce911aaad3dcf86732dc3 100644 (file)
@@ -21,9 +21,22 @@ By default file the `mainlog` feature is enabled. When running Icinga 2
 on a terminal log messages with severity `information` or higher are
 written to the console.
 
-Packages will install a configuration file for logrotate on supported
-platforms. This configuration ensures that the `icinga2.log`, `error.log` and
-`debug.log` files are rotated on a daily basis.
+### Log Rotation <a id="logging-logrotate"></a>
+
+Packages provide a configuration file for [logrotate](https://linux.die.net/man/8/logrotate)
+on Linux/Unix. Typically this is installed into `/etc/logrotate.d/icinga2`
+and modifications won't be overridden on upgrade.
+
+Instead of sending the reload HUP signal, logrotate
+sends the USR1 signal to notify the Icinga daemon
+that it has rotate the log file. Icinga reopens the log
+files then:
+
+* `/var/log/icinga2/icinga2.log` (requires `mainlog` enabled)
+* `/var/log/icinga2/debug.log` (requires `debuglog` enabled)
+* `/var/log/icinga2/erorr.log`
+
+By default, log files will be rotated daily.
 
 ## DB IDO <a id="db-ido"></a>
 
index 57ca8688fb332cae2f96abb7dc890ae088af1be7..a939db4464314b7215cbf5d44005b20b9a6e96e0 100644 (file)
@@ -706,6 +706,9 @@ void Application::SigIntTermHandler(int signum)
  */
 void Application::SigUsr1Handler(int)
 {
+       Log(LogInformation, "Application")
+               << "Received USR1 signal, reopening application logs.";
+
        RequestReopenLogs();
 }