Investigar anomalias

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

Confira a documentação da Apigee Edge.

Importante: nesta página, descrevemos como usar anomalias de operações, que são comparáveis às funcionalidades de detecção avançada de anomalias de operações de API na IU clássica da Apigee. A opção "Anomalias operacionais" só está disponível na interface da Apigee no console do Cloud, enquanto a "Detecção de anomalias" só está disponível ao usar a interface clássica da Apigee. Ambas estão disponíveis no momento.

Quando você vê uma anomalia no Painel de anomalias nas operações, é possível investigar mais a fundo nos painéis de monitoramento de APIs. Os painéis exibem gráficos e tabelas de dados recentes da API, que fornecem informações altamente específicas sobre o que estava acontecendo na API no momento da anomalia.

Nas seções a seguir, apresentamos exemplos que ilustram como investigar anomalias nos painéis.

Exemplo: anomalia do código de falha

Suponha que você esteja analisando o painel de anomalias nas operações e percebe a anomalia mostrada abaixo:

Para visualizar os detalhes da anomalia, clique em Investigar na coluna Resumo. O painel de investigação do monitoramento de APIs será exibido, conforme mostrado abaixo.

O painel "Detalhes do evento de anomalia" exibe uma linha do tempo da taxa de erros. O gráfico mostra que a anomalia ocorreu depois das 07h00, quando a taxa de erro saltou de menos de 0,4 para mais de 0,8.

A taxa de erro no gráfico da linha do tempo inclui erros para todos os códigos de falha. Para ver um detalhamento dos erros de diferentes códigos de falha, consulte o gráfico código de falha por tempo exibido abaixo da linha do tempo.

Observação: se o gráfico código de falha por tempo não estiver em exibição, selecione Código de falha no menu Gráficos para mostrá-lo::

A coluna com círculo do gráfico de falha por tempo corresponde ao intervalo de tempo que contém a hora da anomalia.

Observação: há uma pequena diferença entre os dados exibidos no gráfico e o horário informado da anomalia é normal.

Observe que, no intervalo 07:03 - 07:27, haviam 1499 respostas com código de falha steps.json2xml.SourceUnavailable (um código de erro retornado quando uma origem de mensagem de política JSON para XML não está disponível). É o código de falha que acionou a anomalia. Por outro lado, nos quatro intervalos anteriores, o número médio de respostas com código de falha era cerca de 291. Portanto, o salto para 1499 era um evento incomum.

Para mais informações sobre a mensagem de erro SourceUnavailable, consulte Solução de problemas de erros de tempo de execução de política JSON para XML.

Nesse ponto, há algumas maneiras de continuar investigando a causa da anomalia:

• Detalhe os dados do código de falha no momento da anomalia, clicando na célula da anomalia no gráfico do tempo do código de falha.

  

  Isso exibe tabelas de distribuição para steps.json2xml.SourceUnavailable por origem da falha, proxy e código de status no painel à direita.

  Neste exemplo, as tabelas não fornecem informações adicionais porque todos os códigos de falha vêm da mesma origem de falha, proxy e código de status. Mas em outras situações, as tabelas de distribuição podem indicar o local e a causa da anomalia.

• Crie um alerta para a anomalia e configure uma notificação. Depois disso, as operações da API enviarão uma mensagem sempre que ocorrer um evento semelhante no futuro.