Установка агента

Агент ставится одной командой. Команда генерируется в портале: карточка клиента → Onboarding → «Сгенерировать». Ссылка одноразовая и живёт ограниченное время — если истекла, просто сгенерируйте новую.

Linux

Поддерживаются systemd-дистрибутивы (Debian, Ubuntu, RHEL/CentOS/Alma/Rocky и др.), x86_64 и arm64. Выполните команду из портала — она сама определит, есть ли sudo, и подхватит root напрямую, если его нет:

curl -fsSL 'https://platform.voltir.tech/api/onboarding/…' | if [ "$(id -u)" = 0 ]; then bash; else sudo bash; fi

Скрипт установит службы: monitoring-node-exporter (метрики), monitoring-vmagent (доставка), monitoring-vector (журналы), monitoring-snmp-exporter и таймеры heartbeat/snmp-sync; при наличии Docker — ещё monitoring-cadvisor (метрики контейнеров, см. «Мониторинг Docker»). Хост появится в портале в течение минуты, в метриках его адрес — в label instance.

Проверка состояния: systemctl status monitoring-*

Windows

Windows 10/11 и Windows Server 2016+. В PowerShell от администратора выполните команду из блока «Windows»:

powershell -NoProfile -ExecutionPolicy Bypass -Command "iex (iwr -UseBasicParsing 'https://platform.voltir.tech/api/onboarding/…&os=windows').Content"

Устанавливаются службы monitoring-windows-exporter, monitoring-vmagent, monitoring-fluent-bit (журналы Application и System) и задача планировщика для heartbeat.

Проверка: Get-Service monitoring-*

Kubernetes

Для кластера вместо агента применяется манифест. В портале: Onboarding → «Сгенерировать» → блок Kubernetes; выполните команду с машины, где настроен доступ к кластеру:

kubectl apply -f 'https://platform.voltir.tech/api/onboarding/…&os=kubernetes'

Что при этом ставится в кластер, какие нужны права доступа и как отключить мониторинг — на странице Мониторинг Kubernetes.

Автообновление агентов

Раз в сутки (со случайной задержкой до 6 часов) агент проверяет у платформы, не вышла ли новая версия, и при необходимости переустанавливает себя по собственному токену — токен, запись хоста и история сохраняются.

Управление — на вкладке «Хосты» вашей организации: чекбокс «Автообновление агентов включено» (доступен администратору организации) и счётчик «N хостов ждут обновления». У хоста с устаревшей версией агента появляется бейдж «обновление».

Проверить обновление руками:

• Linux: systemctl start monitoring-agent-update.service && journalctl -u monitoring-agent-update -n 20
• Windows: задача планировщика MonitoringAgentUpdate (ежедневно в 3:00 + случайная задержка до 6 часов), лог C:\Program Files\MonitoringAgent\logs\agent-update.log

Kubernetes-агент сам не обновляется — при выходе новой версии переприменить манифест установки со страницы онбординга.

Повторная установка и обновление

Команду можно выполнять поверх уже установленного агента — службы будут корректно пересозданы и перезапущены. Данные и история не теряются. Версия установленного агента видна в списке хостов (колонка «Агент», например 1.3.0) — по ней удобно проверить, что переустановка или автообновление применились.

Удаление хоста из мониторинга

1. Остановите агента на сервере:
   Linux: systemctl disable --now monitoring-vmagent monitoring-vector monitoring-node-exporter monitoring-heartbeat.timer
   Windows: Stop-Service monitoring-*; sc.exe delete … (или повторная установка ничего не оставит лишнего)
2. В портале: вкладка «Хосты» → «Удалить». Если агент ещё работает, хост вернётся со следующим heartbeat — это защита от случайного удаления живого сервера.

Накопленные метрики удалённого хоста остаются доступными до истечения срока хранения.

Стороннее ПО в составе агента

Агент устанавливает компоненты с открытым исходным кодом (node_exporter, vmagent, vector и другие) в неизменённом виде. Перечень и полные тексты лицензий: third-party-licenses.txt; та же справка кладётся инсталлятором на каждый сервер рядом с конфигурацией агента.