Jahresrückblick 2025 – unser neuer Blogbeitrag ist online! ✨

[OlliMartin]

Aktuelle Test Version	0.1.0
Veröffentlichungsdatum	28.12.2025
Github Link	https://github.com/ollimartin/ioBroker.otlp

[Storage] Open Telemetry Protocol (OTLP) kompatibler Adapter

Der Adapter ioBroker.OTLP kann benutzt werden um (numerische) States von ioBroker an ein beliebiges Open-Telemetry kompatibles Gateway zu senden.
Beispielsweise der Opentelemetry Collector selbst, aber auch vendorspezifische Distributionen wie Grafana Alloy sind OTLP kompatibel.

Das Ziel ist es eine Anbindung in das Opentelemetry Ökosystem zu schaffen, das für Herstellerunabhängigkeit steht und mit einer Vielzahl an Datenbanken arbeiten kann. So wird nicht ein spezifisches Backend bedient, sondern alle Storage Backends für die ein Opentelemetry Exporter existiert (siehe Github Repo für Beispiele)

Anforderungen

Der Adapter benötigt ein OTLP-kompatibles Gateway das konfiguriert ist Metriken zu empfangen. Es stehen entweder gRPC oder http (protobuf) als OTLP zur Verfügung.

Mehr Informationen zur Konfiguration des Adapters finden sich in der Readme des Repositories.

Wichtig: Der Adapter kann ausschließlich numerische Datenpunkte exportieren, was daran liegt, dass alle Daten als Metrik - genauer Gauge - gepushed werden. Es gibt schlicht kein Open Telemetry Konzept für Text Metriken.
Sollte ein nicht numerischer (oder boolean - was in 1 oder 0 übersetzt wird) Datenpunkt konfiguriert werden, wird er ignoriert und es wird keine Metrik gepushed.

Beispielskonfiguration:

Benutzung

Der Adapter fügt einen Abschnitt in den Custom Settings von States und Objects hinzu, wo das Exportieren der Datenpunke konfiguriert werden kann. Wird OTLP in einem Custom Setting aktiviert schickt der Adapter direkt Metriken an das konfigurierte Gateway.

Anmerkung

Der Adapter richtet sich eher an Bastler oder andere Entwickler die gegebenfalls auch beruflich mit Open-Telemetry arbeiten. Während der Adapter eine sehr große Flebilität bietet wie Daten verarbeitet und gespeichert werden, so sind in der Regel mindestens drei unterschiedliche Systeme involviert; Beispielsweise ein Opentelemetry Collector, Prometheus und Grafana.
Im Repository befindet sich ein kurzer Showcase wie ich selbst den Adapter nutze.

Edit: Git Repo Link angepasst