Documentation: Add a note on async non-blocking events

refs #6589

diff --git a/doc/1-about.md b/doc/1-about.md
index 2acf57b4c085890811cf7dfa7f458135f2c4f0ad..09fbb29da85e1cc69763b108144348bfa533e3cb 100644 (file)
--- a/doc/1-about.md
+++ b/doc/1-about.md
@@ -118,6 +118,9 @@ High Availability for DB IDO: Only active on the current zone master, failover h
 
 Multithreaded and scalable for small embedded systems as well as large scale environments.
 Running checks every second is no longer a problem and enables real-time monitoring capabilities.
+Checks, notifications and event handlers [do not block Icinga 2](#differences-1x-2-async-event-execution)
+in its operation. Same goes for performance data writers and the external command pipe, or any
+file writers on disk (`statusdata`).
 Unlike Icinga 1.x the [daemon reload](#differences-1x-2-real-reload) happens asynchronously.
 A child daemon validates the new configuration, the parent process is still doing checks, replicating cluster events, triggering alert notifications, etc. If the configuration validation is ok, all remaining events are synchronized and the child process continues as normal.
 The DB IDO configuration dump and status/historical event updates also runs asynchronously in a queue not blocking the core anymore. The configuration validation itself runs in paralell allowing fast verification checks.

diff --git a/doc/8-migration.md b/doc/8-migration.md
index c878baa2891477c4a96368aedeba42799fc0153b..d215d1b663222e858e486921cc83d876024db795 100644 (file)
--- a/doc/8-migration.md
+++ b/doc/8-migration.md
@@ -1189,6 +1189,16 @@ The following external commands are not supported:
     STOP_OBSESSING_OVER_SVC
     STOP_OBSESSING_OVER_SVC_CHECKS
 
+### <a id="differences-1x-2-async-event-execution"></a> Asynchronous Event Execution
+
+Unlike Icinga 1.x, Icinga 2 does not block when it waits for a check command
+being executed. Similar when a notification or event handler is triggered - they
+run asynchronously in their own thread.
+
+Writing performance data files or status data and log files doesn't block either.
+Last but not least the external command pipe runs asynchronously and accepts
+multiple connections at once.
+
 ### <a id="differences-1x-2-checks"></a> Checks
 
 #### <a id="differences-1x-2-check-output"></a> Check Output