Vous consultez la documentation d'Apigee Edge.
Consultez la
documentation Apigee X. en savoir plus
L'API Monitoring vous permet de créer des règles basées sur des modèles qui déclenchent des alertes en fonction d'un ensemble de conditions prédéfinies. Les alertes de ce type sont appelées alertes fixes et sont les seules compatibles avec la version initiale de l'API Monitoring.
Par exemple, vous pouvez déclencher une alerte fixe dans les cas suivants:
- Le [taux d'erreurs 5xx] [est supérieur à] [10 %] depuis [10 minutes] en provenance de [target mytarget1]
- Le [nombre d'erreurs 2xx] [est inférieur à] [50] depuis [5 minutes] dans la [région us-east-1]
- La [latence p90] [est supérieure à] [750 ms] depuis [10 minutes] sur [proxy myproxy1]
Lorsque les conditions d'une alerte fixe sont remplies, l'API Monitoring génère une alerte pour vous informer du problème. Cependant, vous devez avoir défini les conditions d'alerte spécifiques pour que l'API Monitoring puisse déclencher l'alerte.
Bien que les alertes fixes soient utiles, il peut s'avérer difficile de déterminer les seuils appropriés d'une condition, car les modèles de trafic évoluent au fil du temps. Par exemple, si vous définissez un seuil trop bas, vous allez recevoir des alertes en très grand nombre. Si vous définissez un seuil trop élevé, vous risquez de passer à côté de problèmes ou de pannes critiques.
Détection d'anomalies
La détection d'anomalies permet à Edge de détecter les problèmes de trafic et de performances au lieu de devoir les prédéterminer par vous-même. Edge recherche automatiquement les conditions des anomalies au niveau de l'organisation, de l'environnement et de la région. Lorsqu'une anomalie est détectée, elle est consignée pour être affichée dans le tableau de bord des événements de l'interface utilisateur Edge.
Les détections d'anomalies fonctionnent en appliquant des modèles d'intelligence artificielle (IA) et de machine learning (ML) à vos données d'historique d'API. La détection d'anomalies peut ensuite déclencher des alertes en temps réel pour les scénarios auxquels vous n'avez même pas pensés afin d'améliorer votre productivité et réduire les délais moyens de résolution des problèmes d'API.
Par exemple, des anomalies peuvent être détectées si une nouvelle version d'API entraîne une augmentation inattendue du trafic et de la latence de l'API. Il peut s'agir également d'une version mal configurée sur le backend qui entraîne une augmentation des erreurs de backend signalées par l'API.
Une anomalie détectée comprend les informations suivantes:
- Métrique à l'origine de l'anomalie, telle que la latence du proxy ou un code d'erreur HTTP
- Seuil de l'anomalie. Le seuil peut être léger, modéré ou grave.
Par exemple, Edge peut détecter automatiquement l'une des anomalies suivantes :
- [Augmentation légère] [des erreurs 503] dans [l'environnement prod, la région region1]
- [Augmentation modérée] [des erreurs xxxx] dans [l'environnement prod, la région region2]
- [Augmentation importante] de la [latence] dans [l'environnement prod, la région region3]
À partir des informations sur les anomalies affichées dans le tableau de bord des événements, vous pouvez créer un type d'alerte, appelé alerte d'anomalie, afin d'être informé de ces conditions.
Types d'anomalies
Edge détecte automatiquement les types d'anomalies suivants :
- Augmentation du nombre d'erreurs HTTP 503 au niveau de l'organisation, de l'environnement et de la région
- Augmentation du nombre d'erreurs HTTP 504 au niveau de l'organisation, de l'environnement et de la région
- Augmentation du nombre d'erreurs HTTP 4xx ou 5xx au niveau de l'organisation, de l'environnement et de la région
- Augmentation de la latence de réponse totale pour le 90e centile (p90) au niveau de l'organisation, de l'environnement et de la région
Activer la détection d'anomalies
Par défaut, la détection d'anomalies est désactivée pour les organisations et les environnements Edge. Pour activer la détection d'anomalies, envoyez une demande à l'assistance Apigee Edge afin de l'activer pour une organisation et un environnement spécifiques. Apigee évalue votre environnement et vous indique si la détection d'anomalies peut être activée.
Pour des raisons de performances, n'activez pas la détection d'anomalies pour l'ensemble des organisations et des environnements. Apigee vous recommande de n'activer la détection d'anomalies que pour une organisation et un environnement dont la charge de trafic moyenne est d'au moins 10 transactions par seconde (tps).
Vérifier si la détection d'anomalies est activée
Pour vérifier si la détection d'anomalies est activée, procédez comme suit :
- Cliquez sur Analyser > Règles d'alerte dans l'interface utilisateur d'Edge.
Cliquez sur le bouton + Alerte. Le panneau "Créer une alerte" s'ouvre :
Sélectionnez l'environnement souhaité.
Si l'option Anomaly (Anomalie) est grisée pour Alert type (Type d'alerte), la détection d'anomalies est désactivée.