Prometheus

Статус: доступен · пакет wg-flow-plugin-prometheus · провайдер prometheus · категория monitoring.

Плагин читает HTTP API Prometheus (/api/v1/targets) и превращает scrape-targets в ресурсы инвентаря. Это не сбор метрик: в WaveGrid уходят identity и labels, не timeseries.

Установка

docker compose exec agent wg-flow-agent plugin install prometheus
# или
wg-flow-agent plugin install prometheus

Дальше — локальный UI → Plugins → prometheus или YAML.

Что попадает в инвентарь

Каждый активный target становится ресурсом. Тип выводится из job/labels (hostname, порт, имя экспортера):

Типичный target	resource_type	Пример provider_resource_id
node_exporter / host	server	host:{ipv4} или node:{hostname}
postgres / mysql / redis	database	из labels job/instance
nginx / haproxy / traefik	load_balancer	scrape URL / instance
blackbox / probe FQDN	domain	hostname
прочие процессы / VM	instance	instance label

Несколько targets на один IP схлопываются в агенте в один server (host:{ip}), если есть IPv4. Поддомены domain в кабинете группируются по apex.

provider всегда prometheus. Несколько Prometheus — разные provider_account.

YAML

plugins:
  prometheus:
    enabled: true
    sources:
      - id: prod
        provider_account: "prom-prod"
        sync_interval_seconds: 300
        url: "https://prometheus.example.com"
        auth_type: bearer
        token: "…"
        verify_tls: true

Поля source

Поле	Обязательно	Описание
id	да	Ключ в логах (prometheus/prod)
provider_account	да	Метка аккаунта в инвентаре
url	да	База Prometheus без /api/v1
auth_type	нет	none, bearer, basic
token	при bearer	Bearer token
username / password	при basic	HTTP Basic
verify_tls	нет	Проверка сертификата HTTPS
sync_interval_seconds	нет	Минимум 300

Агент ходит на {url}/api/v1/targets. Если Prometheus за reverse-proxy с префиксом — включите его в url.

Проверка

wg-flow-agent status
wg-flow-agent dry-run

В JSON — provider: prometheus. В кабинете фильтр провайдера Prometheus. Домены — вкладка Домены (группы apex).

Частые ошибки

Симптом	Что проверить
401 / 403	auth_type и токен; ACL Prometheus
Connection refused	URL с хоста агента, не «localhost» контейнера если Prom снаружи
Пустой список	targets в состоянии unknown / нет discovered
Дубли с Proxmox	разные provider — нормально; слияние в кабинете