# Alertes Créez des règles d'alerte pour envoyer un événement d'alerte lorsqu'une [mesure](https://docs.equinix.com/fr-CA/observability/streaming-data/metrics.md) dépasse une valeur de seuil définie. Les alertes peuvent se déclencher sur un `warningThreshold` et un `criticalThreshold`, déclenchant un événement d'alerte si la valeur de la mesure tombe en dessous ou dépasse le seuil attendu. > **Remarque** > > Afin de recevoir l'événement déclenché par une alerte, vous devez être en mesure de recevoir des événements d'un flux auquel vous êtes abonné dans un puits de votre choix. Les événements déclenchés par une alerte ne sont pas disponibles sur le Portail client ou le API. Pour afficher la liste des métriques prises en charge, reportez-vous à la page[métriques](https://docs.equinix.com/fr-CA/observability/streaming-data/metrics.md). ## Création d'une alerte[​](#création-dune-alerte "Lien direct vers Création d'une alerte") Condition préalable : Pour ajouter une règle d'alerte, vous devez avoir créé un flux avec des ressources de port et/ou de connexion associées et une métrique activée * Portal * API 1. Dans le menu *observabilité*, cliquez sur **flux de données** . 2. Sélectionnez un flux dans l'*inventaire des flux* . ![](https://docs.equinix.com/fr-CA/assets/images/stream-inventory-49d715a84f2a27ab0ad7065aa1b5a12c.png) 3. Sur la page *Détails du flux*, dans le menu déroulant *actions* , cliquez sur **Ajouter des alertes**. ![](https://docs.equinix.com/fr-CA/assets/images/alerts-add-alert-d701c09d768421435f2fd8270e33d51e.png) 4. Sur la page *Ajouter une alerte*, saisissez les paramètres de votre règle. * Dans la liste déroulante *sélectionner une* mesure de connexion ou de port. * Nommez votre alerte. * Ajouter une description de l'alerte (facultatif). * Sélectionnez la valeur de l'opérande : `ABOVE` ou `BELOW`. * Sélectionnez une taille de fenêtre dans le menu déroulant. * Dans le champ \_seuil d'\_avertissement, définissez la valeur de déclenchement d'un événement d'avertissement. * Dans le champ *seuil critique*, définissez la valeur de déclenchement d'un événement critique. ![](https://docs.equinix.com/fr-CA/assets/images/alerts-add-details-1260da4bcd4f5900148fd838e9078239.png) 5. Cliquez sur **suivant** 6. Sélectionnez dans la liste la connexion ou le port auquel appliquer l'alerte. ![](https://docs.equinix.com/fr-CA/assets/images/alerts-add-resources-9a1f936ea57fccc5f180adc048bf93c5.png) 7. Cliquez sur **Envoyer**. À partir de l'écran de confirmation, vous pouvez ajouter d'autres ressources à votre alerte, ajouter un abonnement à votre flux pour recevoir votre alerte ou ajouter une autre alerte. Pour afficher les détails de votre nouvelle alerte, cliquez sur **Afficher les détails de l'alerte** . ![](https://docs.equinix.com/fr-CA/assets/images/alerts-confirmation-56da2a51526d3a408d68aab8e685f88d.png) Pour créer une alerte, envoyez `POST`une demande au [`/fabric/v4/streams/{streamId}/alertRules`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/stream-alert-rules/createstreamalertrules.md)point final. Exemple de requête 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 } }' ``` Exemple de réponse: ``` { "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" } } ``` ### Création d'alertes intelligentes - Latence[​](#création-dalertes-intelligentes---latence "Lien direct vers Création d'alertes intelligentes - Latence") Pour les flux auxquels vous avez [rattaché des Metros](https://docs.equinix.com/fr-CA/observability/streaming-data/api-managing-assets.md), vous pouvez créer des alertes intelligentes pour les seuils de latence. Ces alertes basées sur l'IA analysent les données de latence historiques sur vos sites métropolitains à l'aide de l'apprentissage automatique pour établir les performances de base et générer des seuils d'alerte SMART, éliminant ainsi le besoin de configuration manuelle des alertes. * Portal * API Pour créer une règle d'alerte SMART, suivez les mêmes étapes que pour la [création d'une alerte](#creating-an-alert) et : 1. Dans le menu déroulant *sélectionner une mesure*, sélectionnez la *mesure* **de latence Fabric Metro**. 2. Donnez un nom et une description à votre alerte (facultatif). Cliquez sur **suivant**. ![](https://docs.equinix.com/fr-CA/assets/images/alerts-smart-latency-c42d0ce4f3d56c8da9eb3c2a622cebdc.png) 3. Sélectionnez une ou plusieurs métropoles auxquelles appliquer une règle d'alerte intelligente. ![](https://docs.equinix.com/fr-CA/assets/images/alerts-smart-metro-afc211583d4ddce8b1c986af8654b5cf.png) 4. Cliquez sur **Envoyer** Votre alerte apparaît dans la liste des alertes. ![](https://docs.equinix.com/fr-CA/assets/images/alerts-smart-list-4f495a14e11fe1257c1d0aff55e77dee.png) Pour créer une règle d'alerte intelligente, envoyez une `POST` demande au [`/fabric/v4/streams/{streamId}/alertRules`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/stream-alert-rules/createstreamalertrules.md)point final. Dans l'objet, spécifiez la mesure spécifique à la zone métropolitaine pour laquelle vous créez l'alerte`metricSelector`, la zone métropolitaine associée au flux que vous ajoutez en tant que ressource dans l'`resourceSelector`objet, puis spécifiez la `detectionMethod.type` zone comme `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" } }' ``` ## Récupération de vos alertes[​](#récupération-de-vos-alertes "Lien direct vers Récupération de vos alertes") * Portal * API Pour afficher la liste des alertes pour un flux: 1. Dans le menu *observabilité*, cliquez sur **flux de données** . 2. Sélectionnez un flux dans l'*inventaire des flux* . ![](https://docs.equinix.com/fr-CA/assets/images/stream-inventory-49d715a84f2a27ab0ad7065aa1b5a12c.png) 3. Cliquez sur **alertes**. ![](https://docs.equinix.com/fr-CA/assets/images/alerts-list-5524a9aad0ccf5b74a49a4966b74d92e.png) Pour obtenir les détails d'une alerte, envoyez une `GET` demande au [`/fabric/v4/streams/{streamId}/alertRules/{alertRuleId}`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/stream-alert-rules/getstreamalertrulebyuuid.md)terminal. Exemple de requête cURL: ``` curl -X 'GET' 'https://api.equinix.com/fabric/v4/streams//alertRules/' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' ``` Exemple de réponse: ``` { "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" } } ``` ## Suppression d'une alerte[​](#suppression-dune-alerte "Lien direct vers Suppression d'une alerte") * Portal * API Pour supprimer une alerte: 1. Dans le menu *observabilité*, cliquez sur **flux de données** . 2. Sélectionnez un flux dans l'*inventaire des flux* . ![](https://docs.equinix.com/fr-CA/assets/images/stream-inventory-49d715a84f2a27ab0ad7065aa1b5a12c.png) 3. Cliquez sur **alertes**. 4. Dans la liste des alertes, cliquez sur le menu d'options de celle que vous souhaitez supprimer, puis sur **Supprimer l'alerte**. ![](https://docs.equinix.com/fr-CA/assets/images/alerts-remove-fdea58374bc7c8af0e287139377896d9.png) Pour supprimer une alerte, envoyez `DELETE`une demande au [`/fabric/v4/streams/{streamId}/alertRules/{alertRuleId}`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/stream-alert-rules/deletestreamalertrulebyuuid.md)point final. Exemple de requête cURL: ``` curl -X DELETE 'https://api.equinix.com/fabric/v4/streams//alertRules/' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' ``` Exemple de réponse: ``` { "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" } } ```