Series temporales

Recoge las métricas de ProbeHarbor en Influx

Recoge las métricas Prometheus de Pro en InfluxDB, VictoriaMetrics o cualquier salida de Telegraf, con el mismo /api/v1/metrics que Grafana.

Descargar la configuración de Telegraf Empieza gratis / Pro API HTTPTodas las integraciones

Cómo funciona

Las claves de API de Pro exponen texto de Prometheus en GET /api/v1/metrics. El inputs.prometheus de Telegraf consulta ese endpoint y escribe en InfluxDB 2.x, VictoriaMetrics o cualquier salida de Telegraf. Sin una API nueva de ProbeHarbor: el mismo contrato que Grafana.

Inicio rápido

  1. Crea una clave de API de Pro en Dashboard → Share.
  2. Descarga telegraf/probeharbor.conf y define PROBEHARBOR_API_KEY, INFLUX_TOKEN, INFLUX_ORG, INFLUX_BUCKET.
  3. telegraf --config probeharbor.conf: comprueba que los puntos de probeharbor_sensor_value llegan al bucket.
curl -sH "Authorization: Bearer $PROBEHARBOR_API_KEY" \
  https://probeharbor.dev/api/v1/metrics | head

Forma de la métrica

Un único gauge probeharbor_sensor_value con las etiquetas device, key, kind (temperature, humidity, flood, …). Solo lecturas numéricas: los valores booleanos se quedan en el JSON compartido / HACS / Matter.

Autoalojado: reemplaza el host en la URL de Telegraf. Quienes usan VictoriaMetrics pueden cambiar la salida por Prometheus remote write (hay un ejemplo comentado en la configuración).

Grafana sigue funcionando

¿Prefieres dashboards a una TSDB de largo plazo? Importa probeharbor-dashboard.json con una fuente de datos Prometheus que apunte a la misma URL de métricas.

Preguntas frecuentes sobre Influx

Recolección con Telegraf, claves Pro y VictoriaMetrics.

¿Necesito una nueva API de ProbeHarbor para Influx?

No. Telegraf recoge datos del endpoint de Prometheus de Pro que ya existe, GET /api/v1/metrics. Configuración de ejemplo: probeharbor.dev/telegraf/probeharbor.conf. Guía: probeharbor.dev/integrations/influx.

¿Esto sustituye a Grafana?

No. Usa Grafana para paneles sobre Prometheus; usa Influx/VictoriaMetrics cuando quieras una base de datos de series temporales a largo plazo o ya tengas un stack de Influx. El nombre de la métrica es el mismo: probeharbor_sensor_value.

¿Y los sensores booleanos de fuga o puerta?

Las métricas de Prometheus solo son numéricas. Para valores booleanos usa el JSON compartido, HACS o el puente Matter.