Запуск и остановка Yandex Unified Agent
Запуск
Установите 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
Ubuntu 14.04
Чтобы остановить агент, выполните команду:
sudo service unified-agent stop
Чтобы перезапустить агент, выполните команду:
sudo service unified-agent restart
Версии Ubuntu выше 14.04
Чтобы остановить агент, выполните команду:
sudo systemctl stop unified-agent
Чтобы перезапустить агент, выполните команду:
sudo systemctl
-
Узнайте идентификатор процесса
unified_agent:ps aux | grep unified_agent -
Чтобы остановить процесс, выполните команду:
sudo kill <идентификатор_процесса>
-
Узнайте идентификатор процесса
unified_agent:ps aux | grep unified_agent -
Чтобы остановить процесс, выполните команду:
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_CPUUA_LINUX_RESOURCE_MEMORYUA_LINUX_RESOURCE_NETWORKUA_LINUX_RESOURCE_STORAGEUA_LINUX_RESOURCE_IOUA_LINUX_RESOURCE_KERNEL |
basic |
Уровень детализации системных метрик: CPU, сети, дисков, системы ввода-вывода и Linux-ядра. |