Связаться с намиПодключиться

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

Статья создана
Обновлена 15 апреля 2025 г.

Запуск

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

Настройте конфигурационный файл агента, который расположен в /etc/yandex/unified_agent/config.yml и параметризован переменными окружения. Подробнее параметры запуска Docker-контейнера описаны в разделе ниже.

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

sudo docker run \
  -p 16241:16241 -it --detach --uts=host \
  --name=ua \
  -v /proc:/ua_proc \
  -e PROC_DIRECTORY=/ua_proc \
  -e FOLDER_ID=a1bs81qpemb4******** \
  cr.yandex/yc/unified-agent

Где FOLDER_ID – идентификатор каталога, куда будут записываться метрики.

Чтобы запустить контейнер с собственным файлом конфигурации, добавьте в команду запуска контейнера параметр -v, указав полный путь до файла конфигурации. Перед запуском контейнера удалите из вашего конфигурационного файла строки:

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

Пример команды для запуска контейнера с пользовательским конфигурационным файлом:

docker run \
  -p 16241:16241 -it --detach --uts=host \
  --name=ua \
  -v /proc:/ua_proc \
  -v `pwd`/config.yml:/etc/yandex/unified_agent/conf.d/config.yml \
  --entrypoint="" \
  -e PROC_DIRECTORY=/ua_proc \
  -e FOLDER_ID=a1bs81qpemb4******** \
  cr.yandex/yc/unified-agent

По умолчанию в конфигурационном файле агента в секции status указан host: null. Учитывайте это, если используете собственный конфигурационный файл.

Важно

Для мониторинга дополнительных дисков, подключенных к хосту, передайте пути к их точкам монтирования при помощи параметра -v команды docker run. Подробнее читайте в разделе Вход linux_metrics.

Подробнее про конфигурацию агента читайте в разделе Конфигурирование.

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

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

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

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

./unified_agent --config unified_agent.yml

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

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

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

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

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

./unified_agent --config unified_agent.yml

Остановка

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

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

sudo docker stop ua

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

sudo systemctl stop unified-agent

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

sudo systemctl

  1. Узнайте идентификатор процесса unified_agent:

    ps aux | grep unified_agent

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

    sudo kill <идентификатор_процесса>

  1. Узнайте идентификатор процесса unified_agent:

    ps aux | grep unified_agent

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

    sudo kill <идентификатор_процесса>

Для завершения работы Unified Agent может потребоваться некоторое время на допоставку накопленных данных. Обычно это занимает до 2 секунд.

Параметры запуска Docker-контейнера с Unified Agent

Если вы устанавливаете Unified Agent при помощи Docker, вы можете сконфигурировать агент с помощью переменных окружения. Так вам не потребуется редактировать файл конфигурации, расположенный в /etc/yandex/unified_agent/config.yml. Список переменных окружения перечислен в таблице ниже.

Переменная окружения Значение по умолчанию Описание
UA_STATUS_PORT 16241 Порт, по которому будет доступен статус работы агента.
UA_LOG_PRIORITY NOTICE Уровень логирования работы агента.
FOLDER_ID Нет Идентификатор каталога, куда будут записываться метрики (обязательный параметр).
PROC_DIRECTORY /proc Директория со смонтированным procfs, откуда агент будет получать системные Linux-метрики.
SYS_DIRECTORY /sys Директория со смонтированным sysfs, откуда агент будет получать системные Linux-метрики.
UA_LINUX_RESOURCE_CPU
UA_LINUX_RESOURCE_MEMORY
UA_LINUX_RESOURCE_NETWORK
UA_LINUX_RESOURCE_STORAGE
UA_LINUX_RESOURCE_IO
UA_LINUX_RESOURCE_KERNEL		 basic Уровень детализации системных метрик: CPU, сети, дисков, системы ввода-вывода и Linux-ядра.

Что дальше

Предыдущая
Установка и обновление
Следующая
Обзор