title: OpenDTU: System / DTU health
agents: special/opendtu
catalog: hw/environment/opendtu
license: GPL-2.0-only
distribution: check_mk
description:
 Monitors the OpenDTU / OpenDTU-OnBattery gateway (the ESP32 board itself) via its
 local HTTP API ({/api/livedata/status}, {/api/prometheus/metrics} and
 {/api/system/status}).

 One service {OpenDTU System} is created per OpenDTU host. It reports firmware
 version and git hash, uptime, ESP32 heap usage and free heap, WiFi signal strength,
 the ESP32 CPU temperature, the last reset reason, and -- when {/api/system/status}
 is reachable -- whether a configured NRF24 / CMT2300 radio is actually connected.

 The service goes {CRIT} when the device cannot be reached at all (the error is shown
 in the summary). It goes {WARN}/{CRIT} on heap usage, on low WiFi signal, and on high
 CPU temperature according to the "OpenDTU System" check parameters, and {WARN} when a
 configured radio is not connected. All thresholds are configurable and can be turned
 off.

item:
 (no item -- one service per host)

discovery:
 One service is created if the special agent returns any OpenDTU data for the host.
