Alertas

Crie regras de alerta para enviar um evento de alerta quando uma métrica ultrapassar um valor limite definido. Os alertas podem ser acionados em um warningThreshold e em um criticalThreshold, acionando um evento de alerta se o valor da métrica cair abaixo ou exceder o limite esperado.

observação

Para receber o evento acionado por um alerta, você precisa ser capaz de receber eventos de um fluxo no qual você tem uma assinatura em um coletor de sua escolha. Os eventos acionados por um Alerta não estão disponíveis no Portal do Cliente ou no API.

Para ver a lista de métricas compatíveis, consulte a páginaMétricas.

Criar um alerta

Pré-requisito: Para adicionar uma regra de alerta, você deve ter um fluxo criado com os recursos de porta e/ou conexão anexados e a métrica ativada

Portal

1. No menu Observabilidade, clique em Fluxos de Dados .

2. Selecione um Fluxo no Inventário de Fluxo .

   

3. Na página Detalhes do Stream , no menu suspenso Ações , clique em Adicionar Alertas.

   

4. Na página Adicionar alerta, insira os parâmetros da regra.

   • Selecione a métrica de conexão ou porta no menu suspenso Selecionar uma métrica.
   • Dê um nome ao seu alerta.
   • Adicione uma descrição ao alerta (opcional).
   • Selecione o valor do operando: ABOVE ou BELOW.
   • Selecione um tamanho de janela no menu suspenso.
   • Defina o valor para acionar um evento de aviso no campo Limite de aviso.
   • Defina o valor para acionar um evento crítico no campo Limite crítico.

   

5. Clique em Avançar

6. Selecione na lista a conexão ou porta à qual deseja aplicar o alerta.

   

7. Clique em Enviar.

Na tela de confirmação, você pode adicionar mais recursos ao seu alerta, adicionar uma assinatura ao seu stream para receber seu alerta ou adicionar outro alerta. Para ver os detalhes do seu novo alerta, clique em Exibir detalhes do alerta .

API

Para criar um alerta, envie uma POST solicitação para o /fabric/v4/streams/{streamId}/alertRules terminal.

Exemplo de solicitação 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
    }
}'

Exemplo de resposta:

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

Criando alertas inteligentes - Latência

Para fluxos em que você conectou áreas metropolitanas, você pode criar alertas inteligentes para limites de latência. Esses alertas alimentados por IA analisam dados históricos de latência em seus locais metropolitanos usando aprendizado de máquina para estabelecer o desempenho de linha de base e gerar limites de alertas inteligentes, eliminando a necessidade de configuração manual de alertas.

Portal

Para criar uma regra de alerta inteligente, siga as mesmas etapas para Criar um Alertae:

1. Selecione a métrica de latência do mercado Fabric no menu suspenso Selecionar uma métrica.

2. Dê ao alerta um nome e uma descrição (opcional). Clique em Avançar.

   

3. Selecione uma ou mais estações de metrô às quais deseja aplicar uma regra de alerta inteligente.

   

4. Clique em Enviar

Seu alerta aparece na lista de alertas.

API

Para criar uma regra de alerta inteligente, envie uma POST solicitação ao /fabric/v4/streams/{streamId}/alertRules terminal.

Especifique a métrica específica do mercado estratégico para a qual você está criando o alerta no metricSelectorobjeto, o mercado estratégico anexado ao fluxo que você está adicionando como recurso no resourceSelectorobjeto e especifique o 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"
    }
}'

Recuperando seus alertas

Portal

Para ver a lista de alertas de um fluxo:

1. No menu Observabilidade, clique em Fluxos de Dados .

2. Selecione um Fluxo no Inventário de Fluxo .

   

3. Clique em Alertas.

   

API

Para obter os detalhes de um alerta, envie uma GET solicitação para o /fabric/v4/streams/{streamId}/alertRules/{alertRuleId} terminal.

Exemplo de solicitação cURL:

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

Exemplo de resposta:

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

Excluindo um alerta

Portal

Para excluir um alerta:

1. No menu Observabilidade, clique em Fluxos de Dados .

2. Selecione um Fluxo no Inventário de Fluxo .

   

3. Clique em Alertas.

4. Na lista de Alertas, clique no menu de opções do que você deseja excluir e clique em Remover Alerta.

   

API

Para excluir um alerta, envie uma DELETE solicitação para o /fabric/v4/streams/{streamId}/alertRules/{alertRuleId} terminal.

Exemplo de solicitação cURL:

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

Exemplo de resposta:

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