upstream/icinga2
1
0
Fork 0
mirror of https://github.com/Icinga/icinga2.git synced 2026-05-28 04:12:13 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs: note OTLP metrics package limitation on Debian 11 and Ubuntu 22.04 and Amazon Linux 2

Browse source 
(cherry picked from commit 8d9b8ae0fd)
This commit is contained in:
Manas Singh 2026-04-29 07:11:31 +05:30 committed by github-actions[bot]
parent 5855790474
commit bdfd923df6
4 changed files with 28 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
AUTHORS
View file

@ -175,6 +175,7 @@ Maciej Dems <maciej.dems@p.lodz.pl>
Magnus Bäck <magnus@noun.se>
Maik Stuebner <maik@stuebner.info>
Malte Rabenseifner <mail@malte-rabenseifner.de>
Manas Singh <00manassingh00@gmail.com>
Manuel Reiter <reiter@csc.uni-frankfurt.de>
Marc Rupprecht <marc.rupprecht@netways.de>
Marcus van Dam <marcus@marcusvandam.nl>

6
doc/09-object-types.md
View file

@ -1878,6 +1878,12 @@ or any other OTLP-compatible backend that accepts OTLP data over HTTP. This conf
[otlpmetrics feature](14-features.md#otlpmetrics-writer). You can find more information about OpenTelemetry and OTLP
on the [OpenTelemetry website](https://opentelemetry.io/).
!!! info
The official package builds for Debian 11, Ubuntu 22.04 and Amazon Linux 2 do not include this object type.
These builds disable OpenTelemetry support (`ICINGA2_WITH_OPENTELEMETRY=OFF`) because the
default Protobuf compiler version is too old for the required code generation.
A basic copy and pastable example configuration is shown below:
```

15
doc/14-features.md
View file

@ -663,6 +663,21 @@ In order to enable this feature, you can use the following command:
icinga2 feature enable otlpmetrics
```
!!! info
**Package availability note (Debian 11 / Ubuntu 22.04 / Amazon Linux 2):**
The official Icinga 2 packages for Debian 11, Ubuntu 22.04 and Amazon Linux 2 are built with
`-DICINGA2_WITH_OPENTELEMETRY=OFF`, because the default Protobuf compiler in these
distributions is too old for the OpenTelemetry code generation used by Icinga 2.
As a result, the `otlpmetrics` feature (and `OTLPMetricsWriter` type) is not available
in those package builds.
You can verify this on a node with:
```bash
icinga2 feature list | grep otlpmetrics
```
By default, the OTLPMetrics Writer expects the OpenTelemetry Collector or any other OTLP HTTP receiver to listen at
`127.0.0.1` on port `4318` but most of the third-party backends use their own ports, so you may need to adjust the
configuration accordingly. Additionally, the `metrics_endpoint` can vary based on the backend you are using.

6
doc/16-upgrading-icinga-2.md
View file

@ -16,6 +16,12 @@ ElasticsearchWriter is deprecated in v2.16 and will be removed in v2.18. In case
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.
!!! info
The official Icinga 2 packages for Debian 11, Ubuntu 22.04 and Amazon Linux 2 are currently built without
OpenTelemetry support (`ICINGA2_WITH_OPENTELEMETRY=OFF`), so `OTLPMetricsWriter` is not
available there unless you build Icinga 2 with a newer Protobuf toolchain.
### Deprecation of user-defined DSL Namespaces
If you were previously using constructs like `namespace my_utils { ... }` in your config, we suggest