Séries temporelles

Collecter ProbeHarbor dans Influx

Collectez les métriques Prometheus Pro dans InfluxDB, VictoriaMetrics ou toute sortie Telegraf — même contrat /api/v1/metrics que Grafana.

Télécharger la configuration Telegraf Commencer gratuitement / Pro API HTTPToutes les intégrations

Fonctionnement

Les clés API Pro exposent du texte au format Prometheus sur GET /api/v1/metrics. Le plugin inputs.prometheus de Telegraf collecte ce endpoint et écrit vers InfluxDB 2.x, VictoriaMetrics ou n’importe quelle sortie Telegraf. Aucune nouvelle API ProbeHarbor — le même contrat que Grafana.

Démarrage rapide

  1. Créez une clé API Pro dans Dashboard → Share.
  2. Téléchargez telegraf/probeharbor.conf et définissez PROBEHARBOR_API_KEY, INFLUX_TOKEN, INFLUX_ORG, INFLUX_BUCKET.
  3. telegraf --config probeharbor.conf — vérifiez que les points probeharbor_sensor_value arrivent dans le bucket.
curl -sH "Authorization: Bearer $PROBEHARBOR_API_KEY" \
  https://probeharbor.dev/api/v1/metrics | head

Forme des métriques

Une seule jauge probeharbor_sensor_value avec les labels device, key, kind (temperature, humidity, flood, …). Relevés numériques uniquement — les booléens restent dans le JSON de partage / HACS / Matter.

Auto-hébergé : remplacez l’hôte dans l’URL Telegraf. Avec VictoriaMetrics, vous pouvez remplacer la sortie par Prometheus remote write (exemple commenté dans la configuration).

Grafana fonctionne toujours

Vous préférez les tableaux de bord à une base de séries temporelles à long terme ? Importez probeharbor-dashboard.json avec une source de données Prometheus pointant vers la même URL de métriques.

FAQ Influx

Collecte Telegraf, clés Pro et VictoriaMetrics.

Faut-il une nouvelle API ProbeHarbor pour Influx ?

Non. Telegraf collecte l’endpoint Prometheus Pro existant, GET /api/v1/metrics. Exemple de configuration : probeharbor.dev/telegraf/probeharbor.conf. Guide : probeharbor.dev/integrations/influx.

Cela remplace-t-il Grafana ?

Non. Utilisez Grafana pour des tableaux de bord sur Prometheus ; utilisez Influx/VictoriaMetrics si vous voulez une base de séries temporelles à long terme ou si vous avez déjà une stack Influx. Même nom de métrique : probeharbor_sensor_value.

Et les capteurs booléens de fuite ou de porte ?

Les métriques Prometheus sont uniquement numériques. Pour les booléens, utilisez le JSON de partage, HACS ou la passerelle Matter.