Add log message for log rotate; update docs

refs #6737

(cherry picked from commit df25b183cb256440a53d1c2fc582b98ceb25d444)

diff --git a/doc/14-features.md b/doc/14-features.md
index 9b1f7615a04a12639cbf127916c4f5a225529ea7..37618cbf7b0e11d92fd437004bf43bd2f4911352 100644 (file)
--- a/doc/14-features.md
+++ b/doc/14-features.md
@@ -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>
 

diff --git a/lib/base/application.cpp b/lib/base/application.cpp
index 4528808d1902be503e3e569ef1a0ba929fe942c5..be981090cedf790904681df1a3b0f4d21323bbb7 100644 (file)
--- a/lib/base/application.cpp
+++ b/lib/base/application.cpp
@@ -727,6 +727,9 @@ void Application::SigIntTermHandler(int signum)
  */
 void Application::SigUsr1Handler(int)
 {
+       Log(LogInformation, "Application")
+               << "Received USR1 signal, reopening application logs.";
+
        RequestReopenLogs();
 }