Поделиться через


Создание оповещений активатора из набора запросов KQL

В этой статье описывается создание оповещений активатора Fabric из набора запросов KQL. Дополнительные сведения см. в разделе "Что такое активатор". Активатор можно использовать в наборе запросов KQL для активации уведомлений в двух режимах:

  • Когда запланированный запрос KQL возвращает результаты
  • Если запланированный запрос KQL возвращает результаты, содержащие визуализацию, которая соответствует определенному набору условий.

Отправлять уведомления оповещений самостоятельно или другим пользователям в вашей организации. Уведомления можно отправлять по электронной почте или по сообщению Microsoft Teams.

Примеры сценариев

Ниже приведены некоторые способы использования оповещений активатора с запросами KQL:

  • Предположим, что у вас есть база данных KQL и хранится журналы приложений.
    • Вы получаете оповещение, когда все записи за последние пять минут содержат строку authorization error в столбце сообщения таблицы.
  • В другом сценарии у вас есть потоковые данные для доступных велосипедов в разных районах. Создается запрос KQL для отрисовки круговой диаграммы для количества доступных велосипедов в каждом районе.
    • Вы получаете оповещение, когда количество доступных велосипедов в любом районе падает ниже допустимого числа.

Необходимые компоненты

Внимание

Поддерживаются только запросы к базам данных KQL в хранилище событий. Если набор запросов KQL подключен к внешнему кластеру Azure Data Explorer, создание оповещения не поддерживается.

В следующих шагах показано, как создать оповещение для запроса, создающего визуализацию, или запрос, который не создает визуализацию.

Выберите вкладку, соответствующую нужному рабочему процессу.

Настройка оповещений в наборе запросов KQL

Внимание

Визуализации временных диаграмм не поддерживаются в этом сценарии. Они поддерживаются в оповещениях "Создание активатора" на панели мониторинга реального времени.

  1. Откройте рабочую область, содержащую набор запросов KQL.

  2. Перейдите к набору запросов KQL и выберите его для открытия.

  3. Запустите запрос, возвращающий визуализацию.

  4. Когда запрос возвращает результаты, выберите "Задать оповещение " на верхней ленте.

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

    TutorialTable
    | where Timestamp < ago(5m)
    | summarize NumberOfBikes=sum(No_Bikes) by Neighbourhood
    | render columnchart
    

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

Определение условий генерации оповещени

  1. Задайте частоту времени для частоты выполнения запроса. Значение по умолчанию — пять минут.

  2. В разделе Условияукажите условия сигналов таким образом:

    • Если визуализация не имеет измерений, вы можете выбрать "В каждом событии", когда условие для отслеживания изменений в потоке данных можно выбрать определенное поле для отслеживания.
    • Если визуализация включает измерения, вы можете выбрать "Вкл. Каждое событие сгруппировано по условию для отслеживания изменений в потоке данных", выбрав поле для группировки, которое делит данные на отдельные группы
    • В раскрывающемся списке "Когда " задайте значение для вычисления.
    • В раскрывающемся списке "Условие " задайте условие для вычисления. Дополнительные сведения см. в разделе Условия.
    • В поле "Значение" задайте значение для сравнения.
  3. В действии укажите, требуется ли оповещение по электронной почте или Microsoft Teams. На боковой панели можно настроить уведомления, отправляемые самостоятельно. Сведения о отправке уведомлений другому пользователю см. в статье "Необязательно. Изменение правила в активаторе".

  4. В расположении "Сохранить" укажите, где сохранить оповещение активатора. Выберите существующую рабочую область и сохраните ее в существующем активаторе или новом.

  5. Нажмите кнопку "Создать", чтобы создать правило активатора.

    Снимок экрана: панель

Необязательно. Изменение правила в активаторе

При сохранении активатора на боковой панели отображается ссылка на элемент. Выберите ссылку для дальнейшего редактирования в Активаторе. Этот шаг может быть полезным, если вы хотите выполнить одно из следующих действий:

  • Добавьте других получателей в оповещение.
  • Измените содержимое оповещения, чтобы отразить определенные данные, которые активировали оповещение.
  • Определите более сложное условие генерации оповещений, чем возможно в области "Задание оповещений".

Сведения об изменении правил в Активаторе см. в разделе "Создание правил активации".

В самом активаторе можно также просмотреть журнал результатов запроса и журнал активаций правил. Дополнительные сведения см. в разделе "Создание правил активации".