Esta página se aplica a Apigee y Apigee Hybrid.
Consulta la documentación de
Apigee Edge.
Descripción general de Anomalías de operaciones
Anomalías de operaciones identifica patrones de datos de API inusuales o inesperados en tus APIs, según patrones de datos recientes. Por ejemplo, en este gráfico de la tasa de errores de la API, la tasa de errores aumenta repentinamente cerca de las 7 a.m. En comparación con los datos anteriores, este aumento es lo suficientemente inusual como para clasificarlo como una anomalía.
No todas las variantes de los datos de la API representan anomalías: la mayoría son fluctuaciones aleatorias. Por ejemplo, puedes ver algunas variaciones menores en la tasa de error que conducen a la anomalía, pero no son lo suficientemente significativas como para clasificarse como una anomalía.
Anomalías de operaciones supervisa los datos de la API de forma continua y realiza análisis estadísticos para distinguir anomalías reales de fluctuaciones aleatorias en los datos.
Anomalías de operaciones detecta automáticamente estos tipos de anomalías:
- Aumento de errores HTTP 503 a nivel de organización, entorno y región
- Aumento de errores HTTP 504 a nivel de organización, entorno y región
- Aumento de todos los errores HTTP 4xx o 5xx a nivel de organización, entorno y región
- Aumento en la latencia total de respuesta para el percentil 90 (p90) a nivel de organización, entorno y región
En una anomalía detectada, se incluye la siguiente información:
- La métrica que causó la anomalía, como la latencia del proxy o un código de error HTTP
- La gravedad de la anomalía. La gravedad puede ser leve, moderada o grave, según su nivel de confianza en el modelo. Un nivel de confianza bajo indica que la gravedad es leve, mientras que un nivel de confianza alto indica que es grave.
Requisitos previos para usar Anomalías de operaciones
Para usar Anomalías de operaciones:
- El complemento de AAPI Ops debe estar habilitado para tu organización. Consulta Habilita AAPI Ops en una organización.
- Los usuarios de Anomalías de operaciones deben tener los roles obligatorios para AAPI Ops.
- Los usuarios que investigan anomalías en el panel también necesitan el rol
roles/logging.viewer.
Cómo ver las anomalías detectadas por Anomalías de operaciones
Cuando Anomalías de operaciones detecta una anomalía, muestra los detalles de la anomalía en el panel correspondiente. Puedes investigar la anomalía en los paneles de Supervisión de API y tomar las medidas adecuadas si es necesario. También puedes crear una alerta que te notifique si ocurren eventos similares en el futuro.
El panel de Anomalías de operaciones en la IU de Apigee es tu fuente principal de información sobre las anomalías de operaciones detectadas. En el panel, se muestra una lista de anomalías recientes.
Para abrir el panel de Anomalías de operaciones, sigue estos pasos:
- Accede a la IU de Apigee en la consola de Cloud.
- Cambia a la organización que deseas supervisar.
- En el menú de la izquierda, selecciona Análisis > Anomalías de operaciones.
Se mostrará el panel de Anomalías de operaciones.
De manera predeterminada, el panel muestra anomalías que ocurrieron durante la hora anterior. Si no se detectaron anomalías durante ese período, no se mostrarán filas en el panel. Puedes seleccionar un intervalo de tiempo mayor en el menú de intervalos de tiempo en la parte superior derecha del panel.
Cada fila de la tabla corresponde a una anomalía detectada y muestra la siguiente información:
- La fecha y hora de la anomalía.
- Un breve resumen de la anomalía, incluido el proxy en el que ocurrió y el código de falla que la activó.
- El entorno en el que se produjo la anomalía.
- La región en la que se produjo la anomalía.
- Gravedad del evento de la anomalía: leve, moderado o grave. La gravedad se basa en una medida estadística (valor p) de la probabilidad de que se genere el evento por casualidad (mientras menos probable sea el evento, mayor será su gravedad).
También puedes investigar una anomalía en los paneles de Supervisión de API, que muestran varios gráficos de datos recientes del tráfico de la API.
Cómo funciona la detección de anomalías
La detección de anomalías implica las siguientes etapas:
Entrenar modelos
Anomalías de operaciones funciona mediante el entrenamiento de un modelo del comportamiento de tus proxies de API a partir de datos históricos de series temporales. No es necesario que realices ninguna acción para entrenar el modelo. Apigee crea y entrena de forma automática modelos de las seis horas anteriores de los datos de API. Por lo tanto, Apigee requiere un mínimo de seis horas de datos en un proxy de API a fin de entrenar el modelo antes de que pueda registrar una anomalía.
El objetivo del entrenamiento es mejorar la exactitud del modelo, que, luego, se puede probar con datos históricos. La forma más simple de probar la exactitud de un modelo es calcular su tasa de error, la suma de falsos positivos y falsos negativos, dividida por la cantidad total de eventos previstos.
Registra eventos de anomalía
En el entorno de ejecución, Anomalías de operaciones compara el comportamiento actual de los proxies de API con el comportamiento que predice el modelo. Anomalías de operaciones puede determinar, con un nivel de confianza específico, cuando una métrica operativa excede el valor previsto. Por ejemplo, cuando la tasa de errores 5xx supera la tasa que predice el modelo.
Cuando Apigee detecta una anomalía, registra automáticamente el evento en el panel de Anomalías de operaciones. La lista de eventos que se muestra en el panel incluye todas las anomalías detectadas, además de las alertas activadas.