HTTP-цели: свои экспортёры
Если сервис сам отдаёт метрики в формате Prometheus — свой экспортёр, приложение с /metrics, Home Assistant, — его можно поставить на опрос из портала, без правки конфигов на сервере.
Как это работает
Цель опрашивает агент Voltir на одном из ваших Linux-хостов — тем же vmagent, что собирает метрики самого сервера. Поэтому адрес цели может быть внутренним (http://192.168.1.51:8123/…, http://127.0.0.1:9187/metrics): наружу открывать ничего не нужно, метрики уходят в платформу по уже защищённому каналу агента.
- Нужен Linux-агент 1.5.0 и новее в той же сети, что и цель (обновляется сам, см. Установка агента).
- Изменения в портале доезжают до агента в течение минуты, перезапускать ничего не нужно.
Как добавить цель
Портал → карточка клиента → вкладка «HTTP-цели» → «Добавить цель»:
| Поле | Что указать |
|---|---|
| Название | Как цель будет называться в метриках и алертах, например Home Assistant. |
| URL | Полный адрес со схемой и путём: http://192.168.1.51:8123/api/prometheus. Поддерживаются http и https. |
| Токен (необязательно) | Уйдёт агенту и подставится в заголовок Authorization: Bearer …. В портале после сохранения не показывается — его можно только заменить или убрать. |
| Интервал | 30 секунд, 60 секунд или 5 минут. |
| Опрашивать с хоста | Конкретный агент или «Все агенты в сети». Лучше выбрать один хост: при «всех» цель опрашивает каждый Linux-агент клиента, и ряды задваиваются. |
prometheus — URL http://<адрес>:8123/api/prometheus, токен — долгоживущий токен доступа из профиля пользователя Home Assistant.Где смотреть метрики
Метрики цели приходят с меткой job="custom:<название>" (если названия совпали — к имени добавляется короткий идентификатор). Смотреть их удобно в Grafana: Explore → источник метрик → {job="custom:Home Assistant"}. На их основе строятся свои дашборды и свои правила алертов.
Алерты
- «Экспортёр не отвечает» (HostDown) — цель перестала отвечать на опрос; в тексте будет
custom:<название>и адрес. - «HTTP-цель не опрашивается» (ScrapeTargetUnpolled) — цель настроена, а агент её не опрашивает 15 минут: хост-опросчик выключен, агент старый или конфигурация не принята.
Если цель не собирается
На хосте, который опрашивает цель:
journalctl -u monitoring-custom-sync -n 50 # получил ли агент цели и принял ли их vmagent curl -s 127.0.0.1:8429/targets # состояние опроса и последняя ошибка
- «платформа недоступна» — агент не достучался до платформы, прежние цели продолжают работать;
- «цель … vmagent не принимает — пропущена» — в той же строке причина (обычно опечатка в адресе). Такая цель не применяется, остальные цели и метрики хоста продолжают собираться.