Como investigar anomalias

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

Confira a documentação da Apigee Edge.

Importante: "Detecção de anomalias" descreve a funcionalidade de Detecção de anomalias de operações avançadas de API, que está disponível na interface clássica da Apigee. Essa funcionalidade é comparável à página "Anomalias nas operações" na interface da Apigee no console do Cloud. Ambas estão disponíveis no momento. Consulte Visão geral das anomalias de operações para informações sobre a funcionalidade.

Quando você vê uma anomalia no Painel de eventos de anomalia, é 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 eventos de anomalias 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.

Observação: queremos saber o que você acha da detecção de anomalias. Se você recebeu um alerta de anomalia, envie um feedback sobre o alerta clicando no botão Feedback de anomalia no canto superior direito do painel Detalhes do evento de anomalia:   

O painel de detalhes de evento da anomalia mostra 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.