Установка и запуск Yandex Unified Agent

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

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

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

   ubuntu_name="ubuntu-22.04-jammy" 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-trusty;
   • ubuntu-16.04-xenial;
   • ubuntu-18.04-bionic;
   • ubuntu-20.04-focal;
   • ubuntu-22.04-jammy, начиная с версии 23.03.02.

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

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

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

3. Установите deb-пакет:

   sudo dpkg -i yandex-unified-agent_24.09.03_amd64.deb
   

Чтобы убедиться, что Unified Agent успешно установлен и запущен, выполните команду systemctl status unified-agent. Пример работы команды:

user@my-vm:~$ 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 Tue 2021-02-09 15:57:08 UTC; 2 weeks 2 days ago
 Main PID: 141403 (unified_agent)
    Tasks: 8 (limit: 507)
   Memory: 9.4M
   CGroup: /system.slice/unified-agent.service
           └─141403 /usr/bin/unified_agent --config /etc/yandex/unified_agent/config.yml --log-priority NOTICE

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

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'

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

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

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

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

./unified_agent --config unified_agent.yml

Где --config – путь до конфигурационного файла.

Вы можете установить Unified Agent при создании виртуальной машины в консоли управления, через CLI, API или Terraform.

Чтобы установить агент из консоли управления, в блоке Мониторинг включите опцию Агент сбора метрик.

Чтобы установить агент через CLI или API, укажите в пользовательских метаданных (user-data) строку:

#cloud-config\nruncmd:\n  - wget -O - https://monitoring.api.cloud.yandex.net/monitoring/v2/unifiedAgent/config/install.sh | bash

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

resource "yandex_compute_instance" "this" {
...
resources {
  ...
}

...

metadata = {
  ssh-keys = "<имя_пользователя>:<содержимое_SSH-ключа>",
  "install-unified-agent": "1"
}
}

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

Агент устанавливается с файлом конфигурации по умолчанию, который находится в /etc/yandex/unified_agent/config.yml.

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

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

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

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