Apigee te permite crear alertas que se activan con patrones de tráfico de API específicos, por ejemplo, cuando la tasa de error de una API alcanza un umbral predeterminado. Las operaciones de la API amplían esta capacidad con alertas de anomalías, que se activan cada vez que Apigee detecta datos inusuales de tráfico de la API. La ventaja de las alertas de anomalías es que no tienes que definir las condiciones exactas para cada anomalía. AAPI Ops determina las condiciones de anomalía adecuadas mediante métodos estadísticos y las actualiza constantemente según los datos de tráfico recientes.
Mediante la detección de anomalías, permites que Apigee detecte problemas de tráfico y rendimiento, en lugar de priorizar las condiciones de alerta.
Cuando AAPI-Ops detecta una anomalía, muestra el evento en el panel de Eventos de anomalías. Sin embargo, no genera una alerta automáticamente para la anomalía. Si examinas una anomalía en el panel y decides que deseas recibir alertas sobre eventos similares en el futuro, puedes crear una alerta de anomalías y configurar una notificación, que te enviará un mensaje cada vez que se detecte la anomalía.
Antes de crear una alerta de anomalía, asegúrate de que se te asignaron las funciones necesarias para AAPI Ops.
Para crear una alerta de anomalía en el panel de políticas de alertas, haz lo siguiente:
Nota: Abre el panel Crear política de alertas en una pestaña nueva si deseas seguir los pasos que se indican a continuación.
Haz clic en AGREGAR CONDICIÓN: Se abrirá una ventana nueva en la que podrás agregar la condición de alerta.
Opcional: Agrega un título para la condición en el campo Condición sin título. Lo dejaremos en blanco para este ejemplo, en cuyo caso la condición recibe un título según la configuración predeterminada.
En el campo Busca el tipo de recurso y métrica, escribe
anomaly
y, luego, selecciona Recuento de eventos de anomalía de Apigee.
Haz clic en MOSTRAR CONFIGURACIÓN AVANZADA y, en Agregación avanzada, selecciona delta en el campo Alineador. Esto especifica cómo se agregan los datos durante cada período, que puedes configurar en el campo Período.
Con la configuración delta, el valor agregado es igual al valor de datos finales en el período menos el valor de los datos iniciales.
En el panel Configuración, establece el Umbral en 0.5
(Cualquier número entre 0 y 1 funcionará para el umbral).
Con este valor, una sola anomalía supera el umbral y activa la alerta.
Haz clic en Agregar. Esto te llevará de vuelta a la página Crear política de alertas, en la que podrás ver la condición que acabas de crear.
En este punto, puedes elegir una de las siguientes opciones:
Hacer clic en AGREGAR condición para crear otra condición para la alerta.
Haz clic en SIGUIENTE para ir al siguiente paso, en el que tendrás la opción de crear una notificación de la alerta, como se describe en la siguiente sección.
Si no quieres crear una notificación, haz clic en SIGUIENTE dos veces sin ingresar nada para omitir los pasos 2 y 3.
Haz clic en GUARDAR para guardar la alerta.
Crea una notificación para una alerta
Si deseas recibir una notificación de inmediato cuando ocurra un incidente, puedes crear una notificación para la alerta. Cuando se activa la alerta, Apigee te envía una notificación. Puedes elegir cualquiera de los siguientes canales para recibir la notificación:
Correo electrónico
PagerDuty
Slack
Webhooks
A fin de crear una notificación para una alerta, haz lo siguiente:
Si acabas de crear la alerta (como se muestra en el ejemplo anterior) y estás viendo el panel Crear política de alertas, ve al paso siguiente.
De lo contrario, abre el panel Políticas en el panel Alertas de la consola de Cloud y, en la fila de la alerta que creaste, haz clic en el ícono de tres puntos al final de la fila y selecciona Editar.
Esto abrirá el panel Editar política de alertas:
En la sección ¿Qué deseas realizar un seguimiento?, haz clic en SIGUIENTE.
En la sección Quién debe recibir la notificación, selecciona Canales de notificación, donde puedes elegir entre los canales existentes para recibir notificaciones.
Si deseas crear un nuevo canal de notificaciones, selecciona ADMINISTRAR CANALES DE NOTIFICACIONES. Esto abrirá el panel de canales de notificaciones en la consola de Cloud, donde puedes agregar canales. Consulta Cómo crear y administrar canales de notificaciones para obtener más información.
Haga clic en SIGUIENTE. Se mostrarán las opciones a continuación.
En el campo Nombre de la alerta (Alert name), ingresa un nombre para la alerta.
En el campo Documentación (Documentation), ingresa la URL de una página web que proporcione información sobre cómo corregir el problema que causó la alerta. La URL se incluirá en la notificación.
Haz clic en Guardar para crear la alerta.
Cuando se active una alerta, recibirás una notificación que proporciona un resumen del incidente y el momento en que se produjo. La notificación también contiene dos vínculos que te ayudarán a investigar el incidente:
VER INCIDENTE: Visualiza el incidente en la consola de Cloud.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003eApigee offers anomaly alerts that automatically detect unusual API traffic patterns without requiring users to manually define specific anomaly conditions.\u003c/p\u003e\n"],["\u003cp\u003eAnomaly detection events are displayed on the Anomaly Events dashboard, and users can choose to set up anomaly alerts with notifications for similar future events.\u003c/p\u003e\n"],["\u003cp\u003eTo create an anomaly alert, users must navigate to the "Create alerting policy" dashboard in the Google Cloud console and select "Apigee anomaly event count" as the metric.\u003c/p\u003e\n"],["\u003cp\u003eUsers can configure notifications for anomaly alerts to be sent via email, PagerDuty, Slack, or webhooks when an anomaly is detected.\u003c/p\u003e\n"],["\u003cp\u003eWhen an anomaly alert is triggered, notifications include links to view the incident in the Cloud console and an API traffic timeline graph in the API Monitoring Investigate dashboard.\u003c/p\u003e\n"]]],[],null,["# Creating anomaly alerts\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nApigee enables you to create alerts that are triggered by specific API traffic patterns---\nfor example, when an API's\nerror rate reaches a predetermined threshold. AAPI Ops extends this capability with\n*anomaly alerts*, which are triggered whenever Apigee detects unusual API traffic\ndata. The advantage of anomaly alerts is that you don't have to define the exact conditions\nfor each anomaly yourself. AAPI Ops determines the right anomaly conditions using statistical methods,\nand constantly updates them based on recent traffic data.\nUsing anomaly detection, you let Apigee detect traffic and performance issues, rather than\npredetermining the alert conditions yourself.\n| **Important:** \"Anomaly Detection\" describes the Advanced API Operations Anomaly Detection functionality, which is available in the Classic Apigee UI. This functionality is comparable to the \"Operations Anomalies\" functionality in [Apigee UI in Cloud console](https://console.cloud.google.com/apigee). Both are available at this time. See [Operations Anomalies overview](/apigee/docs/api-platform/analytics/operations-anomalies-overview) for information on the Operations Anomalies functionality.\n\nWhen AAPI-Ops detects an anomaly, it displays the event in the Anomaly Events\ndashboard. However, it doesn't automatically raise an alert for\nthe anomaly. If you examine an anomaly in the dashboard and decide you want to be alerted about\nsimilar event in future, you can create an anomaly alert\nand set up a notification, which sends you a message whenever the anomaly is detected.\n\nBefore creating an anomaly alert, make sure you have been assigned the\n[required roles](/apigee/docs/aapi-ops#required-roles-for-aapi-ops)\nfor AAPI Ops.\n\nTo create an anomaly alert in the Alerting policy dashboard, do the following:\n\n1. Open the\n [Create alerting policy](https://console.cloud.google.com/monitoring/alerting/policies/create?) dashboard in the Google Cloud console.\n\n **Note:** Open the Create alerting policy dashboard in a new tab if you want to follow\n the steps below.\n2. Click **ADD CONDITION** . This opens a new window where you can add the alert condition.\n\n\n3. Optional: Add a title for the condition in the **Untitled Condition** field. We'll leave it blank for this example, in which case the condition is given a default title.\n4. In the **Find resource type and metric** field, type\n\n ```\n anomaly\n ```\n\n and then select **Apigee anomaly event count**.\n5. Click **SHOW ADVANCED SETTINGS** and in the **Advanced Aggregation** pane,\n select **delta** in the **Aligner** field. This specifies how the data is\n aggregated over each time period, which you can set in the **Period** field.\n With the **delta** setting, the aggregated value equals the\n final data value in the time period minus the initial data value.\n\n6. In the **Configuration** pane, set the **Threshold** to **0.5**.\n (Any number between 0 and 1 will work for the threshold.)\n With this value, a single anomaly exceeds the threshold and triggers the alert.\n\n7. Click **Add** . This takes you back to the **Create alerting policy** page\n where you can see the condition you just created.\n\nAt this point you can choose to either:\n\n- Click **ADD Condition** to create another condition for the alert, or\n- Click **NEXT** to go to the next step, where you will have the option to [create a notification for the\n alert](#creating-a-notification-for-an-alert), as described in the next section.\n\nIf you don't want to create a notification, click **NEXT** twice\nwithout entering anything to bypass Steps 2 and 3.\n\nClick **SAVE** to save the alert.\n\nCreating a notification for an alert\n------------------------------------\n\nIf you want to be notified immediately when an incident occurs, you can create\na notification for the alert. When the alert is triggered, Apigee sends you\na notification. You can choose any of the following channels to receive\nthe notification:\n\n- Email\n- PagerDuty\n- Slack\n- Webhooks\n\n| **Note:** Currently, to receive a notification, you must add **org** to the **Group by** field in the alert. This requirement will be removed in a future release.\n\nTo create a notification for an alert:\n\n1. If you just created the alert (as shown in the\n preceding example) and are currently viewing the\n **Create alerting policy** dashboard, skip to the next step.\n\n Otherwise, open the\n [**Policies** pane](https://console.cloud.google.com/monitoring/alerting/policies) in the Cloud console Alerting dashboard, and in\n the row for the alert you created, click the three dots icon at the end\n of the row and select **Edit**.\n\n This opens the **Edit alerting policy** dashboard:\n2. In the **What do you want to track?** section, click **NEXT**.\n\n3. In the **Who should be notified** section, select\n **Notification Channels**, where you can choose from existing channels for receiving\n notifications.\n\n If you want to create a new\n notification channel, select **MANAGE NOTIFICATION CHANNELS** . This\n opens the Notification channels dashboard in the Cloud console, where you can\n add channels. See\n [Create and manage notification channels](https://cloud.google.com/monitoring/support/notification-options) for more details.\n4. Click **NEXT**. This displays the options shown below.\n\n5. In the **Alert name** field, enter a name for the alert.\n6. In the **Documentation** field, enter the URL for a web page that provides information on how to fix the issue that caused the alert. The URL will be included in the notification.\n7. Click **Save** to create the alert.\n\nWhen an alert is triggered, you will receive a notification\nproviding a summary of the incident and when it occurred. The notification\nalso contains two links to help you investigate the incident:\n\n- **VIEW INCIDENT**: View the incident in the Cloud console.\n- **VIEW IN APIGEE** : View a timeline graph of API traffic and related data tables in the [API Monitoring Investigate dashboard](/apigee/docs/api-monitoring/investigate)."]]
