Узнать, когда бюджет, пул или трафик пересекли черту
Читайте ленту оповещений, принимайте их и пишите правила, которые решают, о чём Slen вам сообщает.
5 мин чтения
Оповещение — это сообщение о том, что условие, для которого вы задали правило, выполнилось. Эта страница — о странице оповещений в консоли: о ленте оповещений и правилах, которые за ней стоят.
Где находятся оповещения
Откройте Оповещения. На странице две вкладки. Лента — это то, что выполнилось, а Правила — то, о чём вы просили сообщать. Обе показывают проект, выбранный в шапке, вместе с тем, что принадлежит всей организации.
Лента открывается тому, у кого есть разрешение read, а оно есть у каждой роли. Для вкладки Правила нужно management:read, а для изменения правила — management:write. Правило всей организации меняет только участник, которому доступен каждый проект.
Как появляется оповещение
Slen проверяет активные правила раз в минуту. Без правила ничего не отслеживается.
Когда условие правила выполняется, а открытого оповещения у правила нет, открывается оповещение.
Пока условие выполняется, то же оповещение остаётся открытым, и каждая проверка обновляет его серьёзность и числа. У правила бывает не больше одного открытого оповещения.
Когда условие перестаёт выполняться, оповещение закрывается. Кнопки, которая закрывает оповещение, нет: его закрывает и приостановка или удаление правила.
Об этих изменениях сообщают вебхуки и уведомления. Вебхук получает событие alert.opened, когда оповещение открывается, и alert.resolved, когда оно закрывается, а изменение серьёзности открытого оповещения событий ему не отправляет. Уведомления сообщают людям то же самое в почте, Telegram, Slack, Microsoft Teams или Discord и ещё говорят им, когда открытое оповещение становится критичным.
Прочитать ленту
Строка ленты говорит одним предложением, что произошло. Под ним стоят серьёзность — Предупреждение или Критично, тип правила, проект, которого касается оповещение, — или Вся организация, когда оно не касается одного проекта, — время и числа, которые стоят за предложением.
Только открытые включено, когда страница открывается. Выключите его, чтобы видеть и закрытые оповещения.
Принять записывает, что вы видели оповещение, и когда. Оповещение от этого не закрывается и по-прежнему закрывается, когда кончается его условие.
Лента сама не обновляется. Нажмите Обновить, чтобы прочитать её заново.
Типы правил
| Тип | Оповещение открывается, когда | Оно критично, когда |
|---|---|---|
| Порог бюджета | Бюджет использовал пороговую долю своего лимита или больше. Зарезервированное считается использованным, как и списанное | Бюджет израсходован полностью |
| Необычные расходы | Расход текущего часа равен среднему расходу предыдущих часов, умноженному на множитель, или больше | Никогда |
| Ёмкость пула | Доля исправных подключений пула ниже минимума | Ни одно подключение пула не исправно |
| Всплеск ограничений | Провайдеры ответили ограничением частоты заданное число раз за окно или больше | Никогда |
| Всплеск ошибок | Заданная доля попыток за окно завершилась ошибкой, или больше | Ошибкой завершилась хотя бы половина попыток |
| Падение попаданий в кэш | Доля запросов, на которые ответил кеш, за окно ниже минимума | Никогда |
| Превышение удержаний | Заданная доля холдов, списанных за окно, стоила больше, чем было отложено, или больше | Так было хотя бы с половиной из них |
Правило типа Необычные расходы, Всплеск ошибок, Падение попаданий в кэш или Превышение удержаний молчит, пока данных недостаточно для вывода. У каждого из этих типов среди настроек есть минимум: расхода, запросов или списанных холдов.
Счётчики, на которые опираются правила, ведутся по часам. Окно короче часа оценивается по тому часу, в который оно попадает.
Написать правило
1. Начните новое правило
На вкладке Правила нажмите Новое правило.
2. Назовите правило
Заполните Название. По названию правила отличают друг от друга в списке.
3. Выберите условие
В поле Условие выберите тип правила.
4. Выберите, за чем оно следит
В поле Следит за выберите Этот проект или Вся организация. Второй вариант предлагается только участнику, которому доступен каждый проект.
Правило всей организации оценивает каждый проект организации по собственным числам этого проекта, а правило типа Ёмкость пула следит за каждым пулом организации — каждым вместе с проектом, которому он принадлежит. Бюджет или пул всей организации оценивается сам по себе, и в его оповещении вместо проекта стоит Вся организация. Открытое оповещение у правила всё равно одно. Оповещение касается того из них, кому хуже всех в момент открытия, и остаётся с ним, пока там выполняется условие. Когда он приходит в норму, а другой всё ещё за чертой, оповещение закрывается и открывается новое — о другом.
5. Задайте числа
Заполните настройки типа. Каждое поле говорит, какой диапазон оно принимает и с какого значения начинает.
6. Создайте правило
Нажмите Создать правило. Правило активно и проверяется в течение минуты.
После создания правила его условие и то, за чем оно следит, изменить нельзя: оповещения, уже заведённые по этому правилу, были о них.
Кому сообщать
В панели правила есть блок Кому сообщать. Добавьте в него каналы команды, роли или участников, и Slen будет сообщать им, когда оповещение правила открывается, становится критичным и закрывается. Блок хранит маршрут уведомлений, привязанный к правилу: первый получатель создаёт его, а удаление последнего удаляет. Без management:write блок доступен только для чтения. Как работает такой маршрут, говорит статья Уведомления.
Приостановить, изменить или удалить правило
В меню в строке правила — три действия.
| Действие | Что оно делает |
|---|---|
| Изменить | Меняет название и настройки |
| Приостановить | Останавливает проверки правила и сохраняет его настройки. Возобновить запускает их снова |
| Удалить | Удаляет правило после подтверждения. Оповещения, которые оно завело, остаются в ленте |
Приостановка или удаление правила сразу закрывает его открытое оповещение, и Slen отправляет alert.resolved. После Возобновить следующая проверка откроет новое оповещение, если условие всё ещё выполняется.
Что читать дальше
Политики — отклонить запрос, а не узнать о нём.
Оповещения — лента через API.
Глоссарий — оповещение и вебхук, по одной строке на каждое.
Бюджеты — потолки, за которыми следит оповещение о бюджете.
Вебхуки — слышать события Slen в вашем сервисе.
Уведомления — сообщать людям об оповещениях в почте, Telegram, Slack, Microsoft Teams и Discord.
Получать события Slen — доставка
alert.openedиalert.resolvedи как проверить её подпись.