Séries temporais

Colete o ProbeHarbor no Influx

Colete métricas Prometheus do Pro no InfluxDB, VictoriaMetrics ou qualquer saída do Telegraf — o mesmo contrato /api/v1/metrics do Grafana.

Baixar a configuração do Telegraf Comece grátis / Pro API HTTPTodas as integrações

Como funciona

As chaves de API do Pro expõem texto Prometheus em GET /api/v1/metrics. O inputs.prometheus do Telegraf coleta esse endpoint e grava no InfluxDB 2.x, VictoriaMetrics ou em qualquer saída do Telegraf. Nenhuma API nova do ProbeHarbor — o mesmo contrato do Grafana.

Início rápido

  1. Crie uma chave de API Pro em Dashboard → Share.
  2. Baixe telegraf/probeharbor.conf e defina PROBEHARBOR_API_KEY, INFLUX_TOKEN, INFLUX_ORG, INFLUX_BUCKET.
  3. telegraf --config probeharbor.conf — confirme que os pontos de probeharbor_sensor_value chegam ao bucket.
curl -sH "Authorization: Bearer $PROBEHARBOR_API_KEY" \
  https://probeharbor.dev/api/v1/metrics | head

Formato das métricas

Um único gauge probeharbor_sensor_value com os rótulos device, key, kind (temperature, humidity, flood, …). Apenas leituras numéricas — os booleanos ficam no JSON de compartilhamento / HACS / Matter.

Instalação própria: troque o host na URL do Telegraf. Quem usa VictoriaMetrics pode trocar a saída por Prometheus remote write (há um exemplo comentado na configuração).

O Grafana continua funcionando

Prefere dashboards a um TSDB de longo prazo? Importe probeharbor-dashboard.json com uma fonte de dados Prometheus apontando para a mesma URL de métricas.

Perguntas frequentes sobre Influx

Coleta com Telegraf, chaves Pro e VictoriaMetrics.

Preciso de uma nova API do ProbeHarbor para o Influx?

Não. O Telegraf coleta do endpoint Prometheus já existente do Pro, GET /api/v1/metrics. Configuração de exemplo: probeharbor.dev/telegraf/probeharbor.conf. Guia: probeharbor.dev/integrations/influx.

Isso substitui o Grafana?

Não. Use o Grafana para painéis sobre o Prometheus; use Influx/VictoriaMetrics quando quiser um banco de séries temporais de longo prazo ou já tiver uma stack Influx. Mesmo nome de métrica: probeharbor_sensor_value.

E os sensores booleanos de vazamento/porta?

As métricas do Prometheus são apenas numéricas. Para booleanos, use o JSON de compartilhamento, o HACS ou a ponte Matter.