Alertas

Cree reglas de alerta para enviar un evento de alerta cuando una métrica cruce 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 supera el umbral esperado.

nota

Para recibir el evento activado por una alerta, debe poder 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 el API.

Para ver la lista de métricas admitidas, consulte la páginaMétricas.

Crear una alerta

Requisito previo: Para añadir una regla de alerta, debe tener una secuencia creada con recursos de puerto y/o conexión conectados y habilitada la métrica

Portal

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

2. Seleccione una transmisión del inventario de flujos .

   

3. En la página Detalles de la transmisión, 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 menú desplegable Seleccionar 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 transmisión 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 POST solicitud al /fabric/v4/streams/{streamId}/alertRulespunto final.

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 las transmisiones en las que ha adjuntado áreas metropolitanas, puede crear alertas inteligentes para umbrales de latencia. Estas alertas basadas en IA analizan los datos históricos de latencia en sus ubicaciones metropolitanas utilizando aprendizaje automático para establecer el rendimiento de línea base 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 de latencia metropolitana de Fabric en el menú desplegable Seleccionar una métrica.

2. Proporcione 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 POST solicitud al /fabric/v4/streams/{streamId}/alertRules punto final.

Especifique la métrica específica del área metropolitana para la que está creando la alerta en el metricSelector objeto, el área metropolitana que está asociada al flujo que está añadiendo 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"
    }
}'

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 una transmisión del inventario de flujos .

   

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} punto final.

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 una transmisión del inventario de flujos .

   

3. Haga clic en Alertas.

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

   

API

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

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