Как настроить оповещения и получать уведомления с помощью перехватчика
Важно!
Начиная с 20 сентября 2023 г. вы не сможете создавать новые ресурсы помощника по метрикам. Служба помощника по метрикам отменяется 1 октября 2026 года.
После обнаружения аномалии помощником по метрикам на основе параметров оповещений будет активировано уведомление о предупреждении с помощью обработчика. Параметр предупреждения можно использовать с несколькими конфигурациями обнаружения. для настройки правила генерации оповещений доступны различные параметры.
создание перехватчика;
Помощник по метрикам поддерживает четыре различных типа перехватчиков: перехватчик электронной почты, веб-перехватчик, перехватчик Teams и Azure DevOps. Вы можете выбрать ту, которая подходит для конкретного сценария.
Обработчик сообщений электронной почты
Примечание.
Администраторы ресурсов помощника по метрикам должны настроить параметры электронной почты и ввести данные, связанные с SMTP, в помощник по метрикам, прежде чем можно будет отправлять оповещения об аномалиях. Администратору группы ресурсов или администратору подписки необходимо назначить по крайней мере одну роль администратора метрик Advisor Cognitive Services на вкладке "Управление доступом ресурса Advisor". Дополнительные сведения о настройке параметров электронной почты.
Обработчик электронной почты — это канал для отправки оповещений об аномалиях на адреса электронной почты, указанные в разделе Электронное письмо (кому). Будут отправлены два типа оповещений: веб-канал данных недоступен и отчеты об инцидентах, содержащие одну или несколько аномалий.
Чтобы создать обработчик электронной почты, доступны следующие параметры.
| Параметр | Описание: |
|---|---|
| Имя. | Имя обработчика электронной почты |
| Электронное письмо (кому) | Адреса электронной почты для отправки оповещений |
| Внешняя ссылка | Необязательное поле, которое позволяет настроить перенаправление, например для устранения неполадок. |
| Название предупреждения настраиваемой аномалии | Шаблон заголовка поддерживает ${severity}, ${alertSettingName}, ${datafeedName}, ${metricName}, ${detectConfigName}, ${timestamp}, ${topDimension}, ${incidentCount}, ${anomalyCount} |
После нажатия кнопки ОК будет создан перехватчик электронной почты. Его можно использовать в любых параметрах оповещений для получения оповещений об аномалиях. Подробные инструкции см. в руководстве по включению уведомлений об аномалиях в Помощнике по метрикам.
обработчик Teams;
Перехватчик Teams — это канал для отправки оповещений об аномалиях в канал в Microsoft Teams. Перехватчик Teams реализуется с помощью соединителя "Веб-перехватчик входящего трафика". Возможно, потребуется создать соединитель "Веб-перехватчик входящего трафика" в целевом канале Teams и получить его URL-адрес. Затем выполните сведение к рабочей области Помощника по метрикам.
Выберите вкладку "Перехватчики" на панели навигации слева и нажмите кнопку "Создать перехватчик" в правом верхнем углу страницы. Выберите тип перехватчика "Teams", после чего будут предоставлены следующие параметры:
| Параметр | Описание: |
|---|---|
| Имя. | Имя перехватчика Teams |
| URL-адрес соединителя | URL-адрес, который вы только что скопировали из соединителя "Веб-перехватчик входящего трафика", созданного в целевом канале Teams. |
После нажатия кнопки ОК будет создан перехватчик Teams. Его можно использовать в любых параметрах оповещений для уведомления о предупреждениях об аномалиях в целевом канале Teams. Подробные инструкции см. в руководстве по включению уведомлений об аномалиях в Помощнике по метрикам.
Веб-перехватчик
Веб-перехватчик — это еще один канал уведомления с помощью конечной точки, предоставляемой клиентом. Уведомления обо всех аномалиях, обнаруженных во временных рядах, будут отправляться через веб-перехватчик. Существует несколько действий по включению веб-перехватчика в качестве канала уведомлений о предупреждениях в Помощнике по метрикам.
Шаг 1. Включение управляемого удостоверения в ресурсе Помощника по метрикам
На каждый ресурс может приходиться не более одного управляемого удостоверения, назначаемого системой, кроме того, оно привязано к жизненному циклу этого ресурса. Управляемому удостоверению можно предоставить разрешения, используя управление доступом на основе ролей Azure (Azure RBAC). Управляемое удостоверение проходит проверку подлинности с помощью идентификатора Microsoft Entra, поэтому вам не нужно хранить учетные данные в коде.
Перейдите к ресурсу Помощника по метрикам на портале Azure и выберите "Удостоверение", а затем включите его, после чего управляемое удостоверение будет включено.
Шаг 2. Создание веб-перехватчика в рабочей области Помощника метрикам
Войдите в рабочую область и выберите вкладку "Перехватчики", а затем нажмите кнопку "Создать перехватчик".
Чтобы создать веб-перехватчик, необходимо добавить следующие сведения.
| Параметр | Описание |
|---|---|
| Конечная точка | Адрес API, вызываемый при активации оповещения. Должен быть HTTPS. |
| Имя пользователя и пароль | Для проверки подлинности на адресе API. Если проверка подлинности не требуется, оставьте его черным. |
| Заголовок | Пользовательские заголовки в вызове API. |
| Идентификатор сертификата в хранилищах ключей Azure | Если для доступа к конечной точке требуется проверка подлинности с помощью сертификата, сертификат должен храниться в хранилище ключей Azure. Введите здесь идентификатор. |
Примечание.
При создании или изменении веб-перехватчика конечная будет вызываться как тест с пустым текстом запроса. Чтобы пройти проверку, API должен вернуть код HTTP 200.
- Метод запроса — POST
- Время ожидания — 30 с
- Повторите попытку для ошибки 5xx, проигнорируйте другие ошибки. Не будет следовать за запросом перенаправления 301/302.
- Текст запроса:
{
"value": [{
"hookId": "b0f27e91-28cf-4aa2-aa66-ac0275df14dd",
"alertType": "Anomaly",
"alertInfo": {
"anomalyAlertingConfigurationId": "1bc6052e-9a2a-430b-9cbd-80cd07a78c64",
"alertId": "172536dbc00",
"timestamp": "2020-05-27T00:00:00Z",
"createdTime": "2020-05-29T10:04:45.590Z",
"modifiedTime": "2020-05-29T10:04:45.590Z"
},
"callBackUrl": "https://kensho2-api.azurewebsites.net/alert/anomaly/configurations/1bc6052e-9a2a-430b-9cbd-80cd07a78c64/alerts/172536dbc00/incidents"
}]
}
Шаг 3. (необязательно). Сохраните сертификат в хранилищах ключей Azure и получите идентификатор как упоминание, если доступ к конечной точке необходимо пройти проверку подлинности сертификатом, сертификат должен храниться в хранилищах ключей Azure.
- См. раздел Настройка и получение сертификата из Azure Key Vault с помощью портала Azure
- Выберите добавленный сертификат, а затем вы можете скопировать идентификатор сертификата.
- Затем выберите "Политики доступа" и "Добавить политику доступа", предоставьте разрешение "Получение" в разделах "Разрешения на доступ к ключам", "Разрешения на доступ к секрету" и "Разрешения сертификата". Выберите субъект в качестве имени ресурса Помощника по метрикам. Нажмите кнопку "Добавить" и "Сохранить" на странице "Политики доступа".
Шаг 4. Получение уведомления об аномалии. При отправке уведомления через веб-перехватчик можно получить данные инцидентов, вызвав "callBackUrl" в запросе веб-перехватчика. Сведения для этого API:
С помощью веб-перехватчика и Azure Logic Apps можно отправить уведомление по электронной почте без настроенного SMTP-сервера. Подробные инструкции см. в руководстве по включению уведомлений об аномалиях в Помощнике по метрикам.
Azure DevOps
Помощник по метрикам также поддерживает автоматическое создание рабочего элемента в Azure DevOps для наблюдения за проблемами и ошибками при обнаружении аномалий. Все оповещения можно отправлять с помощью перехватчиков Azure DevOps.
Чтобы создать перехватчик Azure DevOps, необходимо добавить следующие сведения.
| Параметр | Описание: |
|---|---|
| Имя. | Имя для обработчика |
| Организация | Организация, к которой принадлежит ваш DevOps |
| Проект | Конкретный проект в DevOps. |
| Маркер доступа | Токен для проверки подлинности в DevOps. |
Примечание.
Необходимо предоставить разрешения на запись, если помощник по метрикам должен создавать рабочие элементы на основе оповещений об аномалиях. После создания обработчиков их можно использовать в любых параметрах оповещений. Управление обработчиками на странице Параметры перехватчика.
Добавление или изменение параметров оповещений
Перейдите на страницу сведений метрики, чтобы найти раздел Параметры оповещений, в нижнем левом углу страницы сведений метрики. В нем перечислены все параметры оповещений, относящиеся к выбранной конфигурации обнаружения. При создании новой конфигурации обнаружения нет параметров оповещений, и оповещения не будут отправляться.
Для изменения параметров оповещений можно использовать значки Добавить, Изменить и Удалить.
Нажмите кнопку Добавить или Изменить, чтобы открыть окно для добавления или изменения параметров оповещений.
Имя параметра предупреждения: имя параметра оповещения. Он будет отображаться в заголовке оповещения по электронной почте.
Перехватчики: список обработчиков для отправки предупреждений.
Раздел, отмеченный на снимке экрана выше, — это параметры для одного обнаружения конфигурации. Для разных конфигураций обнаружения можно задать различные параметры оповещений. Выберите целевую конфигурацию, используя третий раскрывающийся список в этом окне.
Параметры фильтра
Ниже приведены параметры фильтра для одной конфигурации обнаружения.
Оповещение для имеет четыре варианта фильтрации аномалий.
- Аномалии во всех рядах: все аномалии будут включаться в оповещение.
- Аномалии в группе рядов: фильтрация рядов по значениям измерений. Задание определенных значений для некоторых измерений. Аномалии будут включаться в предупреждение только тогда, когда ряд соответствует указанному значению.
- Аномалии в избранном ряде: в оповещение будут включаться только ряды, помеченные как избранные. |
- Аномалии в N-м всех рядов: этот фильтр предназначен только для ряда, значение которого находится в верхнем N. Помощник по метрикам рассматривает несколько меток времени и проверяет, находится ли значение ряда в этой метке N. Если число "по верхнему N" превышает указанное число, аномалия будет включена в предупреждение. |
Параметры фильтрации аномалий — это дополнительный фильтр со следующими параметрами.
- Серьезность: аномалия будет включена только в том случае, если серьезность аномалии находится в указанном диапазоне.
- Отложить: остановить оповещения для аномалий в следующих N пунктах (период) при срабатывании предупреждения.
- Отложить тип: если задано значение Ряды, активируемая аномалия будет откладывать только свои ряды. Для метрики одна активируемая аномалия будет откладывать все ряды в этой метрике.
- Откладываемое количество: количество точек (период), которые нужно отложить.
- Сброс для неуспешных: если этот флажок установлен, активированная аномалия отменяет только следующие n последовательных аномалий. Если одна из следующих точек данных не является аномалией, откладывание будет сбрасываться с этого момента. Если не выбрано, одна из активированных аномалий отменяет следующие n точек (период), даже если последующие точки данных не являются аномалиями.
- Значение (необязательно): фильтр по значению. Оповещение будет включать только значения точек, соответствующие условию, и аномалию. При использовании соответствующего значения другой метрики имена измерений двух метрик должны быть одинаковыми.
В оповещении будут отправляться аномалии, которые не отфильтрованы.
Добавить параметры перекрестной метрики
Щелкните + Добавить параметры перекрестной метрики на странице параметров оповещений, чтобы добавить другой раздел.
Селектор оператора является логической связью каждого раздела, чтобы определить, отправляют ли они предупреждение.
| Operator | Description |
|---|---|
| И | Отправлять оповещение следует только в том случае, если ряд соответствует каждому разделу оповещения, а все точки данных являются аномалиями. Если метрики имеют различные имена измерений, предупреждение никогда не будет срабатывать. |
| ИЛИ | Отправляйте оповещение, если хотя бы один раздел содержит аномалии. |
