meinberg-ltos-exporter

README

Prometheus Exporter for Meinberg LTOS

Prometheus exporter meinberg_ltos_exporter is designed for Meinberg devices running LTOS. It retrieves the status of a device via its REST API and exposes the available data as Prometheus metrics.

[!IMPORTANT] This exporter is experimental and has only been tested against a very limited number of devices. It may not work correctly with all Meinberg devices and LTOS versions.

Please provide feedback through GitHub issues, include the anonymized JSON output of /api/status to facilitate extending or fixing the exporter.

Supported Meinberg LTOS Devices

The exporter has been tested with the following Meinberg LTOS devices:

Model	Receiver	LTOS Version
M600	grc180	7.10.008
M300	pzf511	7.06.014-light

Docker

docker run --rm -p 10123:10123 \
  -e MEINBERG_LTOS_EXPORTER_TARGET=https://<device> \
  -e MEINBERG_LTOS_EXPORTER_AUTH_USER=<user> \
  -e MEINBERG_LTOS_EXPORTER_AUTH_PASS=<password> \
  -e MEINBERG_LTOS_EXPORTER_LISTEN_ADDR=0.0.0.0 \
  ghcr.io/raphaelthomas/meinberg_ltos_exporter:latest

Configuration

The exporter can be configured via the following parameters:

usage: meinberg_ltos_exporter --target=TARGET [<flags>]

Prometheus exporter for Meinberg LTOS devices


Flags:
  -h, --[no-]help                Show context-sensitive help (also try --help-long and --help-man).
      --[no-]version             Show application version.
      --web.listen-address="localhost"
                                 Address to listen on ($MEINBERG_LTOS_EXPORTER_LISTEN_ADDR)
      --web.listen-port="10123"  Port to listen on ($MEINBERG_LTOS_EXPORTER_LISTEN_PORT)
      --web.telemetry-path="/metrics"
                                 Path under which to expose metrics ($MEINBERG_LTOS_EXPORTER_METRICS_PATH)
      --target=TARGET            Base URL of the Meinberg LTOS device (e.g. https://clock.example.com) ($MEINBERG_LTOS_EXPORTER_TARGET)
      --auth-user=AUTH-USER      Basic auth username (prefer env var over CLI flag) ($MEINBERG_LTOS_EXPORTER_AUTH_USER)
      --auth-pass=AUTH-PASS      Basic auth password (prefer env var over CLI flag) ($MEINBERG_LTOS_EXPORTER_AUTH_PASS)
      --timeout=5s               Timeout for HTTP requests to Meinberg device ($MEINBERG_LTOS_EXPORTER_TIMEOUT)
      --[no-]ignore-ssl-verify   Ignore SSL certificate verification ($MEINBERG_LTOS_EXPORTER_IGNORE_SSL_VERIFY)
      --log-level=info           Log level (debug, info, warn, error)
      --[no-]collector.system    Enable system collector. ($MEINBERG_LTOS_EXPORTER_COLLECTOR_SYSTEM)
      --[no-]collector.notification
                                 Enable notification collector. ($MEINBERG_LTOS_EXPORTER_COLLECTOR_NOTIFICATION)
      --[no-]collector.storage   Enable storage collector. ($MEINBERG_LTOS_EXPORTER_COLLECTOR_STORAGE)
      --[no-]collector.clock     Enable clock collector. ($MEINBERG_LTOS_EXPORTER_COLLECTOR_CLOCK)
      --[no-]collector.receiver  Enable receiver collectors (GNSS + DCF77). ($MEINBERG_LTOS_EXPORTER_COLLECTOR_RECEIVER)
      --[no-]collector.ntp       Enable NTP collector. ($MEINBERG_LTOS_EXPORTER_COLLECTOR_NTP)

These parameters can be provided as environment variables or command-line arguments.

Authentication

The exporter supports Basic Authentication. Ensure the user has the "info" access level (lowest permission level) configured on the LTOS device.

Build

To build the exporter, run the following command, which will create an executable named meinberg_ltos_exporter:

make build

or run goreleaser directly:

goreleaser build --snapshot --clean

Local Development

Run the following in three separate terminal windows:

1. A mock LTOS API serving static test data. Supply a file from tests/testdata/ as static API JSON response via FILE:

   make mock-api FILE=tests/testdata/m600-gps.json AUTH_USER=myuser AUTH_PASS=mypass
   

2. Run the exporter (triggers a build if necessary):

   make run AUTH_USER=myuser AUTH_PASS=mypass
   

3. Scrape the metrics exposed by the exporter:

   curl -s http://localhost:10123/metrics | grep meinberg_ltos