Бинарный
Перед началом установки
Агент представляет из себя бинарный файл и не требует дополнительных зависимостей.
Создайте директорию
sudo mkdir -p /opt/am-agent && sudo chown -R $USER:$USER /opt/am-agent && cd /opt/am-agent
Примечание
Выполняется в сеансе CMD или PowerShell с правами администратора.
mkdir "C:\Program Files\am-agent"
cd "C:\Program Files\am-agent"
Создайте файл конфигурации
Для запуска агента требуется указать адрес для его подключения. Агент должен иметь доступ к компоненту config-api через прокси шлюз. По умолчанию, точка подключения агента для docker-compose версии находится на 8427 порту сервера мониторинга, для kubernetes есть преднастроеный ingress vmauth, выступающий точкой подключения агентов.
Важно
Ниже представлен пример минимальной конфигурации агента. Подробнее про возможные сценарии, аргументы и параметры можно узнать в разделе конфигурирования агента.
Конфигурационный файл должен находиться в одной директории с запускаемым файлом агента. По умолчанию, это /opt/am-agent/config.yml для Linux-систем и C:\Program Files\am-agent\config.yml для Windows-систем.
general:
# адрес для подключения vmauth(8427) или другой агент с proxy agent(9700)
upstream_address: https://astra-monitoring.server:8427
insecure: True # игнорировать самоподписаный сертификат для https
# name: Имя_в_интерфейсе # имя агента
# hostname: hostname # имя хоста агента
# auth_token: <upstream_token> # токен для подключения
Замените general.upstream_address на адрес своего сервера astra-monitoring.
Скачать агент
Из публичного репозитория
Бинарный файл агента можно загрузить с сайта dl.astralinux.ru.
Скачиваем архив с агентом:
Скачиваем архив с последней (latest) версией агента
curl -sLo agent.tgz https://dl.astralinux.ru/am/generic/agent/latest/linux/amd64/agent.tgz
Доступные архитектуры:
amd64
arm64
Распаковываем архив с агентом
tar zxvf agent.tgz
Скачиваем архив с последней (latest) версией агента
Примечание
Выполняется в сеансе PowerShell (с правами администратора для сохранения в Program Files).
[Net.ServicePointManager]::SecurityProtocol = "tls12, tls11, tls"
Invoke-WebRequest -OutFile agent.tgz -Uri https://dl.astralinux.ru/am/generic/agent/latest/windows/amd64/agent.tgz
Доступные архитектуры:
amd64
Распаковываем архив с агентом
tar zxvf agent.tgz
Скачиваем архив с последней (latest) версией агента
curl -sLo agent.tgz https://dl.astralinux.ru/am/generic/agent/latest/darwin/amd64/agent.tgz
Доступные архитектуры:
amd64
arm64
Распаковываем архив с агентом
tar zxvf agent.tgz
Из платформы мониторинга
Бинарный файл агента можно загрузить из установленной платформы astra-monitoring. Для загрузки не требуется доступ к публичному ресурсу, бинарный файл агента поставляется одновременно с бинарными файлами экспортеров через репозиторий, разворачивающийся вместе с платформой.
При скачивании агента из платформы он всегда будет соответствовать версии релиза платформы мониторинга.
Важно
Контейнер с репозиторием включен в установку astra-monitoring по умолчанию, но не является обязательным компонентом и может быть не установлен администратором платформы мониторинга.
Скачиваем бинарный файл агента (docker-compose)
curl -sLo agent http://astra-monitoring.server:8427/api/v1/registry/agent/latest/linux/amd64
Скачиваем бинарный файл агента (kubernetes)
curl -sLo agent https://vmauth-astra-monitoring.server/api/v1/registry/agent/latest/linux/amd64
Доступные архитектуры:
amd64
arm64
Примечание
Выполняется в сеансе PowerShell с правами администратора.
Скачиваем бинарный файл агента.
A. Платформа в среде docker-compose:
Invoke-WebRequest -OutFile agent.exe -Uri http://astra-monitoring.server:8427/api/v1/registry/agent/latest/windows/amd64
B. Платформа в среде kubernetes:
[Net.ServicePointManager]::SecurityProtocol = "tls12, tls11, tls"
Invoke-WebRequest -OutFile agent.exe https://vmauth-astra-monitoring.server/api/v1/registry/agent/latest/windows/amd64
Настроить агент
Доступные архитектуры:
amd64
Скачиваем бинарный файл агента (docker-compose)
curl -sLo agent http://astra-monitoring.server:8427/api/v1/registry/agent/latest/darwin/amd64
Скачиваем бинарный файл агента (kubernetes)
curl -sLo agent https://vmauth-astra-monitoring.server/api/v1/registry/agent/latest/darwin/amd64
Доступные архитектуры:
amd64
arm64
Запустить агент
После создания файла конфигурации и корректировки его полей под конкретный хост, необходимо настроить автоматический запуск агента в качестве сервиса.
В Linux-системах необходимо создать unit-файл для запуска агента в качестве сервиса systemd. Это позволит сделать агент автозапускаемым и позволит отслеживать его состояние работы. Ниже приведён пример файла для debian`based систем.
Создаём файл
sudo nano /etc/systemd/system/agent.service
Использует config.yml для чтения адреса подключения
[Unit]
Description=am-agent
Wants=basic.target
After=basic.target network.target
[Service]
Type=exec
WorkingDirectory=/opt/am-agent
ExecStartPre=-/bin/chmod +x /opt/am-agent/agent
ExecStart=/opt/am-agent/agent -c config.yml
ExecReload=/bin/kill -HUP $MAINPID
KillMode=control-group
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
Необходимо указать адрес подключения в файле сервиса
[Unit]
Description=am-agent
Wants=basic.target
After=basic.target network.target
[Service]
Type=exec
WorkingDirectory=/opt/am-agent
ExecStartPre=-/bin/chmod +x /opt/am-agent/agent
ExecStart=/opt/am-agent/agent --upstreamAddr https://astra-monitoring.server:8427
ExecReload=/bin/kill -HUP $MAINPID
KillMode=control-group
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
Добавляем службу агента в автозагрузку и запускаем.
sudo systemctl enable --now agent.service
Проверяем состояние сервиса.
sudo systemctl status agent.service
windows
В Windows-системах запуск агента в качестве сервиса производится с помощью PowerShell.
Примечание
Выполняется в сеансе PowerShell с правами администратора.
New-Service -Name "am-agent" -BinaryPathName '"C:\Program Files\am-agent\agent.exe" -c "C:\Program Files\am-agent\config.yml" -d "C:\Program Files\am-agent\data"'
Start-Service -Name "am-agent"
Проверяем состояние сервиса
Get-Service -Name "am-agent"