From 35dd4adc13274cb83ed4331c14c6f97a45aff77a Mon Sep 17 00:00:00 2001 From: Johannes Schmidt Date: Wed, 1 Apr 2026 11:20:26 +0200 Subject: [PATCH] Update Upgrading docs for v2.16 --- doc/16-upgrading-icinga-2.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/doc/16-upgrading-icinga-2.md b/doc/16-upgrading-icinga-2.md index bdff71ec4..940410f5c 100644 --- a/doc/16-upgrading-icinga-2.md +++ b/doc/16-upgrading-icinga-2.md @@ -8,6 +8,30 @@ Specific version upgrades are described below. Please note that version updates are incremental. An upgrade from v2.6 to v2.8 requires to follow the instructions for v2.7 too. +## Upgrading to v2.16 + +### Migrating from ElasticsearchWriter to OTLPMetricsWriter + +ElasticsearchWriter is deprecated in v2.16 and will be removed in v2.18. In case you are using Elasticsearch 9.2 or +later we suggest migrating to the new OTLPMetricsWriter as a replacement. The index data structure in +Elasticsearch will be different though, so any third-party tools working with that data will need to be adapted as +well. + +### Deprecation of user-defined DSL Namespaces + +If you were previously using constructs like `namespace my_utils { ... }` in your config, we suggest +replacing them with global functions and variables, since user-defined namespaces will be removed in v2.18. + +### Previously deprecated features + +Since these previously deprecated features are now scheduled for removal in v2.18, please switch to the listed +alternatives: + +* `IdoMySqlConnection` and `IdoPgsqlConnection`: Please switch to Icinga DB. +* `CompatLogger`: Please switch your tools to use the Icinga 2 log format. +* `ExternalCommandListener` and `LivestatusListener`: Please use the [Icinga 2 API](https://icinga.com/docs/icinga-2/2.10/doc/12-icinga2-api/) instead. +* Windows check-plugins (`check_*.exe`) and `CheckCommand`s: Please use our [PowerShell plugins](https://github.com/Icinga/icinga-powershell-plugins) instead. + ## Upgrading to v2.15 ### Icinga DB