Плагины
В образе агента нет провайдеров. Каталог — тот же, что во вкладке Marketplace локального UI и в кабинете WaveGrid: агент скачивает wheel по tenant token, затем в YAML появляется секция.
Сейчас ставятся Proxmox, Prometheus, SpaceWeb, Cloudflare, Hetzner Cloud, REG.RU, REG.RU Cloud, VK Cloud, Selectel, Miran, Yandex Cloud и Cloud.ru. AWS описан в каталоге (wheel — по мере публикации). Остальные карточки — «скоро».
Доступны
| Плагин | Категория | Что собирает |
|---|---|---|
| Proxmox VE | Виртуализация | Ноды, VM, LXC, хранилища |
| Prometheus | Мониторинг | Scrape-targets как серверы и домены |
| SpaceWeb | Облако / хостинг | VPS, домены, DNS |
| Cloudflare | DNS | Зоны, DNS, R2/KV, D1/Hyperdrive, балансировщики |
| Hetzner Cloud | Облако | Серверы, volumes, LB, IP, сети, firewall, сертификаты |
| REG.RU | Облако / регистратор | Домены, DNS, хостинг, VPS |
| REG.RU Cloud | Облако | Reglet’ы cloud.reg.ru, доп. IP, приватные сети |
| VK Cloud | Облако | Серверы, диски, сети, floating IP, группы безопасности, балансировщики |
| Selectel | Облако | Инстансы, выделенные серверы, диски, сети, floating IP, группы безопасности, балансировщики |
| Miran | Облако / дата-центр | Выделенные серверы, VDS, домены, хостинг, колокация, IP |
| Yandex Cloud | Облако | Виртуальные машины, диски, сети, публичные IP, группы безопасности, балансировщики |
| Cloud.ru | Облако | Виртуальные машины, диски, подсети, VPC, публичные IP, группы безопасности, балансировщики Evolution |
| Amazon Web Services | Облако | Compute, БД, балансировщики, хранилища |
Поля конкретного провайдера рисует schema плагина в локальном UI после Install.
Скоро
Wheel ещё не опубликован. В Marketplace кнопка Install неактивна; страница описывает, что появится.
| Плагин | Категория | План сбора |
|---|---|---|
| DigitalOcean | Облако | Droplets, volumes, LB |
| Google Cloud | Облако | Compute, SQL, балансировщики |
| Microsoft Azure | Облако | VM, диски, LB |
| Kubernetes | Оркестрация | Ноды и нагрузки кластера |
Установка
После того как агент подключён и видит API:
# Docker
docker compose exec agent wg-flow-agent plugin marketplace list
docker compose exec agent wg-flow-agent plugin install proxmox
docker compose exec agent wg-flow-agent plugin install prometheus
docker compose exec agent wg-flow-agent plugin install sweb
docker compose exec agent wg-flow-agent plugin install cloudflare
docker compose exec agent wg-flow-agent plugin install hetzner
docker compose exec agent wg-flow-agent plugin install regru
docker compose exec agent wg-flow-agent plugin install regcloud
docker compose exec agent wg-flow-agent plugin install vkcloud
docker compose exec agent wg-flow-agent plugin install selectel
docker compose exec agent wg-flow-agent plugin install miran
docker compose exec agent wg-flow-agent plugin install yandex
docker compose exec agent wg-flow-agent plugin install cloudru
docker compose exec agent wg-flow-agent plugin list
# pip / хост
wg-flow-agent plugin marketplace list
wg-flow-agent plugin install proxmoxТо же из локального UI: вкладка Marketplace → Install.
Wheel кладётся в ~/.wg-flow-agent/plugins (в контейнере — /var/lib/wg-flow-agent/plugins, том agent_data).
Обновить: wg-flow-agent plugin update proxmox. Снять: plugin uninstall.
Включить в YAML
После install добавьте секцию plugins.<name>. Поля конкретного провайдера — на его странице. Минимальный каркас:
plugins:
proxmox:
enabled: true
sources:
- id: dc1
provider_account: "proxmox-dc1"
sync_interval_seconds: 300
# дальше — поля API, см. страницу плагинаНесколько sources — несколько аккаунтов одного провайдера. Ресурсы в инвентаре различаются по provider_account.
Форму без правки YAML даёт локальный UI после install (схема с маркетплейса).
Расписание
У каждого source свой sync_interval_seconds (минимум 300). Если несколько source «созрели» в один тик — агент склеивает их в один POST /sync/. Если никто не due, раз в интервал планировщика уходит пустой heartbeat, чтобы агент не стал offline.