Alertas

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

nota

Para recibir el evento desencadenado por una alerta, debe ser capaz de recibir eventos de una transmisión a la que tiene una suscripción en un fregadero 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 admitidas, consulte la páginaMétricas.

Crear una alerta

Prerrequisito: Para agregar una regla de alerta, debe tener un flujo creado con recursos de puerto y / o conexión conectados y métrica habilitada

Portal

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

2. Seleccione un Stream desde el Stream Inventario.

   

3. En la página Stream Details, en el menú desplegable Acciones, haga clic en Agregar alertas.

   

4. En la página Add Alert, ingrese los parámetros de su regla.

   • Seleccione la Conexión o Port Metric en el menú desplegable Select a Metric.
   • Dale un nombre a tu Alerta.
   • Añadir una descripción de 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 desencadenar un evento crítico en el campo umbral crítico.

   

5. Haga clic en Siguiente.

6. Seleccione la conexión o puerto para aplicar la alerta de la lista.

   

7. Haga clic en Enviar.

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

API

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

Solicitud de curl de muestra:

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 donde ha adjuntado metros, puede crear alertas inteligentes para los umbrales de latencia. Estas alertas impulsadas por IA analizan los datos históricos de latencia en sus ubicaciones metropolitanas utilizando aprendizaje automático para establecer el rendimiento de referencia y generar umbrales de alerta inteligentes, eliminando la necesidad de configuración manual de 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. Dale a tu alerta un nombre y una descripción (opcional). Haga clic en Siguiente.

   

3. Seleccione un Metro o Metro para 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 POST solicitud al /fabric/v4/streams/{streamId}/alertRulespunto final.

Especifique la métrica específica de Metro para la que está creando la alerta en el metricSelector objeto, el Metro que está adjunto a la corriente que está agregando como recurso en el resourceSelector objeto, y especifique el detectionMethod.type AS 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"
    }
}'

Recuperar sus alertas

Portal

Para ver la lista de Alertas para un Stream:

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

2. Seleccione un Stream desde el Stream Inventario.

   

3. Haga clic en Alertas.

   

API

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

Solicitud de curl de muestra:

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"
    }
}

Eliminar una alerta

Portal

Para eliminar una alerta:

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

2. Seleccione un Stream desde el Stream Inventario.

   

3. Haga clic en Alertas.

4. En la lista de alertas, haga clic en el menú de opciones del que desea eliminar, haga clic en Eliminar alerta.

   

API

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

Solicitud de curl de muestra:

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"
    }
}