Как работает обнаружение аномалий

Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X. Информация

Детектор отклонений состоит из трех основных этапов:

Обучение моделей

Детектор отклонений обучается на основе исторических данных временных рядов, чтобы создать модель поведения прокси API. Никаких действий с вашей стороны для обучения модели не требуется. Edge автоматически создает и обучает модели на основе данных о дорожной обстановке за последние шесть часов. Поэтому для обучения модели и регистрации аномалии Edge требуется не менее шести часов данных о прокси API.

Регистрация событий аномалий

Во время выполнения функция обнаружения аномалий Edge сравнивает текущее поведение прокси API с поведением, предсказанным моделью. Затем функция обнаружения аномалий может определить, превышает ли операционный показатель прогнозируемое значение, с определенным порогом достоверности. Например, когда доля ошибок 5xx превышает долю, спрогнозированную моделью.

Когда Edge обнаруживает аномалию, он автоматически регистрирует ее на панели управления событиями в интерфейсе Edge. Для каждого обнаруженного отклонения Edge регистрирует пороги достоверности: незначительный, умеренный или серьезный. Например, значительное отклонение – это отклонение, которое считается аномальным с очень высокой степенью достоверности.

В список событий, представленный на панели "События", входят все аномалии, обнаруженные Edge, и все активированные оповещения. Оповещения могут быть фиксированными или аномальными.

Как посмотреть аномалию

  1. В интерфейсе Edge нажмите Analyze > Events (Анализировать > События). Откроется новая панель "События": Как посмотреть события аномалий на панели "События"
  2. На информационной панели "События" можно отфильтровать данные по следующим параметрам:
    • Среда
    • Регион
    • Тип события: Оповещение (исправленное или отклонение) или Отклонение.
    • Порог отклонения (только отклонения)
    • Период времени

Чтобы посмотреть подробную информацию об аномалии:

  1. Выберите строку с аномалией на панели управления событиями, чтобы открыть аномалию на панели управления исследованиями API Monitoring. В приведенном ниже примере рассматривается аномалия, связанная с небольшим увеличением задержки на уровне 90 %. Вертикальная желтая полоса указывает на то, где произошло отклонение:

    Как изучить событие-аномалию

  2. Выберите блок на экране, чтобы посмотреть подробные сведения об аномалии:

    Как посмотреть сведения об аномалии

  3. Выберите Отзыв: насколько точна эта аномалия, чтобы отправить отзыв в Apigee и помочь улучшить обнаружение аномалий. Перейдите по этой ссылке, чтобы указать, была ли аномалия реальной, насколько полезным было обнаружение и оставить комментарий (необязательно).

    Как отправить отзыв об аномалии

Создание оповещений

По умолчанию Edge создает событие отклонения, но не отправляет оповещение о нем. Вам нужно самостоятельно изучить данные на панели "События", чтобы определить, является ли обнаруженная аномалия при рассчитанном пороговом значении реальной проблемой. Если да, вы можете создать оповещение об этом отклонении с текущим или другим пороговым значением. Когда аномалия произойдет в следующий раз, Edge отправит вам уведомление по электронной почте или другим способом.

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

Чтобы создать оповещение об аномалии:

  1. Выберите аномалию на панели "События", чтобы посмотреть ее подробности, как показано выше.
  2. Нажмите кнопку Создать оповещение в сведениях об аномалии. Откроется панель создания оповещения.

  3. Настройте оповещение. В следующем примере показано, как настроить оповещение о небольшом увеличении задержки на уровне 90 % для среды prod в любом регионе:

    Как настроить оповещения об отклонениях

  4. Нажмите + Уведомление, чтобы добавить оповещение.

    Данные об уведомлении Описание
    Канал Выберите канал уведомлений и укажите получателя: электронную почту, Slack, PagerDuty или веб-перехватчик.
    Место назначения

    Укажите целевой адрес в зависимости от выбранного типа канала:

    • Электронная почта – адрес электронной почты, например joe@company.com.
    • Slack – URL канала Slack, например https://hooks.slack.com/services/T00000000/B00000000/XXXXX.
    • PagerDuty – код PagerDuty, например abcd1234efgh56789.

    • Вебхук – URL вебхука, например https://apigee.com/test-webhook.

    Примечание. Для каждого уведомления можно указать только один пункт назначения. Чтобы указать несколько адресов для одного типа канала, добавьте дополнительные уведомления.
  5. Чтобы добавить другие уведомления, повторите шаг 4.
  6. Если вы добавили уведомление, задайте следующие поля:
    Поле Описание
    Дроссель Частота отправки уведомлений. Выберите значение из раскрывающегося списка.

  7. Нажмите Сохранить.

    При следующем возникновении аномалии вы получите уведомление.