Come funziona il rilevamento di anomalie

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Il rilevamento delle anomalie prevede tre fasi principali:

• Addestra i modelli
• Registra gli eventi di anomalia
• Genera avvisi

Addestra i modelli

Il rilevamento delle anomalie funziona addestrando un modello del comportamento dei proxy API dai dati delle serie temporali storiche. Non è richiesta alcuna azione da parte tua per addestrare il modello. Edge crea e addestra automaticamente i modelli utilizzando i dati sul traffico delle sei ore precedenti. Pertanto, Edge richiede un minimo di sei ore di dati su un proxy API per addestrare il modello prima di poter registrare un'anomalia.

Registra gli eventi di anomalia

In fase di runtime, il rilevamento delle anomalie di Edge confronta il comportamento attuale dei proxy API con il comportamento previsto dal modello. Il rilevamento delle anomalie può quindi determinare, con una soglia di confidenza specifica, quando una metrica operativa supera il valore previsto. Ad esempio, quando la frequenza degli errori 5xx supera la frequenza prevista dal modello.

Quando Edge rileva una condizione di anomalia, la registra automaticamente nella dashboard Eventi nell'interfaccia utente di Edge. Per ogni anomalia rilevata, Edge registra le soglie di confidenza di anomalia lieve, moderata o grave. Ad esempio, un'anomalia grave è considerata anomala con un livello di confidenza estremamente elevato.

L'elenco degli eventi visualizzati nella dashboard Eventi include tutte le anomalie rilevate da Edge e tutti gli avvisi attivati. Gli avvisi possono essere fissi o di anomalia.

Per visualizzare un'anomalia:

1. Fai clic su Analizza > Eventi nell'interfaccia utente di Edge. Viene visualizzata la nuova dashboard Eventi:
2. Filtra la dashboard Eventi per:
   • Ambiente
   • Regione
   • Tipo di evento come Avviso (fisso e anomalia) o Anomalia
   • Soglia anomalia (solo anomalie)
   • Periodo di tempo

Per esaminare in dettaglio un'anomalia:

1. Seleziona la riga dell'anomalia nella dashboard Eventi per aprire l'anomalia nella API Monitoring dashboard Esamina. Nell'esempio riportato di seguito, esamini un'anomalia per un leggero aumento della latenza p90. La barra gialla verticale indica il punto in cui si è verificata l'anomalia:

   

2. Seleziona un blocco nella visualizzazione per visualizzare i dettagli dell'anomalia:

   

3. Seleziona Feedback: quanto è precisa questa anomalia per fornire feedback ad Apigee e contribuire a migliorare il rilevamento delle anomalie. Utilizza questo link per specificare se il pattern di traffico era un'anomalia effettiva, quanto è stato utile il rilevamento e per lasciare un commento facoltativo:

   

Genera avvisi

Per impostazione predefinita, Edge genera un evento di anomalia, ma non genera un avviso di anomalia. Esamina la dashboard Eventi per determinare se un'anomalia rilevata, alla soglia calcolata, è un problema effettivo. In caso affermativo, puoi creare un avviso per quella condizione di anomalia al livello di soglia attuale o a un livello diverso. La prossima volta che si verifica l'anomalia, Edge genera l'avviso e può inviarti un'email o un altro tipo di notifica.

Nota: dopo aver generato l'avviso, Edge non lo genera di nuovo finché non sono trascorsi 10 minuti e la condizione di avviso esiste ancora. Questo intervallo impedisce a Edge di generare avvisi duplicati per la stessa condizione.

Per creare un avviso di anomalia:

1. Seleziona un'anomalia nella dashboard Eventi per visualizzarne i dettagli, come mostrato sopra.
2. Seleziona il pulsante Crea avviso nei dettagli dell'anomalia. Viene visualizzato il riquadro Crea avviso.

3. Configura l'avviso. Nell'esempio seguente, configuri l'avviso per un leggero aumento della latenza p90 per l'ambiente prod in qualsiasi regione:

   

4. Fai clic su + Notifica per aggiungere una notifica di avviso.

   Dettagli notifica	Descrizione
   Canale	Seleziona il canale di notifica che vuoi utilizzare e specifica la destinazione: email, Slack, PagerDuty o webhook.
   Destinazione	Specifica la destinazione in base al tipo di canale selezionato: Email: indirizzo email, ad esempio joe@company.com Slack: URL del canale Slack, ad esempio https://hooks.slack.com/services/T00000000/B00000000/XXXXX PagerDuty: codice PagerDuty, ad esempio abcd1234efgh56789 Webhook: URL webhook, ad esempio https://apigee.com/test-webhook Nota: puoi specificare una sola destinazione per notifica. Per specificare più destinazioni per lo stesso tipo di canale, aggiungi altre notifiche.

5. Per aggiungere altre notifiche, ripeti il passaggio 4.
6. Se hai aggiunto una notifica, imposta il seguente campo:

   Campo	Descrizione
   Limitazione	Frequenza con cui inviare le notifiche. Seleziona un valore dall'elenco a discesa.

7. Fai clic su Salva.

   Riceverai un avviso la prossima volta che si verifica l'anomalia.