Criar alertas de anomalias

Esta página se aplica à Apigee e à Apigee híbrida.

Confira a documentação da Apigee Edge.

Com a Apigee, você cria alertas acionados por padrões específicos de tráfego da API. Por exemplo, quando a taxa de erro da API atinge um limite predeterminado. As operações de API ampliam esse recurso com alertas de anomalias, que são acionados sempre que a Apigee detecta dados incomuns de tráfego de APIs. A vantagem dos alertas de anomalias é que você não precisa definir as condições exatas para cada anomalia. As operações de API determinam as condições de anomalias corretas usando métodos estatísticos e as atualizam constantemente com base nos dados de tráfego recentes. Ao usar a detecção de anomalias, você permite que a Apigee detecte problemas de tráfego e desempenho em vez de pré-determinar as condições de alerta por conta própria.

Quando as operações de API detectam uma anomalia, elas exibem o evento no painel Eventos de anomalias. No entanto, não gera um alerta automaticamente para a anomalia. Se você examinar uma anomalia no painel e decidir ser alertado sobre um evento semelhante no futuro, poderá criar um alerta de anomalia e configurar uma notificação, que envia uma mensagem sempre que a anomalia é detectada.

Verifique as permissões necessárias

Antes de criar um alerta de anomalia, verifique se você recebeu os papéis necessários para as operações da API.

Criar um alerta de anomalia

Para criar um alerta de anomalia no painel de políticas de alertas, faça o seguinte:

  1. Abra a página Criar política de alertas > Adicionar condição de alerta.

    Acessar "Adicionar condição de alerta"

    Configure um alerta.
  2. Clique em Selecionar uma métrica.
  3. Em Filtro, digite anomaly.
  4. Se não houver resultados, clique em Ativo para mostrar todos os tipos de métricas.
  5. Clique em Ambiente da Apigee.
  6. Clique em Ambiente.
  7. Clique em Contagem de eventos de anomalias da Apigee.
  8. Clique em Aplicar.
  9. No menu Janela contínua, selecione o período.
  10. No menu Função de janela contínua, selecione delta. Isso especifica como os dados são agregados em cada período, que você define no campo Janela móvel. Com a configuração delta, o valor agregado é igual ao valor dos dados finais no período menos o valor dos dados iniciais.
  11. Clique em Próxima.

  12. Na página Configurar gatilho do alerta, defina o Valor do limite como 0,5. (Qualquer número entre 0 e 1 funcionará para o limite.) Com esse valor, uma única anomalia excede o limite e aciona o alerta.

  13. Nesse ponto, você pode:

    • Clique em Adicionar condição de alerta para criar outra condição para o alerta.
    • Clique em Próxima para ir para a próxima etapa, em que você terá a opção de criar uma notificação para o alerta.
  14. Se você não quiser criar uma notificação agora:
    • Clique em Próxima.
    • Mude a opção Usar canal de notificação para Desativado.
  15. Insira um Nome da política de alertas.
  16. Clique em Criar política para salvar o alerta.

Criar uma notificação para um alerta

Caso queira receber uma notificação imediatamente quando ocorrer um incidente, crie uma notificação para o alerta. Quando o alerta é acionado, a Apigee envia uma notificação. É possível escolher qualquer um dos seguintes canais para receber a notificação:

  • Cloud Mobile App
  • E-mail
  • Google Chat (pré-lançamento)
  • PagerDuty
  • Pub/Sub
  • Slack
  • SMS
  • Webhooks

Para criar uma notificação para o alerta:

  1. Se você acabou de criar o alerta (como mostrado no exemplo anterior) e está visualizando o painel Criar política de alertas, pule para a próxima etapa.

    Se esse não for seu caso, faça o seguinte:

    • Abra a página Políticas.

      Acessar Políticas

    • Na linha do alerta que você criou, clique em Ver ações > Editar.
  2. Confira se a opção Usar canal de notificação está ativada.
  3. Selecione os canais em que você quer receber notificações. Se você quiser criar um novo canal de notificação, selecione Gerenciar canais de notificação. Consulte Criar e gerenciar canais de notificação para mais detalhes.
  4. A maioria das opções nesta página é opcional. Consulte Criar política de alertas para mais detalhes.
  5. Na seção Nomear a política de alertas, insira um Nome da política de alertas.
  6. Se você estiver criando uma política de alertas, clique em Criar política. Se você estiver editando uma política de alertas, clique em Salvar política.

Quando um alerta for acionado, você receberá uma notificação com um resumo do incidente e quando ele ocorreu. A notificação também contém informações para ajudar você a investigar o incidente.