Simple Mode: Настройка генерации модели

Оглавление

• Общее описание
• 1. Выбор активов для связей
• 2. Настройка метрик модели
• 3. Удаление циклических зависимостей
• 4. Периодичность запуска модели

---

Общее описание

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

---

1. Выбор активов для связей

Цель этого шага - выбрать источники данных (активы) и выстроить их в последовательность, которая определит, как данные будут загружаться и связываться между собой.

Интерфейс выбора активов

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

Последовательность активов

Настроить последовательность можно двумя способами: вручную (пошаговое построение) или автоматически (расчет путей системой).

Ручное построение (пошаговое)

Действие	Результат
1. Кликните на первый актив	Становится корневым узлом дерева
2. Кликните на второй актив	Становится дочерним по отношению к первому
3. Кликните на последующие активы	Каждый новый актив привязывается к предыдущему
4. Подтвердите последовательность нажав на галочку	Последовательность будет внесена в панель Настройка генерации модели

Информация

Порядок добавления определяет вложенность: родитель - дочерний элемент. Не исключена возможность формировать несколько независимых деревьев.

Автоматический расчет путей (от начала к концу)

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

Действие	Результат
1. Кликните на начальный актив	Становится корневым узлом дерева
2. Кликните на конечный актив	Актив помечается как конечная точка
3. Система автоматически находит все возможные пути от начала до конца	Построение маршрутов с учетом связей между активами
4. Подтвердите последовательность нажав на галочку	Последовательность будет внесена в панель Настройка генерации модели. Промежуточные активы автоматически скрываются

Редактирование последовательности

После подтверждения выбора откроется панель Настройка генерации модели, где можно управлять последовательностью.

Действие	Описание
Удалить узел	Убрать ненужные узлы из последовательности
Удалить последовательность	Убрать всю последовательность с панели
Скрыть узел	Узел не отображается на визуализации, но участвует в расчёте данных для дочерних узлов

Модель здоровья

Панель Модель здоровья - располагается параллельно области выбора активов.

После настройки и подтверждения последовательности активов в данной области автоматически отображается модель здоровья. Это позволяет наглядно проверить корректность построенной последовательности перед переходом к следующему шагу.

---

2. Настройка метрик модели

Цель этого шага - определить шаблон метрик: какие показатели будут собираться для сервисов, откуда их брать и как агрегировать. Шаблон применяется ко всем сервисам автоматически. Для каждого сервиса система подставит его собственные значения (через {{ ... }}) и сформирует метрики по заданным правилам.

Описание

Метрики - это показатели, которые характеризуют состояние сервиса (например, загрузка CPU, количество запросов, время ответа).

На этом шаге выполняется привязка глобальных метрик (из системы мониторинга МАЯК) к сервисам, а также настройка способа их расчета.

Структура сервиса

В верхней части отображается блок Структура сервиса - это список ранее настроенных сервисов, для которых будут собираться метрики.

Настройка параметров

Параметр	Что определяет	Пример
Метрики Маяка	Глобальная метрика, доступная для привязки	cpu_usage, request_duration
Название метрики сервиса	Шаблон имени метрики для конкретного сервиса	{{ service.name }}_cpu
Описание	Пояснение, что показывает метрика и как рассчитывается	Загрузка CPU в процентах
Группы фильтров	Фильтрация объектов метрики по глобальным измерениям (выбор показателей из общего пулла)	namespace = {{ service.namespace }}
Функция определения общего состояния	Способ объединения показателей в одну метрику сервиса	avg, min, max

Последовательность действий

Для создания новой метрики:

1. Нажать + Добавить структуру метрики
2. Выбрать Метрику Маяка из выпадающего списка
3. В поле Название метрики сервиса ввести шаблон с использованием {{ ... }}
4. Заполнить Описание (рекомендуется)
5. В блоке Группы фильтров добавить условия фильтрации
6. Выбрать Функцию агрегации (avg, min или max)

Для редактирования метрики:

1. Нажать на блок метрики
2. Изменить нужные параметры
3. Изменения сохраняются автоматически

Для удаления метрики:

• нажать на иконку корзины в блоке метрики

Принцип работы фильтров

Глобальная метрика может содержать данные для множества объектов. Фильтры позволяют выбрать только те данные, которые относятся к конкретному сервису.

Пример: глобальная метрика cpu_usage имеет измерения: service_name, pod, namespace.

Чтобы привязать ее к сервису payment:

Параметр	Значение
Метрика Маяка	cpu_usage
Группы фильтров	service_name = "payment"
Название метрики сервиса	{{ service.name }}_cpu_usage

Информация

Синтаксис ссылок: {{ название_узла.поле }}.

Функции агрегации

Когда по фильтрам найдено несколько значений метрики (например, несколько подов сервиса), их нужно объединить в одну метрику сервиса.

Функция	Что делает	Пример использования
avg	Среднее арифметическое	Средняя загрузка CPU по всем подам
min	Минимальное значение	Самая низкая загрузка (для выявления простаивающих подов)
max	Максимальное значение	Пиковая загрузка (для выявления перегруженных подов)

---

3. Удаление циклических зависимостей

Задача этого шага - устранить зацикленные связи, которые могут возникнуть из-за сложной структуры данных и привести к некорректной работе модели.

Последовательность действий

Автоматическое удаление:

1. Нажать кнопку Удалить все циклы (n), где n - количество найденных циклов
2. Система автоматически найдет и удалит все циклические зависимости

Ручное удаление:

1. В интерфейсе найти проблемную связь (обычно она подсвечивается)
2. Нажать на иконку корзины рядом с зависимостью

---

4. Периодичность запуска модели

Задача этого шага - настроить расписание, по которому модель будет автоматически пересчитываться.

Типы расписания

Тип	Описание	Пример
Cron-выражение	Гибкая настройка через стандартный cron-синтаксис	*/5 * * * * - каждые 5 минут
Интервал	Простой выбор: время начала/интервал/единицы	01/01/2026 / 20 / дни