Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info
Il monitoraggio delle API ti consente di creare regole basate su pattern che attivano avvisi in base a un insieme di condizioni predefinite. Questi tipi di avvisi sono chiamati fissi e sono stati l'unico tipo di avvisi supportato nella release iniziale dell'API Monitoring.
Ad esempio, puoi generare un avviso fisso quando:
- [Tasso di errori 5xx] [è superiore a] [10%] per [10 minuti] da [target mytarget1]
- [count of 2xx errors] [is less than] [50] for [5 minutes] in [region us-east-1]
- [Latenza p90] [è superiore a] [750 ms] per [10 minuti] su [proxy myproxy1]
Quando le condizioni di un avviso fisso sono soddisfatte, il monitoraggio API genera un avviso per informarti del problema. Tuttavia, devi aver definito le condizioni di avviso specifiche prima che il monitoraggio API possa generare l'avviso.
Sebbene gli avvisi fissi siano utili, può essere difficile determinare le soglie giuste per una condizione perché i pattern di traffico cambiano nel tempo. Ad esempio, se imposti una soglia troppo bassa, riceverai moltissimi avvisi. Se imposti una soglia troppo alta, potresti non rilevare alcuni problemi o interruzioni critici.
Rilevamento di anomalie
Con il rilevamento delle anomalie, consenti a Edge di rilevare i problemi di traffico e prestazioni anziché doverli predeterminare autonomamente. Edge cerca automaticamente condizioni di anomalia a livello di organizzazione, ambiente e regione. Quando viene rilevata, l'anomalia viene registrata per la visualizzazione nella dashboard Eventi nell'interfaccia utente di Edge.
Il rilevamento delle anomalie funziona applicando modelli di intelligenza artificiale (IA) e machine learning (ML) ai dati storici delle API. Il rilevamento delle anomalie può quindi inviare avvisi in tempo reale per scenari che non avevi nemmeno preso in considerazione per migliorare la produttività e ridurre il tempo medio di risoluzione (MTTR) dei problemi relativi alle API.
Alcuni esempi di anomalie rilevate possono includere situazioni in cui una nuova release dell'API provoca un picco imprevisto di traffico e un corrispondente aumento della latenza dell'API. In alternativa, una release configurata in modo errato sul backend comporta un aumento degli errori di backend segnalati dall'API.
Un'anomalia rilevata include le seguenti informazioni:
- La metrica che ha causato l'anomalia, ad esempio la latenza del proxy o un codice di errore HTTP.
- La soglia dell'anomalia. La soglia può essere lieve, moderata o grave.
Ad esempio, Edge può rilevare automaticamente un'anomalia come:
- Un [lieve] [aumento degli errori 503] in [ambiente prod, regione region1]
- Un [aumento moderato] [degli errori 4xx] in [ambiente prod, regione region2]
- Un [grave] [aumento della latenza] in [environment prod, region region3]
Dalle informazioni sulle anomalie visualizzate nella dashboard Eventi, puoi creare un nuovo tipo di avviso, chiamato avviso di anomalia, per ricevere una notifica di queste condizioni.
Tipi di anomalie
Edge rileva automaticamente i seguenti tipi di anomalie:
- Aumento degli errori HTTP 503 a livello di organizzazione, ambiente e regione
- Aumento degli errori HTTP 504 a livello di organizzazione, ambiente e regione
- Aumento di tutti gli errori HTTP 4xx o 5xx a livello di organizzazione, ambiente e regione
- Aumento della latenza di risposta totale per il 90° percentile (p90) a livello di organizzazione, ambiente e regione
Attiva il rilevamento delle anomalie
Per impostazione predefinita, il rilevamento delle anomalie è disattivato per le organizzazioni e gli ambienti Edge. Per attivare il rilevamento delle anomalie, invia una richiesta all'assistenza Apigee Edge per attivarlo per un'organizzazione e un ambiente specifici. Apigee valuterà il tuo ambiente e ti comunicherà se è possibile attivare il rilevamento delle anomalie.
Per motivi di prestazioni, non attivare il rilevamento delle anomalie in tutte le organizzazioni e in tutti gli ambienti. Apigee consiglia di attivare il rilevamento delle anomalie solo in un'organizzazione e in un ambiente con un carico del traffico medio di almeno 10 transazioni al secondo (TPS).
Verificare se il rilevamento di anomalie è attivo
Per verificare se il rilevamento delle anomalie è attivo:
- Seleziona Analyze > Alert Rules (Analisi > Regole di avviso) nell'interfaccia utente di Edge.
Seleziona il pulsante + Avviso. Viene visualizzato il riquadro Crea avviso:
Seleziona l'ambiente che preferisci.
Se l'opzione Anomalia non è selezionabile per Tipo di avviso, significa che il rilevamento delle anomalie è disattivato.