Release Notes v1.12
Основные улучшения
- Загрузка данных — добавлена автоматическая инструментация для оптимизации загрузки и мониторинга данных с помощью Sage Agent.
- Метрики — добавлена ручная настройка коллекций таргетов.
- Логи — обеспечено соответствие требованиям безопасности:
- появилась возможность загрузки логов с авторизацией через Logs Collector;
- добавлены аудит-логи для отслеживания событий безопасности.
- Алерты — улучшен пользовательский опыт при работе с алертами:
- добавлена возможность настройки оповещений на несколько адресов для JavaScript-алертов;
- добавлено оповещение о восстановлении системы;
- добавлено включение созданных алертов по умолчанию;
- исправлено фоматирование сообщений в формате HTML в оповещениях с типом адреса Email.
- Компоненты — улучшен пользовательский опыт при работе с картами компонентов:
- добавлена возможность группровать сервисы на карте;
- добавлены горячие клавиши для работы с картами;
- добавлена возможность создания карты на основе трейсов;
- добавлен переход из карты компонентов к деталям трейса.
- Grafana — поддержана возможность обновить версию Grafana.
Загрузка данных
Добавлена автоматическая инструментация для Sage Agent
Для Sage Agent поддержана автоматическая инструментация eBPF, которая позволяет собирать телеметрию без изменений в коде приложения и его конфигурации.
Технология анализирует испол няемые файлы приложений и сетевой слой операционной системы и собирает трейсы, связанные с веб-запросами, а также RED-метрики (Rate, Error, Duration) для HTTP/gRPC-сервисов.
Пример дашборда с метриками, собранными с помощью автоматической инструментации:

Подробнее о том, как настроить автоматическую инструментация в Sage Agent, см. в статье Sage Agent (alpha).
Метрики
Добавлена ручная настройка коллекций таргетов
Появилась возможнос ть вручную создавать коллекции таргетов в интерфейсе Sage. Ранее пользователь мог только просматривать и фильтровать список зарегистрированных таргетов для загрузки метрик, без возможности их группировки.
С помощью коллекций вы теперь можете группировать таргеты и задавать общие статичные лейблы и правила переименования сразу для всех таргетов в коллекции.
Подробнее о функционале см. в статье Таргеты для скрейпинга.
Логи
Поддержана загрузка логов с авторизацией
Для соответствия требованиям безопасности поддержана загрузка логов с авторизацией. Для безопасной загрузки логов вы можете настроить интеграцию с сервисом Logs Collector:
Подробнее о загрузке логов см. в статье Logs Collector.
Добавлены аудит-логи
Для повышения прозрачности операций и соответствия требованиям безопасности в Sage добавлены аудит-логи, позволяющие отслеживать действия пользователей и изменения конфигураций в системе.
Для удобства анализа аудит-логи имеют структурированный формат и содержат всю необходимую информацию для расследования инцидентов безопасности.
Аутентификация и доступы:
- вхо ды и выходы пользователей в системе Spirit IAM,
- выдача и изменение прав доступа.
Управление ресурсами:
- операции с тенантами (агрегаторами ресурсов),
- управление сервисными учетными записями.
Действия в Sage:
- изменения сущностей (группы, дата-центры, квоты);
- операции с алертами, справочниками, конфигурациями;
- управление адресами, правилами и токенами.
Для того, чтобы найти аудит-логи по вашей группе, укажите поле securityEvent=true в строке поиска, например:
group="sage" securityEvent=true
Для просмотра аудит-логов по компонентам Spirit IAM выполните запрос:
group="sage" extra.audience="audit"
Подробнее в разделе Аудит логи
Алерты
Добавлена поддержка массива адресов в sendAlert
Для JavaScript-алертов в функции sendAlert добавлена возможность указывать сразу несколько адресов, на которые будет отправлен алерт. Это упрощает настройку JavaScript-алертов и позволяет одновременно уведомлять несколько получателей без дублирования логики.
Пример использования функции sendAlert с указанием нескольких адресов:
await sendAlert({
address: ["oncall:Sage", "oncall:DevOps"],
message: ":Мало сообщений уровня `INFO` за последние " + query_start_minutes + " минут."
cooldownKey: "sage_common",
cooldownDuration: 30*60,
});
Подробнее о параметрах функции sendAlert см. в статье Алерты JavaScript Git.
Добавлено оповещение о восстановлении системы
Поддержаны уведомления о восстановлении системы после завершения инцидента. Ранее оповещения отправлялись только при возникновении алерта (инцидента).
Отправка уведомлений о восстановлении включается в параметрах Настройки уведомлений алерта:

В настоящий момент отправка оповещений о восстановлении доступна только для типов адресов Email и Time.
Подробнее о настройке оповещения о восстановлении см. в статье Алерты MageQL → Шаг 4. Задайте условия доставки.
Подробнее о шаблонизации в оповещении о восстановлении см. в статье Алерты YAML Git.
Изменено состояние алертов при создании
Изменено поведение переключателя Включен в форме создания алерта в интерфейсе Sage.
Теперь по умолчанию созданный алерт активируется автоматически. Ранее пользователю приходилось вручную активировать алерт, что могло приводить к ситуациям, когда алерт оставался выключенным и не выполнял мониторинг.

Подробнее о параметре см. в статьях Алерты MageQL и Алерты JavaScript.
Исправлено форматирование сообщений
В оповещениях с типом адреса Email исправлено форматирование сообщения в формате HTML.
Теперь, чтобы сообщение отображалось корректно в формате HTML, необходимо добавить в начало сообщения тег <!DOCTYPE html>.
Компоненты
Добавлена группировка компонентов на карте
Для оптимизации работы с крупными и сложными картами добавлена возможность группировать логически связанные сервисы в блоки.

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

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

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

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

-
Нажмите на операцию из списка, чтобы перейти к списку связанных трейсов:

-
Выберите трейс, чтобы перейти в форму просмотра деталей трейса.
Временно отключено отображение метрик на карте
В связи с упрощением архитектуры временно отключено отображение RED-метрик для связей и операций на карте.
Grafana
Поддержано обновление версии Grafana
Поддержана возможность обновить Grafana версии 9 до версии 11. Более подробную информацию о миграции на новую версию уточняйте у администратора системы или в поддержке. Процедура обновления описана в разделе Upgrade Notes: Обновление Grafana v9 → v11.