Установка и обновление Yandex Unified Agent
Список поддерживаемых операционных систем
Работа Unified Agent поддерживается на следующих операционных системах:
- Ubuntu 14.04 или выше (возможна установка любым из способов);
- Debian 9 или выше (Docker-образ, deb-пакет или бинарный файл);
- CentOS 7 или выше (Docker-образ);
- Fedora 32 или выше (Docker-образ);
- Fedora CoreOS (Docker-образ).
Подготовка к установке
Перед установкой Yandex Unified Agent выполните следующие шаги:
-
Создайте виртуальную машину в Yandex Cloud или хост вне Yandex Cloud на одной из поддерживаемых операционных систем, например, Ubuntu 14.04 или выше.
-
(Опционально) Установите Docker, если через него вы хотите запускать Unified Agent. Docker уже предустановлен в Fedora CoreOS.
- Настройте публичный IPv4-адрес (рекомендуется).
- Настройте Docker для работы с IPv6 и включите сетевую трансляцию адресов, если вы не можете использовать публичный IPv4-адрес.
-
Создайте сервисный аккаунт в каталоге, куда будут записываться метрики, и назначьте ему роль
monitoring.editor. -
Настройте авторизацию агента в Yandex Monitoring API:
- Если агент установлен на виртуальную машину в Yandex Cloud, привяжите созданный сервисный аккаунт к виртуальной машине. В этом случае агент будет автоматически получать IAM-токен сервисного аккаунта из сервиса-метаданных.
- Если агент установлен на хосте вне Yandex Cloud, создайте авторизованный ключ для сервисного аккаунта. Подробнее про поставку метрик с хостов вне Yandex Cloud читайте в разделе Поставка метрик с хостов вне Yandex Cloud.
Установка
Установите Unified Agent одним из способов:
Unified Agent распространяется в виде Docker-образа. Образ опубликован в репозитории cr.yandex/yc с названием unified_agent и тегом latest. Образ содержит бинарный файл с агентом и конфигурационный файл, настраивающий агент для поставки системных метрик Linux в Yandex Monitoring.
Чтобы загрузить Docker-образ, выполните команду:
sudo docker pull cr.yandex/yc/unified-agent:latest
Unified Agent распространяется в виде deb-пакета для операционных систем Ubuntu 14.04 и выше. Пакет содержит бинарный файл с агентом и пустой конфигурационный файл, расположенный в /etc/yandex/unified_agent/config.yml.
Чтобы установить Unified Agent:
-
Скачайте последнюю версию deb-пакета:
ubuntu_name="<версия_ОС>" \ ua_version=$(curl --silent https://storage.yandexcloud.net/yc-unified-agent/latest-version) \ bash -c 'curl --silent --remote-name https://storage.yandexcloud.net/yc-unified-agent/releases/${ua_version}/deb/${ubuntu_name}/yandex-unified-agent_${ua_version}_amd64.deb'Где
ubuntu_name— версия операционной системы:ubuntu-14.04-trustyubuntu-16.04-xenialubuntu-18.04-bionicubuntu-20.04-focalubuntu-22.04-jammy(начиная с версии23.03.02)ubuntu-24.04-noble
Также вы можете скачать определенную версию Unified Agent. Для этого посмотрите все доступные версии и укажите нужную вместо значения
latest-version:curl --silent https://storage.yandexcloud.net/yc-unified-agent/all-versions -
Посмотрите версию скачанного deb-пакета с помощью команды
ls. -
Выполните команду:
sudo dpkg -i yandex-unified-agent_<версия>_amd64.debГде
<версия>— версия скачанного deb-пакета, например24.12.01.
Unified Agent распространяется в виде бинарного файла, собранного под архитектуру x86-64 / amd64 для операционных систем Ubuntu 14.04 и выше.
Чтобы скачать последнюю версию агента в виде бинарного файла, выполните команду:
ua_version=$(curl --silent https://storage.yandexcloud.net/yc-unified-agent/latest-version) \
bash -c 'curl --silent --remote-name https://storage.yandexcloud.net/yc-unified-agent/releases/$ua_version/unified_agent && chmod +x ./unified_agent'
Вы можете установить Unified Agent при создании виртуальной машины в консоли управления, через CLI, API или Terraform.
Чтобы установить агент из консоли управления, в блоке Мониторинг включите опцию Агент сбора метрик.
Чтобы установить агент через CLI, API или Terraform, укажите в пользовательских метаданных (user-data) строку:
#cloud-config\nruncmd:\n - wget -O - https://monitoring.api.cloud.yandex.net/monitoring/v2/unifiedAgent/config/install.sh | bash
Для установки агента и отправки метрик у виртуальной машины должен быть доступ в интернет.
Агент устанавливается с файлом конфигурации по умолчанию, который находится в /etc/yc/unified_agent/config.yml.
В файле конфигурации настроена отправка базовых метрик виртуальной машины и метрик здоровья агента. Отправка метрик тарифицируется.
Дополнительно можно настроить поставку собственных метрик или логов в Cloud Logging.
После разворачивания ВМ Unified Agent запустится автоматически и начнет передавать базовые метрики ВМ в сервис Yandex Monitoring.
Обновление агента выполняйте вручную через бинарный файл.
Обновление
Обновите Unified Agent одним из способов:
-
Остановите контейнер
ua:sudo docker stop ua -
Удалите контейнер:
sudo docker rm ua -
Запустите контейнер.
Заново скачайте и установите deb-пакет:
-
Скачайте последнюю версию deb-пакета:
ubuntu_name="<версия_ОС>" \ ua_version=$(curl --silent https://storage.yandexcloud.net/yc-unified-agent/latest-version) \ bash -c 'curl --silent --remote-name https://storage.yandexcloud.net/yc-unified-agent/releases/${ua_version}/deb/${ubuntu_name}/yandex-unified-agent_${ua_version}_amd64.deb'Где
ubuntu_name— версия операционной системы:ubuntu-14.04-trustyubuntu-16.04-xenialubuntu-18.04-bionicubuntu-20.04-focalubuntu-22.04-jammy(начиная с версии23.03.02)ubuntu-24.04-noble
Также вы можете скачать определенную версию Unified Agent. Для этого посмотрите все доступные версии и укажите нужную вместо значения
latest-version:curl --silent https://storage.yandexcloud.net/yc-unified-agent/all-versions -
Посмотрите версию скачанного deb-пакета с помощью команды
ls. -
Выполните команду:
sudo dpkg -i yandex-unified-agent_<версия>_amd64.debГде
<версия>— версия скачанного deb-пакета, например24.12.01.
-
Удалите существующий бинарный файл агента.
-
Скачайте последнюю версию агента в виде бинарного файла:
ua_version=$(curl --silent https://storage.yandexcloud.net/yc-unified-agent/latest-version) \ bash -c 'curl --silent --remote-name https://storage.yandexcloud.net/yc-unified-agent/releases/$ua_version/unified_agent && chmod +x ./unified_agent' -
После скачивания исполняемого файла с агентом создайте конфигурационный файл, например, с настройками для поставки системных метрик Linux. Подробнее про конфигурацию агента см. в разделе Конфигурирование.
-
Переместите скачанный файл в папку
/bin/unified_agent. -
Перезапустите агент.
Чтобы узнать все доступные версии агента, выполните команду:
curl --silent https://storage.yandexcloud.net/yc-unified-agent/all-versions
-
Удалите существующий бинарный файл агента.
-
Скачайте последнюю версию агента в виде бинарного файла:
ua_version=$(curl --silent https://storage.yandexcloud.net/yc-unified-agent/latest-version) \ bash -c 'curl --silent --remote-name https://storage.yandexcloud.net/yc-unified-agent/releases/$ua_version/unified_agent && chmod +x ./unified_agent' -
После скачивания исполняемого файла с агентом создайте конфигурационный файл, например, с настройками для поставки системных метрик Linux. Подробнее про конфигурацию агента см. в разделе Конфигурирование.
-
Переместите скачанный файл в папку
/bin/unified_agent. -
Перезапустите агент.
Чтобы узнать все доступные версии агента, выполните команду:
curl --silent https://storage.yandexcloud.net/yc-unified-agent/all-versions