# Alertas Crie regras de alerta para enviar um evento de alerta quando uma [métrica](https://docs.equinix.com/pt-BR/observability/streaming-data/metrics.md) 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ágina[Métricas](https://docs.equinix.com/pt-BR/observability/streaming-data/metrics.md). ## Criar um alerta[​](#criar-um-alerta "Link direto para 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 * API 1. No menu *Observabilidade*, clique em **Fluxos de Dados** . 2. Selecione um Fluxo no *Inventário de Fluxo* . ![](https://docs.equinix.com/pt-BR/assets/images/stream-inventory-49d715a84f2a27ab0ad7065aa1b5a12c.png) 3. Na página *Detalhes do Stream* , no menu suspenso *Ações* , clique em **Adicionar Alertas**. ![](https://docs.equinix.com/pt-BR/assets/images/alerts-add-alert-d701c09d768421435f2fd8270e33d51e.png) 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*. ![](https://docs.equinix.com/pt-BR/assets/images/alerts-add-details-1260da4bcd4f5900148fd838e9078239.png) 5. Clique em **Avançar** 6. Selecione na lista a conexão ou porta à qual deseja aplicar o alerta. ![](https://docs.equinix.com/pt-BR/assets/images/alerts-add-resources-9a1f936ea57fccc5f180adc048bf93c5.png) 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** . ![](https://docs.equinix.com/pt-BR/assets/images/alerts-confirmation-56da2a51526d3a408d68aab8e685f88d.png) Para criar um alerta, envie uma `POST` solicitação para o [`/fabric/v4/streams/{streamId}/alertRules`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/stream-alert-rules/createstreamalertrules.md) terminal. Exemplo de solicitação cURL: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//alertRules' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "METRIC_ALERT", "name": "", "description": "", "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": "", "description": "", "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[​](#criando-alertas-inteligentes---latência "Link direto para Criando alertas inteligentes - Latência") Para fluxos em que você [conectou áreas metropolitanas](https://docs.equinix.com/pt-BR/observability/streaming-data/api-managing-assets.md), 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 * API Para criar uma regra de alerta inteligente, siga as mesmas etapas para [Criar um Alerta](#creating-an-alert)e: 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**. ![](https://docs.equinix.com/pt-BR/assets/images/alerts-smart-latency-c42d0ce4f3d56c8da9eb3c2a622cebdc.png) 3. Selecione uma ou mais estações de metrô às quais deseja aplicar uma regra de alerta inteligente. ![](https://docs.equinix.com/pt-BR/assets/images/alerts-smart-metro-afc211583d4ddce8b1c986af8654b5cf.png) 4. Clique em **Enviar** Seu alerta aparece na lista de alertas. ![](https://docs.equinix.com/pt-BR/assets/images/alerts-smart-list-4f495a14e11fe1257c1d0aff55e77dee.png) Para criar uma regra de alerta inteligente, envie uma `POST` solicitação ao [`/fabric/v4/streams/{streamId}/alertRules`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/stream-alert-rules/createstreamalertrules.md) terminal. Especifique a métrica específica do mercado estratégico para a qual você está criando o alerta no `metricSelector`objeto, o mercado estratégico anexado ao fluxo que você está adicionando como recurso no `resourceSelector`objeto e especifique o `detectionMethod.type` como `OUTLIER`. ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//alertRules' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "METRIC_ALERT", "name": "", "description": "", "enabled": true, "metricSelector": { "include": [ "equinix.fabric.metro._.latency" ] }, "resourceSelector": { "include": [ "/fabric/v4/metros/{metro_code}" ] }, "detectionMethod": { "type": "OUTLIER" } }' ``` ## Recuperando seus alertas[​](#recuperando-seus-alertas "Link direto para Recuperando seus alertas") * Portal * API 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* . ![](https://docs.equinix.com/pt-BR/assets/images/stream-inventory-49d715a84f2a27ab0ad7065aa1b5a12c.png) 3. Clique em **Alertas**. ![](https://docs.equinix.com/pt-BR/assets/images/alerts-list-5524a9aad0ccf5b74a49a4966b74d92e.png) Para obter os detalhes de um alerta, envie uma `GET` solicitação para o [`/fabric/v4/streams/{streamId}/alertRules/{alertRuleId}`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/stream-alert-rules/getstreamalertrulebyuuid.md) terminal. Exemplo de solicitação cURL: ``` curl -X 'GET' 'https://api.equinix.com/fabric/v4/streams//alertRules/' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' ``` 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": "", "description": "", "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[​](#excluindo-um-alerta "Link direto para Excluindo um alerta") * Portal * API Para excluir um alerta: 1. No menu *Observabilidade*, clique em **Fluxos de Dados** . 2. Selecione um Fluxo no *Inventário de Fluxo* . ![](https://docs.equinix.com/pt-BR/assets/images/stream-inventory-49d715a84f2a27ab0ad7065aa1b5a12c.png) 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**. ![](https://docs.equinix.com/pt-BR/assets/images/alerts-remove-fdea58374bc7c8af0e287139377896d9.png) Para excluir um alerta, envie uma `DELETE` solicitação para o [`/fabric/v4/streams/{streamId}/alertRules/{alertRuleId}`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/stream-alert-rules/deletestreamalertrulebyuuid.md) terminal. Exemplo de solicitação cURL: ``` curl -X DELETE 'https://api.equinix.com/fabric/v4/streams//alertRules/' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' ``` 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": "", "description": "", "state": "INACTIVE", "enabled": true, "metricName": "equinix.fabric.port.bandwidth_tx.usage", "resourceSelector": { "include": [ "*/ports/" ] }, "windowSize": "PT15M", "operand": "ABOVE", "warningThreshold": "43000000", "criticalThreshold": "45000000", "changeLog": { "createdBy": "testuser", "createdDateTime": "2025-02-04T23:17:54.323427936Z" } } ```