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

Статья создана

Yandex Cloud

Обновлена 19 мая 2026 г.

Список поддерживаемых операционных систем
Подготовка к установке
Установка
Обновление
Пример установки и настройки

Примечание

Unified Agent с версии 25.03.80 может собирать и передавать метрики Prometheus.

Подробнее см. раздел Агент для сбора метрик Prometheus.

Список поддерживаемых операционных систем

Работа Unified Agent поддерживается на следующих операционных системах:

Ubuntu 16.04 или выше (возможна установка любым из способов);
Debian 9 или выше (Docker-образ, deb-пакет или бинарный файл);
CentOS 7 или выше (Docker-образ);
Fedora 32 или выше (Docker-образ);
Fedora CoreOS (Docker-образ).

Подготовка к установке

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

Создайте виртуальную машину в Yandex Cloud или хост вне Yandex Cloud на одной из поддерживаемых операционных систем, например Ubuntu 16.04 или выше.
(Опционально) Установите Docker, если через него вы хотите запускать Unified Agent. Docker уже предустановлен в Fedora CoreOS.
- Настройте публичный IPv4-адрес (рекомендуется).
- Настройте Docker для работы с IPv6 и включите сетевую трансляцию адресов, если вы не можете использовать публичный IPv4-адрес.
Создайте сервисный аккаунт в каталоге, куда будут записываться метрики, и назначьте ему роль monitoring.editor.
Настройте авторизацию агента в Monium API:
- Если агент установлен на виртуальную машину в Yandex Cloud, привяжите созданный сервисный аккаунт к виртуальной машине. В этом случае агент будет автоматически получать IAM-токен сервисного аккаунта из сервиса метаданных.
- Если агент установлен на хосте вне Yandex Cloud, создайте авторизованный ключ для сервисного аккаунта. Подробнее про поставку метрик с хостов вне Yandex Cloud читайте в разделе Поставка метрик с хостов вне Yandex Cloud.

Установка

Установите Unified Agent одним из способов:

Docker-образ

deb-пакет

Бинарный файл

При создании ВМ

Установите Docker Engine. Воспользуйтесь инструкцией по установке и запуску Docker для вашей операционной системы.

Unified Agent распространяется в виде Docker-образа. Образ опубликован в репозитории cr.yandexcloud.kz/yc с названием unified_agent и тегом latest. Образ содержит бинарный файл с агентом и конфигурационный файл, настраивающий агент для поставки системных метрик Linux в Monium.

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

sudo docker pull cr.yandexcloud.kz/yc/unified-agent:latest

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

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

Скачайте последнюю версию 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-<номер_версии>-<кодовое_имя>. Указывайте значение точно так, как оно используется в имени каталога пакета:
- 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 и ниже.

Если вы не знаете точное значение ubuntu_name, выведите список доступных вариантов для последней версии Unified Agent:
```
ua_version=$(curl --silent https://storage.yandexcloud.kz/yc-unified-agent/latest-version)
aws s3 ls s3://yc-unified-agent/releases/${ua_version}/deb/ \
  --endpoint-url https://storage.yandexcloud.kz \
  --no-sign-request | awk '{print $2}' | tr -d '/'
```
Также вы можете скачать определенную версию Unified Agent. Для этого посмотрите список доступных версий и укажите нужную вместо значения latest-version:
```
curl --silent https://storage.yandexcloud.kz/yc-unified-agent/all-versions
```
Посмотрите версию скачанного deb-пакета с помощью команды ls.

Результат:
```
yandex-unified-agent_<версия>_amd64.deb
```
Где <версия> — версия скачанного deb-пакета, например 24.12.01.
Для установки скачанного deb-пакета выполните команду:
```
sudo dpkg -i yandex-unified-agent_<версия>_amd64.deb
```

Чтобы убедиться, что 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

Важно

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

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

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

Дополнительно можно настроить поставку собственных метрик или логов в Monium Logs.
Конфигурация системы инициализации, добавление нового сервиса 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. В конфигурации настроена отправка базовых метрик виртуальной машины и метрик здоровья агента. Отправка метрик тарифицируется.

Дополнительно можно настроить поставку собственных метрик или логов в Monium Logs.
Конфигурация системы инициализации, добавление нового сервиса unified-agent. Сервис запускается при старте системы.
Создание пользователя unified_agent с uid 1515 и одноименной группы с gid 1515.

Если данные uid или gid недоступны (заняты), пользователь и группа создаются без указания явного uid и gid.
Создание и настройка доступа к директории для пользовательской конфигурации /etc/yandex/unified_agent/conf.d.
Создание и настройка доступа к директории для пользовательского хранилища /var/lib/yandex/unified_agent.

Важно

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

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

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

Обновление

Обновите Unified Agent одним из способов:

Docker-образ

deb-пакет

Бинарный файл

При создании ВМ

Остановите контейнер ua:
```
sudo docker stop ua
```
Удалите контейнер:
```
sudo docker rm ua
```
Запустите контейнер.

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

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

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

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'

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

Важно

В файле конфигурации замените URL monitoring.api.cloud.yandex.net на monitoring.api.yandexcloud.kz.
Переместите скачанный файл в папку /bin/unified_agent.
Перезапустите агент.

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

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

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

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

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'

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

Важно

В файле конфигурации замените URL monitoring.api.cloud.yandex.net на monitoring.api.yandexcloud.kz.
Переместите скачанный файл в папку /bin/unified_agent.
Перезапустите агент.

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

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

Пример установки и настройки

В данном примере Unified Agent будет установлен из deb-пакета и настроен для сбора метрик.

Чтобы установить и настроить Unified Agent на виртуальной машине, выполните следующие шаги:

Создайте сервисный аккаунт в каталоге, куда будут записываться метрики, и назначьте ему роль monitoring.editor.
Создайте виртуальную машину, в блоке Дополнительно выберите сервисный аккаунт, созданный на предыдущем шаге.
Подключитесь к ВМ по SSH.

Установите Unified Agent:

Получите права суперпользователя:
```
sudo -i
```

Скачайте deb-пакет с последней версией Unified Agent для вашей ОС (например, ubuntu-22.04-jammy):

ubuntu_name="ubuntu-22.04-jammy"
ua_version=$(curl -s https://storage.yandexcloud.kz/yc-unified-agent/latest-version) bash -c 'curl -s -O https://storage.yandexcloud.kz/yc-unified-agent/releases/${ua_version}/deb/${ubuntu_name}/yandex-unified-agent_${ua_version}_amd64.deb'

Команда найдет последнюю версию Unified Agent и скачает deb-пакет на ВМ.

Установите версию Unified Agent из скачанного пакета (например, 24.07.02):
```
dpkg -i yandex-unified-agent_24.07.02_amd64.deb
```

Проверьте статус Unified Agent:

systemctl status unified-agent.service

Результат

unified-agent.service - Yandex Unified Agent service
   Loaded: loaded (/usr/lib/systemd/system/unified-agent.service; enabled; preset: enabled)
   Active: active (running) since Mon 2024-08-19 17:32:24 UTC; 1min 49s ago
 Main PID: 7106 (unified_agent)
    Tasks: 7 (limit: 2275)
   Memory: 3.6M (peak: 3.9M)
      CPU: 19ms
   CGroup: /system.slice/unified-agent.service
           └─7106 /usr/bin/unified_agent --config /etc/yandex/unified_agent/config.yml --log-priority NOTICE
            CGroup: /system.slice/unified-agent.service

Aug 19 17:32:24 ua-test-vm systemd[1]: Started unified-agent.service - Yandex Unified Agent service.
Aug 19 17:32:24 ua-test-vm unified_agent[7106]: 2024-08-19T17:32:24.815279Z 7106 15778840110569512124 NOTICE agent starting, revision [14433827]
Aug 19 17:32:24 ua-test-vm unified_agent[7106]: 2024-08-19T17:32:24.815307Z 7106  15778840110569512124 NOTICE agent monitoring service [:16300]
Aug 19 17:32:24 ua-test-vm unified_agent[7106]: 2024-08-19T17:32:24.815632Z 7106 15778840110569512124 NOTICE agent status service [localhost:16301]
Aug 19 17:32:24 ua-test-vm unified_agent[7106]: 2024-08-19T17:32:24.816002Z 7106  15778840110569512124 NOTICE agent started

Настройте Unified Agent:

Откройте конфигурационный файл Unified Agent:
```
vim /etc/yandex/unified_agent/config.yml
```

Добавьте в конфигурационный файл настройки для сбора метрик. Итоговый файл должен выглядеть следующим образом:

monitoring:
  port: 16300

status:
  port: 16301

channels:
  - name: yc_metrics_channel
    channel:
      output:
        plugin: yc_metrics
        config:
          folder_id: "a1bs81qpemb4********"
          iam:
            cloud_meta: {}

routes:
  - input:
      id: linux_metrics_input
      plugin: linux_metrics
      config:
        poll_period: 60s
    channel:
      channel_ref:
        name: yc_metrics_channel

import:
  - /etc/yandex/unified_agent/conf.d/*.yml

Перезапустите Unified Agent:

systemctl restart unified-agent.service

Проверьте статус Unified Agent:
```
systemctl status unified-agent.service
```

Проверьте собираемые метрики:

Консоль управления

В консоли управления выберите каталог, в который собираются метрики.
Перейдите в сервис Monium.
На панели слева выберите Метрики.
В редакторе запроса в строке с именем нужного облака и каталога выберите:
- service = custom;
- cluster = default;
- name = memory.Active;
- host = <имя_ВМ>.
Нажмите Выполнить запрос.
На появившемся графике отобразятся метрики, которые собирает Unified Agent.

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

Список поддерживаемых операционных систем

Подготовка к установке

Установка

Обновление

Пример установки и настройки

Что дальше

Была ли статья полезна?

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

Список поддерживаемых операционных системСписок поддерживаемых операционных систем

Подготовка к установкеПодготовка к установке

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

ОбновлениеОбновление

Пример установки и настройкиПример установки и настройки

Что дальшеЧто дальше

Была ли статья полезна?

Список поддерживаемых операционных систем

Подготовка к установке

Установка

Обновление

Пример установки и настройки

Что дальше