Изменение пороговых значений и отключение проверок
Каждая проверка начинается с базового уровня из своей записи в каталоге. Вы изменяете его там, где это имеет смысл: в сущности, чтобы ему следовали все ресурсы ниже нее, или в отдельном ресурсе, который является исключением. В этом руководстве показаны оба способа, а также возврат к унаследованным значениям и отключение проверки или одного из ее уровней.
Перед началом работы
- Чтобы изменить проверку для одного ресурса, вам нужна роль Editor (редактор) или выше в сущности этого ресурса.
- Чтобы задать значение по умолчанию для сущности, вам нужна роль Entity admin (администратор сущности) в этой сущности.
- Учитывайте, откуда берутся значения: базовый уровень, затем каждая сущность от корня вниз, затем ресурс. Побеждает наиболее конкретное значение. См. статью Пороговые значения и базовые уровни.
Задавайте значения как можно выше в дереве и переопределяйте только исключения. Значение по умолчанию, заданное один раз для ООО «Лукоморье» › Production, распространяется на все серверы, которые будут добавлены туда позже.
Как задается уровень
У каждой проверки есть уровень Warning (предупреждение) и уровень Critical (критическое состояние). Каждый уровень состоит из следующих частей.
| Часть | Значения |
|---|---|
| Operator | >, >=, <, <=, ==, !=, in, not_in, matches |
| Value | Число в единицах измерения проверки, которые показаны рядом с полем, или список для in и not_in |
| For | Необязательно. Сколько времени условие должно сохраняться, прежде чем откроется оповещение, например 30s, 15m, 1h или 1d. Это сглаживает кратковременные всплески; восстановление фиксируется сразу |
Некоторые проверки сравнивают состояния, а не значение с пределами, например работоспособность реплики группы доступности. Их правила берутся из каталога, и редактор сообщает об этом вместо отображения уровней.
Изменение порогового значения для одного ресурса
- Откройте ресурс и выберите вкладку Checks. Чтобы найти проверку, используйте Search checks или Only problems.
- Выберите значок карандаша Edit в строке проверки. В диалоговом окне отображаются идентификатор проверки, ее базовый уровень и текущие уровни.
- Для каждого уровня, который нужно изменить, оставьте выбранным This level raises alerts и введите Operator, Value и при необходимости For. Например, для проверки Page life expectancy (
sqlserver.ple_seconds) наsql-ventas-01задайте для Warning level значение<900в течение10m. - Выберите Save.
Теперь в строке отображаются новые уровни с пометкой (this resource). Уровни, которые вы не меняли, сохраняют унаследованные значения.
Чтобы вернуться к унаследованным значениям, снова откройте диалоговое окно и выберите Back to inherited thresholds. Эта кнопка появляется, только если у ресурса есть собственные значения.
Значение по умолчанию для сущности
- Откройте Settings › Entities.
- Откройте меню действий сущности, например Production, и выберите Threshold defaults. На панели перечислены проверки, которые эта сущность задает сама; все остальные она наследует.
- В разделе Set a default for a check выберите проверку, например CPU utilization (SQL process) (
sqlserver.cpu_percent), и выберите Add. - Для каждого уровня выберите один из вариантов:
- Inherit: сохранить значение, поступающее сверху.
- Set here: введите Operator, Value и For, например
>75в течение15m. - Turn off here: этот уровень не создает оповещений в этой сущности и ниже.
- Выберите Save.
Теперь все ресурсы ниже сущности используют это значение по умолчанию, если его не изменяет сущность ниже или сам ресурс. На вкладке Checks каждого ресурса для уровня указана сущность, от которой он получен.
Чтобы удалить значение по умолчанию, выберите значок корзины рядом с ним — Remove the default of для этой проверки. После этого ресурсы ниже снова наследуют значение от вышестоящих сущностей.
Отключение проверки
Для одного ресурса откройте вкладку Checks и отключите проверку в столбце On или снимите флажок Check runs в диалоговом окне проверки. Проверка перестает выполняться для этого ресурса и отображается как Off, чтобы никто не забыл о ее существовании. Включите ее снова тем же способом.
Чтобы проверка не создавала оповещений во всей сущности, откройте ее Threshold defaults, добавьте проверку и задайте для Warning level и Critical level значение Turn off here. Проверка продолжает выполняться и записывать значения для всех ресурсов ниже, но не создает там оповещений. Используйте этот способ для проверок, которые не имеют смысла в ветви, например для проверок сервера отчетов там, где сервера отчетов нет.
Изменение частоты выполнения проверки
В диалоговом окне проверки введите Interval от 10s до 7d, например 30s, 5m или 1h. Оставьте поле пустым, чтобы использовать интервал из каталога, который показан в поле. Измененный интервал отмечается в строке как changed.
Выполнение через API
Каждое изменение через API подчиняется тем же ролям и записывается в журнал аудита. $BASE — это https://<your server>/api/v1, а H содержит ваш токен; см. статью Краткое руководство. Добавление экземпляра SQL Server с помощью API.
| Задача | Запрос |
|---|---|
| Просмотр действующих уровней и их источников | GET /resources/{id}/checks |
| Задание уровней для одного ресурса | PATCH /resources/{id}/checks/{check_id} с thresholds |
| Возврат к унаследованным уровням | Тот же PATCH с "thresholds": null |
| Отключение или включение проверки | Тот же PATCH с "enabled": false или true |
| Изменение интервала | Тот же PATCH с "interval_seconds" от 10 до 604800 |
| Просмотр собственных значений по умолчанию сущности | GET /entities/{id}/thresholds |
| Задание значения по умолчанию для сущности | PUT /entities/{id}/thresholds/{check_id} |
| Удаление значения по умолчанию сущности | DELETE /entities/{id}/thresholds/{check_id} |
Переопределение уровня может содержать ключи warn, crit, expect, window и sigma. Ключ со значением null отключает эту часть на данном уровне.
# one resource: warn when page life expectancy stays under 900 s for 10 minutes
curl -s "${H[@]}" -X PATCH "$BASE/resources/$SQL01/checks/sqlserver.ple_seconds" \
-d '{"thresholds": {"warn": {"op": "<", "value": 900, "for": "10m"}}}' | jq .thresholds
# the Production entity: CPU warning above 75% for 15 minutes, no critical level
curl -s "${H[@]}" -X PUT "$BASE/entities/$PROD/thresholds/sqlserver.cpu_percent" \
-d '{"warn": {"op": ">", "value": 75, "for": "15m"}, "crit": null}'