homelab-brain/infra/telegraf/README.md

Telegraf - Telemetrie-Ingestion (CT143 "Raspi-Broker")

Versionierte Kopie der produktiven Telegraf-Konfiguration. Laufort: CT143 (pve-mu-3), Verzeichnis /etc/telegraf/telegraf.d/.

Diese Dateien sind die Quelle der Wahrheit (Konfiguration zaehlt Git/Doku). Wenn am Server geaendert wird: hier nachziehen + committen + pushen.

Architektur (Stand 21.06.2026)

MQTT-Broker = dedizierter mosquitto 2.0.21 auf CT143 192.168.178.36:1883. Telegraf ist der alleinige MQTT->InfluxDB-Ingest (die alten Python-Bruecken mqtt-influx-bridge.py / mqtt-rewrite-holzvergaser.py sind gestoppt + disabled).

Zwei InfluxDB-Datenbanken:

• sensors - sauberes, aktives Schema (siehe satellites.conf).
• iobroker - eingefrorenes Archiv (Alt-Historie) + weiterhin openWB/PV (siehe openwb.conf).

Routing (wichtig, damit nichts doppelt landet)

Beide Configs definieren je einen outputs.influxdb. Telegraf schickt jede Metrik an alle Outputs, daher wird per name-Filter getrennt:

• satellites.conf -> DB sensors, namepass = temperature, io_state
• openwb.conf -> DB iobroker, namedrop = temperature, io_state

So schreibt der Satelliten-/Heizraum-Ingest ausschliesslich nach sensors, und openWB/PV ausschliesslich nach iobroker - keine Dopplung.

Schema in DB sensors

Measurement	Tags	Wert	Quelle
temperature	node (Raum/heizraum), heizraum zus. sensor=ROM	float Grad C	<raum>/temp, heizraum/<ROM>
io_state	node=heizraum, signal (pumpe1-4/brenner/kessel)	int 0/1	heizraum/io/+, heizraum/state/kessel

Globaler Tag host=Raspi-Broker (Telegraf-Default).

Deploy / Wiederherstellung

# auf CT143 (pve-mu-3):
pct push 143 satellites.conf /etc/telegraf/telegraf.d/satellites.conf
pct push 143 openwb.conf     /etc/telegraf/telegraf.d/openwb.conf
pct exec 143 -- systemctl restart telegraf
# Verifikation:
pct exec 143 -- influx -database sensors -execute 'SHOW MEASUREMENTS'