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

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

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

Активатор можно настроить для активации уведомлений на основе набора запросов KQL в двух сценариях:

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

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

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

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

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

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

Предварительные условия

Внимание

  • Поддерживаются только запросы к базам данных KQL в хранилище событий. Если набор запросов KQL подключен к внешнему кластеру Azure Data Explorer, создание оповещения не поддерживается.
  • Влияние правила генерации оповещений на Eventhouse зависит от сложности запроса. Простые запросы и агрегации мало затратны, в то время как соединения, преобразования и сортировки более ресурсоемки. Если запрос выполняется каждые 1 или 5 минут, он эффективно сохраняет хранилище событий в состоянии always-on . Без запросов или приема более 5 минут Eventhouse может впадать в бездействие, что снижает затраты. Дополнительные сведения см. в статье Eventhouse Uptime.

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

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

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

Внимание

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

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

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

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

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

    Снимок экрана: кнопка

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

В появившейся боковой области "Добавление правила" выполните следующие действия, чтобы определить условия оповещения:

  1. В разделе "Сведения" укажите имя правила генерации оповещений Активатора.

    Снимок экрана: раздел

  2. В разделе "Монитор " задайте частоту времени для частоты выполнения запроса. Значение по умолчанию равно 5 минутам.

    Снимок экрана: раздел

  3. В разделе условий укажите условия генерации оповещений следующим образом:

    Снимок экрана: раздел

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

  4. В разделе "Действие" выберите одно из следующих действий:

    • Отправка уведомления по электронной почте:

      1. Для действия "Выбрать" выберите "Отправить сообщение электронной почты".
      2. В поле "Кому" введите адрес электронной почты получателя или используйте раскрывающийся список, чтобы выбрать свойство, значение которого является адресом электронной почты. По умолчанию адрес электронной почты заполняется здесь.
      3. В поле "Тема" введите тему уведомления по электронной почте.
      4. В поле "Заголовок" введите заголовок уведомления по электронной почте.
      5. Для заметок введите заметки для уведомления по электронной почте.

        Замечание

        При вводе темы, заголовка или заметок можно ссылаться на свойства данных, введя @ или нажав кнопку рядом с текстовыми полями. Например: @BikepointID.

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

      Снимок экрана: раздел

    • Отправьте уведомление Microsoft Teams: отправляет вам сообщение Microsoft Teams. Вы можете настроить содержимое заголовка и сообщения.

      1. Для выбора действия выберите Teams -->Сообщение для отдельных лиц или Сообщение в групповом чате или Публикация в канале.
      2. Выполните одно из следующих действий в зависимости от выбранного варианта.
        • Если вы выбрали параметр "Сообщение для отдельных лиц ", введите адреса электронной почты получателей или используйте раскрывающийся список, чтобы выбрать свойство, значение которого является адресом электронной почты. При выполнении условия сообщение электронной почты отправляется указанным лицам.
        • Если выбран параметр сообщения группового чата , выберите групповой чат в раскрывающемся списке. При выполнении условия сообщение публикуется в групповом чате.
        • Если выбран параметр публикации канала , выберите команду и канал из раскрывающихся списков. При выполнении условия сообщение публикуется в выбранном канале.
      3. В поле "Заголовок" введите заголовок уведомления Teams.
      4. Для заметок введите заметки для уведомления Teams.

        Замечание

        При вводе темы, заголовка или заметок можно ссылаться на свойства данных, введя @ или нажав кнопку рядом с текстовыми полями. Например: @BikepointID.

      5. Для контекста выберите значения из выпадающего списка, которые нужно включить в уведомление Teams.

      Снимок экрана: раздел

    • Выполнение действий Fabric. Чтобы настроить оповещение для запуска конвейера Fabric, потока данных (предварительная версия), задания Spark или записной книжки при выполнении условия, выполните следующие действия.

      1. Для Выбор действия, выберите соответствующий тип элемента Fabric в разделе «Запуск действий Fabric».
      2. Чтобы запустить элемент Select Fabric, выберите элемент Fabric из списка.
      3. Выберите "Добавить параметр" и укажите имя параметра для элемента Fabric и значение для него. Можно добавить несколько параметров. Параметры из данных генерации оповещений можно передать, введя @ или нажав кнопку рядом с текстовым полем. Например: @BikepointID. Снимок экрана: раздел действий Run Fabric на боковой панели

    • Настраиваемые действия. Чтобы настроить оповещение для вызова настраиваемого действия при выполнении условия, выполните следующие действия:

      1. Для действия "Выбрать" выберите "Создать настраиваемое действие".

        Снимок экрана: раздел

      2. Как упоминалось в разделе "Действие", сначала создайте правило, а затем завершите настройку пользовательского действия, следуя шагам из Запуск пользовательских действий (потоки Power Automate).

      3. После создания настраиваемого действия в области определения правила выберите настраиваемое действие, созданное в раскрывающемся списке действий .

  5. В Папка для сохранения укажите, где сохранить оповещение Активатора. Выберите существующую рабочую область и сохраните ее в существующем активаторе или новом.

    Скриншот раздела

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

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

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

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

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

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

Связанный контент

  • Last updated on