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:

• напрямую через API;
• через сторонний коллектор логов типа Vector или Filebeat.

Подробнее о загрузке логов см. в статье 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>.

Компоненты

Добавлена группировка компонентов на карте

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

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

Подробнее о функционале см. в статье Карты компонентов.

Добавлены горячие клавиши

На карте компонентов добавлены горячие клавиши для отмены и повтора действий на карте.

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

Добавлено создание карты компонентов на основе трейсов

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

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

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

Подробнее о функционале см. в статье Карты компонентов.

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

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

1. На карте нажмите на связь между компонентами, чтобы отобразить список операций по ней:

   

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

   

3. Выберите трейс, чтобы перейти в форму просмотра деталей трейса.

Временно отключено отображение метрик на карте

В связи с упрощением архитектуры временно отключено отображение RED-метрик для связей и операций на карте.

Grafana

Поддержано обновление версии Grafana

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