Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Monitoring
  • Начало работы
    • Обзор
    • Установка и обновление
    • Запуск и остановка
    • Рекомендации по использованию агента
    • Возможные ошибки
    • Удаление
  • Управление доступом
  • Справочник Terraform
  • История изменений
  • Обучающие курсы

В этой статье:

  • Основные понятия
  • Схема работы Unified Agent
  • Сообщения
  • Сессии
  • Входы
  • Выходы
  • Фильтры
  • Хранилища
  • Маршрутизация
  • Цепочки преобразований
  • Каналы
  • Маршруты доставки
  1. Агент сбора метрик
  2. Обзор

Агент для поставки метрик

Статья создана
Yandex Cloud
Обновлена 10 марта 2025 г.
  • Основные понятия
  • Схема работы Unified Agent
  • Сообщения
  • Сессии
  • Входы
  • Выходы
  • Фильтры
  • Хранилища
  • Маршрутизация
    • Цепочки преобразований
    • Каналы
    • Маршруты доставки

Смотреть видео на YouTube.

Yandex Unified Agent — агент для поставки дополнительных метрик виртуальных машин и пользовательских приложений в сервис Yandex Monitoring.

Агент поддерживает:

  • сбор системных метрик Linux (процессор, память, диск);
  • сбор метрик в формате Prometheus;
  • поставку метрик в Yandex Monitoring;
  • файловое хранилище для надежной доставки данных.

Примеры использования агента приведены в разделе Работа с метриками. Подробнее про способы установки Unified Agent читайте в разделе Установка и обновление Yandex Unified Agent. Синтаксис файла конфигурации агента описан в разделе Конфигурирование.

Основные понятияОсновные понятия

Yandex Unified Agent предназначен для передачи потоковых данных, представленных в виде сообщений, например, метрик или логов. Поток данных в Unified Agent называется сессией. Одновременно может быть установлено множество сессий.

Агент получает сообщения через вход и отправляет их в один или несколько выходов. Для промежуточной обработки сообщений существуют фильтры, а для сохранения на диск — хранилища. Входы, выходы, фильтры и хранилища реализуются при помощи плагинов.

Для маршрутизации сообщений существуют маршруты доставки, состоящие из входа и канала. Канал состоит из цепочки преобразований и узла одного из типов: выход, канал или разветвитель. Цепочка преобразований может содержать фильтры и ссылки на хранилища. Цепочка преобразований может отсутствовать.

Вы можете создавать именованные каналы и цепочки обработки. Это позволит избежать дублирования конфигурации и направить сообщения из многих входов в один выход.

Схема работы Unified AgentСхема работы Unified Agent

СообщенияСообщения

Сообщение — это минимальная неделимая единица пользовательской информации, которая передается от системы или приложения в Unified Agent.

Сообщение состоит из тела, временной метки, пользовательских метаданных в формате ключ:значение и порядкового номера.

Примечание

Для правильной агрегации данных в мониторинге целочисленные метрики COUNTER при загрузке в Monitoring переводятся в DGAUGE.

СессииСессии

Сессия — это упорядоченный поток сообщений. Сессия имеет идентификатор, который должен быть уникальным среди всех установленных сессий, и пользовательские метаданные в формате ключ:значение.

Все сообщения, переданные в рамках сессии, содержат как метаданные сообщения, так и метаданные сессии.

Виды собираемой информации (входы), преобразование (фильтры), место для промежуточного хранения (хранилище) и выходы задаются в файле конфигурации Unified Agent.

ВходыВходы

Вход предназначен для получения агентом сообщений, которые передаются в рамках сессий. Вход может содержать настройки инфраструктуры работы с сессиями для конфигурирования различных ограничений.

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

ВыходыВыходы

Выход предназначен для отправки агентом сообщений в сторонние системы. В настоящий момент поддерживается выход yc_metrics для записи метрики в Yandex Monitoring API, а также несколько отладочных выходов.

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

ФильтрыФильтры

Фильтр предназначен для отбрасывания, преобразования и агрегации сообщений.

Типы фильтров:

  • обычные — работают с каждым сообщением в отдельности;
  • накопительные — преобразуют набор входных сообщений в одно выходное.

См. также список реализованных фильтров.

ХранилищаХранилища

Хранилища предназначены для промежуточного хранения сообщений от поступления на вход и до передачи на выход.
Используя хранилище, вы не потеряете данные, если агенту не удалось записать их в указанный выход. Например, из-за сетевых проблем или недоступности API, куда отправляются сообщения.

См. также конфигурирование хранилищ.

МаршрутизацияМаршрутизация

Цепочки преобразованийЦепочки преобразований

Цепочки преобразований содержат:

  • набор фильтров, через которые последовательно проходят сообщения;
  • ссылку на хранилище, где будут храниться сообщения до передачи на выход.

Цепочки преобразований можно делать именованными.

См. также конфигурирование цепочек преобразований.

КаналыКаналы

Каналы группируют цепочку преобразований и один из узлов: выход, именованный канал или разветвитель.

Разветвитель позволяет указать набор каналов и копирует поступающее в него сообщение в каждый из своих каналов. При помощи разветвителя можно продублировать потоки в разные выходы, а комбинируя разветвители и фильтры, можно направлять разные сообщения в разные каналы по некоторым признакам, например, по метаданным.

Каналы можно делать именованными.

См. также конфигурирование именованных каналов.

Маршруты доставкиМаршруты доставки

Маршрут доставки объединяет вход и канал.

Маршруты доставки, каналы и цепочки обработки позволяют сконфигурировать произвольное дерево обработки сообщений.

Взаимосвязь элементов дерева обработки сообщений представлена на схеме.

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

Предыдущая
Удаление алерта
Следующая
Установка и обновление
Проект Яндекса
© 2025 ООО «Яндекс.Облако»