Установка и обновление Yandex Unified Agent

Unified Agent распространяется в виде deb-пакета для операционных систем Ubuntu 16.04 и выше, Debian 9 и выше. Пакет содержит бинарный файл с агентом и конфигурационный файл, расположенный в /etc/yandex/unified_agent/config.yml.

Чтобы установить Unified Agent:

1. Скачайте последнюю версию deb-пакета:

   ubuntu_name="<версия_ОС>" \
   ua_version=$(curl --silent https://storage.yandexcloud.kz/yc-unified-agent/latest-version) \
   bash -c 'curl --silent --remote-name https://storage.yandexcloud.kz/yc-unified-agent/releases/${ua_version}/deb/${ubuntu_name}/yandex-unified-agent_${ua_version}_amd64.deb'
   

   Где ubuntu_name — версия операционной системы:

   • ubuntu-16.04-xenial
   • ubuntu-18.04-bionic
   • ubuntu-20.04-focal
   • ubuntu-22.04-jammy (начиная с версии 23.03.02)
   • ubuntu-24.04-noble

   Примечание

   При установке Unified Agent на Debian 9 поддерживаются deb-пакеты только для ubuntu-16.04-xenial и ниже, на Debian 10 — для ubuntu-18.04-bionic и ниже.

   Также вы можете скачать определенную версию Unified Agent. Для этого посмотрите список доступных версий и укажите нужную вместо значения latest-version:

   curl --silent https://storage.yandexcloud.kz/yc-unified-agent/all-versions
   

2. Посмотрите версию скачанного deb-пакета с помощью команды ls.

   Результат:

   yandex-unified-agent_<версия>_amd64.deb
   

   Где <версия> — версия скачанного deb-пакета, например 24.12.01.

3. Для установки скачанного deb-пакета выполните команду:

   sudo dpkg -i yandex-unified-agent_<версия>_amd64.deb
   

4. Чтобы убедиться, что Unified Agent успешно установлен и запущен, выполните команду:

   systemctl status unified-agent
   

   Результат:

   ● unified-agent.service - Yandex Unified Agent service
        Loaded: loaded (/lib/systemd/system/unified-agent.service; enabled; vendor preset: enabled)
        Active: active (running) since Wed 2025-10-01 08:49:44 UTC; 27min ago
      Main PID: 1106 (unified_agent)
         Tasks: 8 (limit: 2308)
        Memory: 5.2M
           CPU: 136ms
        CGroup: /system.slice/unified-agent.service
                └─1106 /usr/bin/unified_agent --config /etc/yandex/unified_agent/config.yml --log-priority NOTICE
   

При установке Unified Agent выполняются действия:

• Установка исполняемого файла unified_agent.

• Установка базового файла конфигурации /etc/yc/unified_agent/config.yml. В конфигурации настроена отправка базовых метрик виртуальной машины и метрик здоровья агента. Отправка метрик тарифицируется.

  Дополнительно можно настроить поставку собственных метрик или логов в Cloud Logging.

• Конфигурация системы инициализации, добавление нового сервиса unified-agent. Сервис запускается при старте системы.

• Создание пользователя unified_agent с uid 1515 и одноименной группы с gid 1515.

  Если данные uid или gid недоступны (заняты), пользователь и группа создаются без указания явного uid и gid.

• Создание и настройка доступа к директории для пользовательской конфигурации /etc/yandex/unified_agent/conf.d.

• Создание и настройка доступа к директории для пользовательского хранилища /var/lib/yandex/unified_agent.

Unified Agent распространяется в виде бинарного файла, собранного под архитектуру x86-64 / amd64 для операционных систем Ubuntu 16.04 и выше.

Чтобы скачать последнюю версию агента в виде бинарного файла, выполните команду:

ua_version=$(curl --silent https://storage.yandexcloud.kz/yc-unified-agent/latest-version) \
bash -c 'curl --silent --remote-name https://storage.yandexcloud.kz/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.yandexcloud.kz/monitoring/v2/unifiedAgent/config/install.sh | bash

Для установки агента и отправки метрик у виртуальной машины должен быть доступ в интернет.

При установке Unified Agent выполняются действия:

• Установка исполняемого файла unified_agent.

• Установка базового файла конфигурации /etc/yc/unified_agent/config.yml. В конфигурации настроена отправка базовых метрик виртуальной машины и метрик здоровья агента. Отправка метрик тарифицируется.

  Дополнительно можно настроить поставку собственных метрик или логов в Cloud Logging.

• Конфигурация системы инициализации, добавление нового сервиса unified-agent. Сервис запускается при старте системы.

• Создание пользователя unified_agent с uid 1515 и одноименной группы с gid 1515.

  Если данные uid или gid недоступны (заняты), пользователь и группа создаются без указания явного uid и gid.

• Создание и настройка доступа к директории для пользовательской конфигурации /etc/yandex/unified_agent/conf.d.

• Создание и настройка доступа к директории для пользовательского хранилища /var/lib/yandex/unified_agent.

После разворачивания ВМ Unified Agent запустится автоматически и начнет передавать базовые метрики ВМ в сервис Yandex Monitoring.

Обновление агента выполняйте вручную через бинарный файл.

Заново скачайте и установите deb-пакет последней версии.

1. Удалите существующий бинарный файл агента.

2. Скачайте последнюю версию агента в виде бинарного файла:

   ua_version=$(curl --silent https://storage.yandexcloud.kz/yc-unified-agent/latest-version) \
   bash -c 'curl --silent --remote-name https://storage.yandexcloud.kz/yc-unified-agent/releases/$ua_version/unified_agent && chmod +x ./unified_agent'
   

3. После скачивания исполняемого файла с агентом создайте конфигурационный файл, например, с настройками для поставки системных метрик Linux. Подробнее про конфигурацию агента см. в разделе Конфигурирование.

   Важно

   В файле конфигурации замените URL monitoring.api.cloud.yandex.net на monitoring.api.yandexcloud.kz.

4. Переместите скачанный файл в папку /bin/unified_agent.

5. Перезапустите агент.

Чтобы узнать все доступные версии агента, выполните команду:

curl --silent https://storage.yandexcloud.kz/yc-unified-agent/all-versions

1. Удалите существующий бинарный файл агента.

2. Скачайте последнюю версию агента в виде бинарного файла:

   ua_version=$(curl --silent https://storage.yandexcloud.kz/yc-unified-agent/latest-version) \
   bash -c 'curl --silent --remote-name https://storage.yandexcloud.kz/yc-unified-agent/releases/$ua_version/unified_agent && chmod +x ./unified_agent'
   

3. После скачивания исполняемого файла с агентом создайте конфигурационный файл, например, с настройками для поставки системных метрик Linux. Подробнее про конфигурацию агента см. в разделе Конфигурирование.

   Важно

   В файле конфигурации замените URL monitoring.api.cloud.yandex.net на monitoring.api.yandexcloud.kz.

4. Переместите скачанный файл в папку /bin/unified_agent.

5. Перезапустите агент.

Чтобы узнать все доступные версии агента, выполните команду:

curl --silent https://storage.yandexcloud.kz/yc-unified-agent/all-versions