Alertas

Cree reglas de alerta para enviar un evento de alerta cuando una métrica cruce un valor umbral definido. Las alertas pueden activarse tanto en un warningThreshold como en un criticalThreshold, activando un evento de alerta si el valor de la métrica cae por debajo o supera el umbral esperado.

nota

Para recibir el evento desencadenado por una Alerta, necesita poder recibir eventos de un flujo al que esté suscrito en un sumidero de su elección. Los eventos desencadenados por una Alerta no están disponibles en el Portal del Cliente ni en la API.

Para ver la lista de métricas compatibles, consulte la página Métricas.

Crear una alerta

Requisito previo: Para añadir una regla de alerta, debe tener un flujo creado con los recursos Puerto y/o Conexión adjuntos y la métrica activada

Portal

1. En el menú Observabilidad, haga clic en Flujos de datos.

2. Seleccione un flujo en el Inventario de flujos.

   

3. En la página Detalles del flujo, en el menú desplegable Acciones, haga clic en Añadir alertas.

   

4. En la página Añadir alerta, introduzca los parámetros de su regla.

   • Seleccione la métrica de conexión o puerto en el desplegable Seleccione una métrica.
   • Ponga nombre a su alerta.
   • Añada una descripción de la alerta (opcional).
   • Seleccione el valor del operando: ABOVE o BELOW.
   • Seleccione un tamaño de ventana en el desplegable.
   • Establezca el valor para activar un evento de advertencia en el campo Umbral de advertencia.
   • Establezca el valor para activar un evento crítico en el campo Umbral crítico.

   

5. Haga clic en Siguiente

6. Seleccione de la lista la conexión o el puerto al que aplicar la alerta.

   

7. Haga clic en Enviar.

Desde la pantalla de confirmación, puede añadir más recursos a su alerta, añadir una suscripción a su flujo para recibir su alerta o añadir otra alerta. Para ver los detalles de su nueva alerta, haga clic en Ver detalles de la alerta.

API

Para crear una alerta, envíe una solicitud POST al punto final /fabric/v4/streams/{streamId}/alertRules.

Ejemplo de solicitud cURL:

curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams/<streamId>/alertRules' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
    "type": "METRIC_ALERT",
    "name": "<alert_rule_name>",
    "description": "<alert_rule_desc>",
    "enabled": "true",
    "metricSelector": {
        "include": [
            "equinix.fabric.port.bandwidth_tx.usage"
        ]
    },
    "resourceSelector": {
        "include": [
            "/fabric/v4/ports/780d384f-2eb6-4c07-ac89-ea106ca12814"
        ]
    },
    "detectionMethod": {
        "type": "THRESHOLD",
        "operand": "ABOVE",
        "windowSize": "PT5M",
        "warningThreshold": 200000,
        "criticalThreshold": 300000
    }
}'

Respuesta de muestra:

{
    "href": "https://api.equinix.com/fabric/v4/streams/128cfe7c-e24f-4b1b-8a4f-680cd650c46c/alertRules/28da40d8-09bf-49f2-a02d-af34210f275e",
    "uuid": "128cfe7c-e24f-4b1b-8a4f-680cd650c46c",
    "type": "METRIC_ALERT",
    "name": "<alert_rule_name>",
    "description": "<alert_rule_name>",
    "state": "ACTIVE",
    "enabled": true,
    "metricSelector": {
        "include": [
            "equinix.fabric.port.bandwidth_tx.usage"
        ]
    },
    "resourceSelector": {
        "include": [
            "/fabric/v4/ports/780d384f-2eb6-4c07-ac89-ea106ca12814"
        ]
    },
    "detectionMethod": {
        "type": "THRESHOLD",
        "operand": "ABOVE",
        "windowSize": "PT5M",
        "warningThreshold": 200000,
        "criticalThreshold": 300000
    }
    "changeLog": {
        "createdBy": "testuser",
        "createdDateTime": "2025-02-04T23:17:54.323427936Z"
    }
}

Creación de alertas inteligentes - Latencia

Para los flujos en los que tenga Metros adjuntos, puede crear alertas inteligentes para umbrales de latencia. Estas alertas impulsadas por IA analizan los datos históricos de latencia en sus ubicaciones de metro utilizando el aprendizaje automático para establecer el rendimiento de referencia y generar umbrales de alerta inteligentes, eliminando la necesidad de configurar manualmente las alertas.

Portal

Para crear una regla de alerta inteligente, siga los mismos pasos para Crear una alerta, y:

1. Seleccione la métrica Fabric Metro Latency en el menú desplegable Select a Metric.

2. Dé a su alerta un nombre y una descripción (opcional). Haga clic en Siguiente.

   

3. Seleccione un Metro o Metros a los que aplicar una regla de alerta inteligente.

   

4. Haga clic en Enviar

Su alerta aparece en la lista de alertas.

API

Para crear una regla de alerta inteligente, envíe una solicitud POST al punto final /fabric/v4/streams/{streamId}/alertRules.

Especifique la métrica específica del Metro para el que está creando la alerta en el objeto metricSelector, el Metro que se adjunta al flujo que está añadiendo como recurso en el objeto resourceSelector, y especifique el detectionMethod.type como OUTLIER.

curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams/<streamId>/alertRules' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
    "type": "METRIC_ALERT",
    "name": "<alert_rule_name>",
    "description": "<alert_rule_description>",
    "enabled": true,
    "metricSelector": {
        "include": [
            "equinix.fabric.metro.<metro_code>_<metro_code>.latency"
        ]
    },
    "resourceSelector": {
        "include": [
            "/fabric/v4/metros/{metro_code}"
        ]
    },
    "detectionMethod": {
        "type": "OUTLIER"
    }
}'

Cómo recuperar sus alertas

Portal

Para ver la lista de Alertas de un Flujo:

1. En el menú Observabilidad, haga clic en Flujos de datos.

2. Seleccione un flujo en el Inventario de flujos.

   

3. Haga clic en Alertas.

   

API

Para obtener los detalles de una alerta, envíe una solicitud GET al punto final /fabric/v4/streams/{streamId}/alertRules/{alertRuleId}.

Ejemplo de solicitud cURL:

curl -X 'GET' 'https://api.equinix.com/fabric/v4/streams/<streamId>/alertRules/<alertRuleId>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Respuesta de muestra:

{
    "href": "https://api.equinix.com/fabric/v4/streams/128cfe7c-e24f-4b1b-8a4f-680cd650c46c/alertRules/28da40d8-09bf-49f2-a02d-af34210f275e",
    "uuid": "128cfe7c-e24f-4b1b-8a4f-680cd650c46c",
    "type": "METRIC_ALERT",
    "name": "<alert_rule_name>",
    "description": "<alert_rule_name>",
    "state": "ACTIVE",
    "enabled": true,
    "metricSelector": {
        "include": [
            "equinix.fabric.port.bandwidth_tx.usage"
        ]
    },
    "resourceSelector": {
        "include": [
            "/fabric/v4/ports/780d384f-2eb6-4c07-ac89-ea106ca12814"
        ]
    },
    "detectionMethod": {
        "type": "THRESHOLD",
        "operand": "ABOVE",
        "windowSize": "PT5M",
        "warningThreshold": 200000,
        "criticalThreshold": 300000
    }
    "changeLog": {
        "createdBy": "testuser",
        "createdDateTime": "2025-02-04T23:17:54.323427936Z"
    }
}

Borrar una alerta

Portal

Para borrar una Alerta:

1. En el menú Observabilidad, haga clic en Flujos de datos.

2. Seleccione un flujo en el Inventario de flujos.

   

3. Haga clic en Alertas.

4. En la lista de Alertas, haga clic en el menú de opciones de la que desee eliminar, haga clic en Eliminar Alerta.

   

API

Para eliminar una alerta, envíe una solicitud DELETE al punto final /fabric/v4/streams/{streamId}/alertRules/{alertRuleId}.

Ejemplo de solicitud cURL:

curl -X DELETE 'https://api.equinix.com/fabric/v4/streams/<streamId>/alertRules/<alertRuleId>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Respuesta de muestra:

{
    "href": "https://api.equinix.com/fabric/v4/streams/128cfe7c-e24f-4b1b-8a4f-680cd650c46c/alertRules/28da40d8-09bf-49f2-a02d-af34210f275e",
    "uuid": "28da40d8-09bf-49f2-a02d-af34210f275e",
    "type": "METRIC_ALERT",
    "name": "<alert_rule_name>",
    "description": "<alert_rule_name>",
    "state": "INACTIVE",
    "enabled": true,
    "metricName": "equinix.fabric.port.bandwidth_tx.usage",
    "resourceSelector": {
        "include": [
            "*/ports/<uuid>"
        ]
    },
    "windowSize": "PT15M",
    "operand": "ABOVE",
    "warningThreshold": "43000000",
    "criticalThreshold": "45000000",
    "changeLog": {
        "createdBy": "testuser",
        "createdDateTime": "2025-02-04T23:17:54.323427936Z"
    }
}