Docs: Enrich the service monitoring chapter introduction

- Plugin integration with commands
- Plugin API spec and code examples
- Overview

Docs: Add details about thresholds and ranges to the plugin API spec

Docs: Add performance data metrics spec for plugin API

This imports the plugin API html spec, but in a more gentle
readable fashion with better examples.

This allows us to extend this specification later on.

Docs: Add verbose tip for plugin creation

Docs: Improve plugin integration

Docs: Write our own plugin API specification

Rationale: The linked HTML document lacks the right
formatting and is very hard to read and understand.

Also, it doesn't explain plugin timeouts being best
practice, nor shows good programmatic examples.

Today, I prefer Python over Perl, and will share my
knowledge in the docs too.

Merge pull request #7219 from Icinga/feature/api-cipherlist

API: Harden default cipher list

Add cipher list change to upgrading docs

API: Harden default cipher list

According to https://www.acunetix.com/blog/articles/tls-ssl-cipher-hardening/

Merge pull request #7224 from Icinga/bugfix/docs-lang-ref

Docs: Mark include_zones as internal consumed functionality

Docs: Mark include_zones as internal consumed functionality

Asked during the Icinga Advanced training.

Merge pull request #7213 from widhalmt/doc/global-zones

Docs: Add note about not to use director-global for own configuration

Docs: Add note about not to use director-global for your own configuration

Merge pull request #7211 from Icinga/feature/asio-tls-version

Require TLS 1.2 for Cluster & REST API

Merge pull request #7216 from peteeckel/fix/provide-snmpv3-context-option-7215

Provide the snmpv3_context option

Merge pull request #7204 from episodeiv/master

Allow setting the SNMP version for check_iftraffic.pl

Docs: Add iftraffic version note, fix broken URL

Provide the snmpv3_context option and the corresponding item in the documentation

Merge pull request #7214 from breml/patch-1

Docs: Fix typo

Docs: fix typo

Require TLS 1.2 for Cluster & REST API

refs #7041

Merge pull request #7210 from Icinga/bugfix/boost-asio-deprecated

Quality: Replace deprecated get_io_service() with get_executor().context() for Boost ASIO

Merge pull request #7196 from Icinga/feature/network-cleanup

Cleanup old code (HTTP, Cluster)

Quality: Replace deprecated get_io_service() with get_executor().context() for Boost ASIO

refs #7041

Quality: Mark NetworkStream, TcpSocket & UnixSocket classes as deprecated

They're used inside the Livestatus feature which needs rework.

Add documentation for iftraffic_version

Merge pull request #7205 from Icinga/feature/remove-cli-troubleshoot

CLI: Remove broken troubleshoot command

Quality: Removed unused HttpChunkedEncoding class

Quality: Remove old MakeSSLContext() interface

CLI: Remove broken troubleshoot command

It wasn't finished nor have we used it for support questions.

Issue templates, troubleshooting docs and external scripts
serve a better purpose here, especially with distributed systems.

Allow setting the SNMP version for check_iftraffic.pl

This is not supported in check_iftraffic.pl master yet
but there's a pull request at https://github.com/NETWAYS/check_iftraffic/pull/4

Quality: Use Boost ASIO/IO engine in Graphite feature

This commit changes the reconnect priority to high.

Also add function docs.

Quality: Rewrite OpenTSDB to use Boost ASIO and I/O engine

The connection handling and code isn't really good, but not
really actively maintained either.

Besides that, the "telnet" method doesn't allow for TLS,
this needs a general rewrite against their HTTP API.

I've also added function documentation where applicable.

Merge pull request #7200 from Icinga/bugfix/docs-trailing-whitespace-typo

Docs: Replace 'training whitespaces' with 'trailing whitespaces'

Merge pull request #7201 from Icinga/bugfix/update-more-copyright-headers

Unify copyright headers

Unify copyright headers

Update (left over) copyright headers to generic copyright headers.

Docs: Replace 'training whitespaces' with 'trailing whitespaces'

Quality: Drop unused boost/tuple header include

Quality: Remove old SocketEvent functionality

Quality: Purge old TlsStream functionality

Quality: Clean JsonRPC class and add function docs

Quality: Purge old HTTP code in lib/remote

Merge pull request #6813 from Icinga/feature/gelfwriter-tls-support

 Implement TLS support for the GelfWriter feature

Merge pull request #7156 from Icinga/feature/itl-sleep

Implement sleep CheckCommand

Merge pull request #7199 from Icinga/feature/docs-dev-style-guide

Docs: Add styleguide with development details

Docs: Add styleguide with development details

@htriem

Merge pull request #7142 from Icinga/feature/boost-asio-nscp

 check_nscp_api: Rewrite using Boost ASIO and Beast

Merge branch 'support/2.10'

Release version 2.10.5

Release version 2.10.5

check_nscp_api: Rewrite using Boost ASIO and Beast

This includes a huge workaround for NSCP not sending
the status reason correctly. Therefore parsing the raw
data buffer is required, otherwise we could just use
Beast's builtin HTTP parser as everywhere else.

refs #7142
refs #7041

Merge pull request #7143 from Icinga/feature/boost-asio-debug-console

Use I/O engine in debug console CLI command

Debug Console: Use our new I/O engine for HTTP requests

refs #7041

Docs: Remove EOL distributions (SLES11, Ubuntu 14)

(cherry picked from commit 478f087a3aee1c70b96d69b4e0b4ebb9b985e032)

Adjust docs for 2.10.x from cherry-picked commits

Update technical concepts docs on object authority and HA aware features

This includes are more detailed insight into how object authority calculation
works.

(cherry picked from commit 3fdc9669c671685eb267d28cf251e714de18af14)

Quickfix technical docs for debugging

(cherry picked from commit 0bd1d9a6f86df5072fe58bd6c5530c6ff1693310)

Merge pull request #7190 from Icinga/bugfix/check-service-ambiguous-parameter

Disable program option guessing in check_service

Merge pull request #7189 from peteeckel/fix/check_service-7188

Use --description instead of -d for check_service.exe

Disable program option guessing in check_service

This disables the program option guessing in check_service to avoid
ambiguous parameter parsing.

refs #7188

Use --description instead of -d for check_service.exe

Merge pull request #7185 from Icinga/bugfix/gelfwriter-wrong-log-facility

Fix wrong facility in GelfWriter log message

Fix wrong facility in GelfWriter log message

This fixes a wrong facility in GelfWriter log message (paused message).

Use new I/O engine in GelfWriter

Add documentaion for GelfWriter TLS support

This adds the documentation for the GelfWriter TLS support.

Implement TLS support for the GelfWriter

This implements TLS support for the GelfWriter.

Docs: Add Master-Master-Replication as option for mysql

(cherry picked from commit c4f1ad7abb454b94194424733241eaab07c33da8)

Docs: Add initial sync for secondary HA masters, hints on IDO DB clusters

refs #6492

(cherry picked from commit c2542710b7517bdbc3b14b7f5476e94a2785e581)

Docs: Improve features chapter and add details on HA setups

refs #4855

(cherry picked from commit 07790e456b6993a272a7e7a91b33b05823492959)

Docs: Add note for reachability calculation with checks disabled

refs #6844

(cherry picked from commit 15326caf38e9c81d20e4fe6f1b6c9cb3327ac179)

Update AUTHORS

ApiListener#ReplayLog(): read current log file too instead of rotating

(cherry picked from commit 407e77883cc274fee19d44035d9812cb4258fb66)

ApiListener#RotateLogFile(): don't overwrite previous log

(cherry picked from commit 997d84bfa0b8c53144590547bcffdb6d30695e9b)

Rotate replay log on shutdown, not on startup

(cherry picked from commit f44e847717d272833dfc185ef2117390ef5a9f89)

ApiListener#ApiTimerHandler(): delete all replayed logs

refs #6932

(cherry picked from commit 9b489cf9b9347fbce5f5f268d83bba556467e2e9)

another small adjustment by the way just to ensure the object on stack ist the same as the one serialized further in case the object does not implement locking on mutation (besides it's mor efficient to not fetch the same value twice)

(cherry picked from commit cdd843a998bfaa5028369a3fd6d5368bdc6ee568)

add some object locking to the Dump method (which could theoreticylly suffer from same reace condition as serializer)

(cherry picked from commit 44ac6cf1ecd10f2bd5e9b837e78da5dc5257a180)

Lock Objects during serialization

old behaviour was to only lock arrays, dictionaries and namespaces but not other objects

(cherry picked from commit 91296c2a250b1aeb0976f252eba5ffdce93c8590)

Namespace: place ObjectLock in all methods

(cherry picked from commit 5afda779435c848cf5a8411f713adc9891aa5092)

try without initialization of frame Locals which are not used for permissions filter and as far as I can see also not for query filters

(cherry picked from commit c10ff9dd726da0485f99f8c8601a0feb95cfd28f)

use current frame scope for permission filter function calls

(cherry picked from commit 53febdea819adf58b20a0141e1a1131658f1338c)

FilterUtility::EvaluateFilter(): ensure not to modify the global namespace

(cherry picked from commit bdadb53940f1187d60a4679675af164dbb63f37c)

* use dedicated permissions namespace for scriptframe in filterutility to allow proper parallel execution
  * fixes issue https://github.com/Icinga/icinga2/issues/6785 where permission checks get wrong result because permissions checks are done within a shared namespaces without using only unique keys
  * mitigates issue https://github.com/Icinga/icinga2/issues/6874 where segmentation faults occur because of concurrent access to non threadsafe parts of namespace (a fix for thread safety of namespaces which would be an alternative approach to get rid of these segfaults is out of scope of this fix as 6785 needs to be fixed anyway and this is the straight-forwards) way to fix that
* do the same for eventqueue (not certain whether events can be processed in parallel but I expect it is the case)

(cherry picked from commit 1e7cd4afc821a0592b535e4270ebb2fdc387a207)

Add log message for log rotate; update docs

refs #6737

(cherry picked from commit df25b183cb256440a53d1c2fc582b98ceb25d444)

Timer::TimerThreadProc(): use C++11 lambda instead of bind()

refs #6737

(cherry picked from commit 7a8f8fd7349269cb2e0e670b8d2a44693e5c07c7)

StreamLogger#BindStream(): set #m_FlushLogTimer only if needed

refs #6737

(cherry picked from commit 622f68412440d4fa3ac1b347a929087073bc24f9)

Fix for double-free (and possibly other memory-corruption related) crashes at logrotate time

this is a direct fix of the issue revealing the problem that leads to crash

verification done with a patched icinga2 where the execution-order of the code lines of counter-parts involved in re-incrementing/decrementing Timer:Ptr is forced to be the one that leads to the obeserverd segfaults

refs #6737

(cherry picked from commit 52e3db279ab9ff348456234b8a033e703c6f7580)

Documentation: add missing argument to chkconfig command.

(cherry picked from commit dd0c7a28ddc2fd0f78f3fbdb1d4651d29e604e1c)

Docs: Use jo to format JSON body for API actions, esp. unix timestamps

(cherry picked from commit 21225c6b48a084c3d96ee1e7c938d30e19a2e395)

CLI: Fix updates for NodeName/ZoneName constants

fixes #7117

(cherry picked from commit 4197bc9bcd957a1edcf5cec80a9d03fcc4b6c313)

DB IDO: Do not deactivate objects during application reload/restart

This follows the same principle as with the shutdown handler,
and was introduced with the changed reload handling with 2.9.
Previously IsShuttingDown() was sufficient which got set at one
location.

SigUsr2 as handler introduced a new location where m_ShuttingDown
is not necessarily set yet. Since this handler gets called when
l_Restarting is enabled, we'll use this flag to avoid config update
events resulting in object deactivation (object->IsActive() always
returns false).

refs #5996
refs #6691
refs #6970

fixes #7125

(cherry picked from commit 78e24c53f1564269f744de5efe50cb099cadbdde)

Improve REST API docs

- Better explanation for filters and filter_vars
- Update examples to use filters in the body only, don't fuck around with the URL parameters.
- Better explain actions and their intent
- More insights into config packages and their intention
- Improve API clients and add the tables from icinga2-api-examples
- Formatting for CLI requests

(cherry picked from commit 31170db12349f67b48b56f67342225a19e0f34e3)

Fix headings in the docs

refs #6918

(cherry picked from commit e909302fd90ccc4aecdb99bcc04750c4aa0f098d)

Docs: Improve config object types chapter

(cherry picked from commit 2ce82b56d480cb0af469cc5d6feb8eb52c3f9c49)

Doc: adjust default of ApiListener#bind_host

(cherry picked from commit 915525dbcdb1af544aa7518250955d9c1d78fa3a)

Add technical concept docs for our internal JSON-RPC message API

(cherry picked from commit 3c591a03b048cc3fd00ad75e467797f9448f3fa5)

Technical Concepts: Add config compiler references

(cherry picked from commit 219602761166375b51089aaa25c9d7e28cf692d3)

Avoid duplicating non-zero count message replay messages in the debug log

(cherry picked from commit 5d59863725ea843312fd89a9fc9e434187a56650)

Merge pull request #7181 from Icinga/feature/x509-check-command

Add check command for x509's host check

doc: Add section for x509 to the ITL chapter