Esta página aplica-se ao Apigee e ao Apigee Hybrid.
Veja a documentação do
Apigee Edge.
Vista geral das anomalias de operações
As anomalias de operações identificam padrões de dados de API invulgares ou inesperados nas suas APIs, com base em padrões de dados recentes. Por exemplo, neste gráfico da taxa de erros da API, a taxa de erros aumenta subitamente por volta das 07:00. Em comparação com os dados anteriores a essa hora, este aumento é suficientemente invulgar para ser classificado como uma anomalia.
Nem todas as variações nos dados da API representam anomalias: a maioria são flutuações aleatórias. Por exemplo, pode ver algumas pequenas variações na taxa de erro que antecedem a anomalia, mas estas não são suficientemente significativas para serem categorizadas como uma anomalia.
As anomalias de operações monitorizam continuamente os dados da API e realizam análises estatísticas para distinguir as anomalias verdadeiras das flutuações aleatórias nos dados.
As anomalias de operações detetam automaticamente estes tipos de anomalias:
- Aumento dos erros HTTP 503 ao nível da organização, do ambiente e da região
- Aumento dos erros HTTP 504 ao nível da organização, do ambiente e da região
- Aumento de todos os erros HTTP 4xx ou 5xx ao nível da organização, do ambiente e da região
- Aumento na latência de resposta total para o percentil 90 (p90) ao nível da organização, do ambiente e da região
Uma anomalia detetada inclui estas informações:
- A métrica que causou a anomalia, como a latência do proxy ou um código de erro HTTP.
- A gravidade da anomalia. A gravidade pode ser ligeira, moderada ou grave, com base no respetivo nível de confiança no modelo. Um nível de confiança baixo indica que a gravidade é ligeira, enquanto um nível de confiança elevado indica que é grave.
Pré-requisitos para usar anomalias de operações
Para usar as anomalias de operações:
- O suplemento AAPI Ops tem de estar ativado para a sua organização. Consulte o artigo Ative as operações da API AAPI numa organização.
- Os utilizadores de anomalias de operações têm de ter as funções necessárias para as operações da API Google Ads.
- Os utilizadores que
investigam anomalias no painel de controlo
também precisam da função
roles/logging.viewer.
Veja anomalias de operações detetadas
Quando as anomalias de operações detetam uma anomalia, apresentam os detalhes da anomalia no painel de controlo de anomalias de operações. Pode investigar a anomalia nos painéis de controlo da monitorização de APIs e tomar as medidas adequadas, se necessário. Também pode criar um alerta para receber uma notificação se ocorrerem eventos semelhantes no futuro.
O painel de controlo de anomalias de operações na IU do Apigee é a sua principal fonte de informações sobre anomalias de operações detetadas. O painel de controlo apresenta uma lista de anomalias recentes.
Para abrir o painel de controlo Anomalias de operações:
- Inicie sessão na IU do Apigee na Cloud Console.
- Mude para a organização que quer monitorizar.
- No menu do lado esquerdo, selecione Analytics > Anomalias de operações.
É apresentado o painel de controlo de anomalias de operações.
Por predefinição, o painel de controlo mostra anomalias que ocorreram na hora anterior. Se não forem detetadas anomalias durante esse período, não são apresentadas linhas no painel de controlo. Pode selecionar um intervalo de tempo maior no menu de intervalo de tempo na parte superior direita do painel de controlo.
Cada linha na tabela corresponde a uma anomalia detetada e apresenta as seguintes informações:
- A data e a hora da anomalia.
- Um breve resumo da anomalia, incluindo o proxy em que ocorreu e o código de erro que a acionou.
- O ambiente no qual ocorreu a anomalia.
- A região onde ocorreu a anomalia.
- A gravidade do evento de anomalia: ligeira, moderada ou grave. A gravidade baseia-se numa medida estatística (valor p) da improbabilidade de o evento ocorrer por acaso (quanto mais improvável for o evento, maior é a sua gravidade).
Também pode investigar uma anomalia nos painéis de controlo da monitorização de APIs, que mostram vários gráficos de dados de tráfego de API recentes.
Como funciona a deteção de anomalias
A deteção de anomalias envolve as seguintes fases:
Prepare modelos
As anomalias de operações funcionam através da preparação de um modelo do comportamento dos seus proxies de API a partir de dados de séries cronológicas do histórico. Não tem de fazer nada para preparar o modelo. O Apigee cria e prepara automaticamente modelos para si a partir das seis horas anteriores de dados da API. Por conseguinte, o Apigee requer um mínimo de seis horas de dados num proxy de API para preparar o modelo antes de poder registar uma anomalia.
O objetivo da preparação é melhorar a precisão do modelo, que pode ser testado em dados do histórico. A forma mais simples de testar a precisão de um modelo é calcular a respetiva taxa de erro, ou seja, a soma dos falsos positivos e falsos negativos, dividida pelo número total de eventos previstos.
Eventos de anomalia de registo
Em tempo de execução, as anomalias de operações comparam o comportamento atual dos seus proxies de API com o comportamento previsto pelo modelo. As anomalias de operações podem, então, determinar, com um nível de confiança específico, quando uma métrica operacional está a exceder o valor previsto. Por exemplo, quando a taxa de erros 5xx excede a taxa prevista pelo modelo.
Quando o Apigee deteta uma anomalia, regista automaticamente o evento no painel de controlo Anomalias de operações. A lista de eventos apresentada no painel de controlo inclui todas as anomalias detetadas, bem como os alertas acionados.