title: OpenDTU: Inverter
agents: special/opendtu
catalog: hw/environment/opendtu
license: GPL-2.0-only
distribution: check_mk
description:
 One service per Hoymiles / TSUN inverter known to OpenDTU. Reachability, production
 state and the current power limit come from {/api/livedata/status}; the AC phase
 values (power, voltage, current, frequency, power factor, reactive power) and the
 inverter totals (DC power, yield today / lifetime, temperature, efficiency) come from
 {/api/prometheus/metrics}. The Hoymiles radio-link statistics (RX success / failures,
 TX requests, link RSSI) are also reported.

 When OpenDTU reports the inverter as not reachable the service goes {WARN} by default
 -- a normal grid-tied solar inverter powers itself down every night once it has no DC
 input, so a nightly {CRIT} would just train you to ignore it. The severity for
 "not reachable" is configurable via the "OpenDTU Inverter" check parameters (set it to
 {OK} to never be told, or {CRIT} for an inverter on an always-on DC source such as a
 battery). The service also goes {WARN}/{CRIT} on high inverter temperature, and -- only
 if you enable them -- on inverter data age and low conversion efficiency (data-age
 levels are off by default because a solar inverter's data age naturally grows to many
 hours overnight).

item:
 The inverter name configured in OpenDTU, or its serial number if unnamed.

discovery:
 One service per inverter returned by the special agent.
