Zeitreihen

ProbeHarbor-Daten nach Influx holen

Pro-Prometheus-Metriken nach InfluxDB, VictoriaMetrics oder in jeden Telegraf-Output holen – derselbe /api/v1/metrics-Vertrag wie bei Grafana.

Telegraf-Konfiguration herunterladen Kostenlos starten / Pro HTTP-APIAlle Integrationen

So funktioniert’s

Pro-API-Schlüssel stellen Prometheus-Text unter GET /api/v1/metrics bereit. inputs.prometheus von Telegraf fragt diesen Endpunkt ab und schreibt nach InfluxDB 2.x, VictoriaMetrics oder in jeden anderen Telegraf-Output. Keine neue ProbeHarbor-API – derselbe Vertrag wie bei Grafana.

Schnellstart

  1. Erstelle unter Dashboard → Share einen Pro-API-Schlüssel.
  2. Lade telegraf/probeharbor.conf herunter und setze PROBEHARBOR_API_KEY, INFLUX_TOKEN, INFLUX_ORG, INFLUX_BUCKET.
  3. telegraf --config probeharbor.conf – prüfe, dass probeharbor_sensor_value-Punkte im Bucket ankommen.
curl -sH "Authorization: Bearer $PROBEHARBOR_API_KEY" \
  https://probeharbor.dev/api/v1/metrics | head

Aufbau der Metrik

Ein einzelnes Gauge probeharbor_sensor_value mit den Labels device, key, kind (temperature, humidity, flood, …). Nur numerische Messwerte – boolesche Werte bleiben bei Freigabe-JSON / HACS / Matter.

Selbst gehostet: Ersetze den Host in der Telegraf-URL. Wer VictoriaMetrics nutzt, kann den Output gegen Prometheus Remote Write tauschen (auskommentiertes Beispiel in der Konfiguration).

Grafana funktioniert weiterhin

Lieber Dashboards als eine Langzeit-TSDB? Importiere probeharbor-dashboard.json mit einer Prometheus-Datenquelle, die auf dieselbe Metrik-URL zeigt.

Influx-FAQ

Telegraf-Abfrage, Pro-Schlüssel und VictoriaMetrics.

Brauche ich für Influx eine neue ProbeHarbor-API?

Nein. Telegraf liest den vorhandenen Prometheus-Endpunkt von Pro aus, GET /api/v1/metrics. Beispielkonfiguration: probeharbor.dev/telegraf/probeharbor.conf. Anleitung: probeharbor.dev/integrations/influx.

Ersetzt das Grafana?

Nein. Nutze Grafana für Dashboards auf Basis von Prometheus; nutze Influx/VictoriaMetrics, wenn du eine Zeitreihendatenbank für die Langzeitspeicherung willst oder schon einen Influx-Stack hast. Gleicher Metrikname: probeharbor_sensor_value.

Was ist mit booleschen Wasser- und Türsensoren?

Prometheus-Metriken sind ausschließlich numerisch. Für boolesche Werte nutzt du Freigabe-JSON, HACS oder die Matter-Bridge.