Создание оповещений активатора из набора запросов KQL
В этой статье описывается создание оповещений активатора Fabric из набора запросов KQL. Дополнительные сведения см. в разделе "Что такое активатор". Активатор можно использовать в наборе запросов KQL для активации уведомлений в двух режимах:
- Когда запланированный запрос KQL возвращает результаты
- Если запланированный запрос KQL возвращает результаты, содержащие визуализацию, которая соответствует определенному набору условий.
Отправлять уведомления оповещений самостоятельно или другим пользователям в вашей организации. Уведомления можно отправлять по электронной почте или по сообщению Microsoft Teams.
Примеры сценариев
Ниже приведены некоторые способы использования оповещений активатора с запросами KQL:
- Предположим, что у вас есть база данных KQL и хранится журналы приложений.
- Вы получаете оповещение, когда все записи за последние пять минут содержат строку
authorization error
в столбце сообщения таблицы.
- Вы получаете оповещение, когда все записи за последние пять минут содержат строку
- В другом сценарии у вас есть потоковые данные для доступных велосипедов в разных районах. Создается запрос KQL для отрисовки круговой диаграммы для количества доступных велосипедов в каждом районе.
- Вы получаете оповещение, когда количество доступных велосипедов в любом районе падает ниже допустимого числа.
Необходимые компоненты
- Рабочая область с емкостью с поддержкой Microsoft Fabric
- База данных KQL с данными
- Набор запросов KQL, подключенный к базе данных KQL. Дополнительные сведения см. в разделе "Запрос данных" в наборе запросов KQL.
Внимание
Поддерживаются только запросы к базам данных KQL в хранилище событий. Если набор запросов KQL подключен к внешнему кластеру Azure Data Explorer, создание оповещения не поддерживается.
В следующих шагах показано, как создать оповещение для запроса, создающего визуализацию, или запрос, который не создает визуализацию.
Выберите вкладку, соответствующую нужному рабочему процессу.
Настройка оповещений в наборе запросов KQL
Внимание
Визуализации временных диаграмм не поддерживаются в этом сценарии. Они поддерживаются в оповещениях "Создание активатора" на панели мониторинга реального времени.
Откройте рабочую область, содержащую набор запросов KQL.
Перейдите к набору запросов KQL и выберите его для открытия.
Запустите запрос, возвращающий визуализацию.
Когда запрос возвращает результаты, выберите "Задать оповещение " на верхней ленте.
Например, следующий запрос основан на примерах данных велосипедов из руководства по аналитике в режиме реального времени.
TutorialTable | where Timestamp < ago(5m) | summarize NumberOfBikes=sum(No_Bikes) by Neighbourhood | render columnchart
Запрос возвращает столбчатую диаграмму, показывающую количество велосипедов, доступных в каждом районе. Используйте эту диаграмму для задания условий генерации оповещений.
Определение условий генерации оповещени
Задайте частоту времени для частоты выполнения запроса. Значение по умолчанию — пять минут.
В разделе Условияукажите условия сигналов таким образом:
- Если визуализация не имеет измерений, вы можете выбрать "В каждом событии", когда условие для отслеживания изменений в потоке данных можно выбрать определенное поле для отслеживания.
- Если визуализация включает измерения, вы можете выбрать "Вкл. Каждое событие сгруппировано по условию для отслеживания изменений в потоке данных", выбрав поле для группировки, которое делит данные на отдельные группы
- В раскрывающемся списке "Когда " задайте значение для вычисления.
- В раскрывающемся списке "Условие " задайте условие для вычисления. Дополнительные сведения см. в разделе Условия.
- В поле "Значение" задайте значение для сравнения.
В действии укажите, требуется ли оповещение по электронной почте или Microsoft Teams. На боковой панели можно настроить уведомления, отправляемые самостоятельно. Сведения о отправке уведомлений другому пользователю см. в статье "Необязательно. Изменение правила в активаторе".
В расположении "Сохранить" укажите, где сохранить оповещение активатора. Выберите существующую рабочую область и сохраните ее в существующем активаторе или новом.
Нажмите кнопку "Создать", чтобы создать правило активатора.
Необязательно. Изменение правила в активаторе
При сохранении активатора на боковой панели отображается ссылка на элемент. Выберите ссылку для дальнейшего редактирования в Активаторе. Этот шаг может быть полезным, если вы хотите выполнить одно из следующих действий:
- Добавьте других получателей в оповещение.
- Измените содержимое оповещения, чтобы отразить определенные данные, которые активировали оповещение.
- Определите более сложное условие генерации оповещений, чем возможно в области "Задание оповещений".
Сведения об изменении правил в Активаторе см. в разделе "Создание правил активации".
В самом активаторе можно также просмотреть журнал результатов запроса и журнал активаций правил. Дополнительные сведения см. в разделе "Создание правил активации".