annotationsobject
Необязательные аннотации для правила оповещения.
conditionstring
Идентификатор условия запроса, например 'A', 'B' (требуется для 'create', 'update')
dataobject[]
Массив объектов запросов для алертов (обязательно для 'create'/'update'). Каждый объект содержит: datasourceUid (строка, обязательно), model (объект с expr для запросов данных или type/expression/conditions для выражений), refId (строка, назначается автоматически, если не указано), relativeTimeRange ({from, to} в секундах, по умолчанию {from:600,to:0}). Для серверных выражений используйте datasourceUid 'expr'. Пример: [{datasourceUid: 'prometheus', model: {expr: 'up == 0'}}, {datasourceUid: 'expr', model: {type: 'threshold', expression: 'A', conditions: [{evaluator: {type: 'gt', params: [0]}}]}}]
datasource_uidstring
Необязательно: UID источника данных Prometheus или Loki, чтобы запросить правила оповещений, управляемые источником данных (для операции 'list').
disable_provenanceboolean
Если true, оповещение остаётся редактируемым в интерфейсе Grafana (устанавливает заголовок X-Disable-Provenance). По умолчанию — true.
exec_err_statestring
Состояние при ошибке выполнения: NoData, Alerting, OK (обязательно для 'create', 'update')
folder_uidstring
Идентификатор папки. Для 'list': фильтрация по точному идентификатору папки (взаимоисключающе с search_folder). Для 'create'/'update': папка, в которой хранится правило (обязательно).
forstring
Продолжительность до срабатывания оповещения, например '5m' (обязательно для 'create', 'update')
is_pausedboolean
Если true, правило оповещения остается неактивным. По умолчанию — false.
keep_firing_forstring
Включает непрерывное срабатывание оповещения в течение заданного времени, даже если условие больше не выполняется. По умолчанию — 0 (разрешается немедленно).
labelsobject
Необязательные метки для правила оповещения
label_selectorsstring[]
Селекторы в стиле Prometheus для фильтрации правил оповещений по меткам. Каждая строка - это селектор, например '{severity="critical", team=~"backend.*"}'. Все селекторы должны совпадать (AND).
limit_alertsinteger
Ограничение количества оповещений на правило. Для list: значение 0 исключает оповещения. Для get: значение <=0 по умолчанию равно 200. Максимум 200.
matchersstring[]
Матчеры меток для фильтрации экземпляров алертов. Каждая строка — это матчер в стиле Prometheus, например: 'severity="critical"', 'env!="dev"', 'team=~"backend.*"'. Требуется Grafana 12.4+.
missing_series_evals_to_resolveinteger
Сколько подряд интервалов оценки должно пройти без данных, чтобы оповещение считалось разрешенным. По умолчанию — 2.
no_data_statestring
Состояние при отсутствии данных: NoData, Alerting, OK (требуется для 'create', 'update')
notification_settingsobject
Объект настроек уведомлений. Поля: receiver (string, обязательное), groupBy ([]string), groupWait/groupInterval/repeatInterval (строки длительности), muteTimeIntervals/activeTimeIntervals ([]string).
operationenumобязательный
Операция для выполнения: 'list', 'get', 'versions', 'create', 'update' или 'delete'. Чтобы создать правило, используйте операцию 'create' и укажите все обязательные поля в одном вызове. Чтобы обновить правило, сначала используйте 'get' для получения его полной конфигурации, затем 'update' со всеми обязательными полями и вашими изменениями.
org_idinteger
ID организации (требуется для 'create', 'update')
recordobject
Конфигурация правила записи. Поля: from (string, обязательное - ID ссылки, например 'A'), metric (string, обязательное - имя метрики), targetDatasourceUid (string, необязательное).
rule_groupstring
Имя группы правил (обязательно для 'create', 'update')
rule_limitinteger
Максимальное количество возвращаемых правил (по умолчанию 200, максимум 200). Требуется Grafana 12.4+ (для операции 'list')
rule_typeenum
Фильтрует по типу правила (для операции 'list').
rule_uidstring
UID правила оповещения (обязателен для 'get', 'versions', 'update', 'delete'; необязателен для 'create')
search_folderstring
Ищет папки по пути с частичным совпадением (для операции 'list'). Требует Grafana 12.4+. Взаимоисключающе с folder_uid.
search_rule_namestring
Поиск имен/заголовков правил оповещений с использованием частичного совпадения. Требуется Grafana 12.4+ (для операции 'list').
statesstring[]
Фильтр по состоянию оповещения: firing, pending, normal, recovering, nodata, error (для операции 'list')
titlestring
Название правила оповещения (обязательно для 'create', 'update')