Esempi di avvisi

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Apigee ti consente di creare avvisi complessi in base a più condizioni. Le seguenti sezioni presentano esempi di avvisi:

• Avviso per l'assenza di un codice di risposta 200 per 5 minuti
• Avviso relativo a picchi di traffico
• Allarme di latenza

Avviso per l'assenza di un codice di risposta 200 per 5 minuti

L'esempio seguente crea un avviso quando non è presente un codice di risposta 200 (richiesta riuscita) per 5 minuti.

Nota: questo avviso viene attivato se non c'è traffico API per 5 minuti, il che potrebbe non essere auspicabile. In questo caso, ti consigliamo di utilizzare un intervallo di tempo più lungo durante il quale normalmente prevedi di registrare un po' di traffico.

Per creare l'avviso:

1. Apri la dashboard Crea criterio di avviso nella console Google Cloud.

2. Fai clic su Seleziona una metrica.
3. Deseleziona il pulsante Attivo.

   Nota:se nella tua organizzazione non sono disponibili dati recenti sul traffico API, la metrica nel passaggio successivo non verrà visualizzata, a meno che questa opzione non sia deselezionata.

4. Seleziona una metrica come segue:
   1. Copia e incolla quanto segue nel campo Seleziona una metrica:

      apigee.googleapis.com/proxy/response_count

      Nota: se utilizzi Apigee hybrid v1.10 o v1.11, utilizza la seguente metrica:

      apigee.googleapis.com/proxyv2/response_count

   2. Seleziona Proxy Apigee.
   3. Nel riquadro che si apre a destra, seleziona Proxy.
   4. Nel riquadro successivo a destra, seleziona Conteggio risposte proxy Apigee.
   5. Fai clic su Applica.
5. Aggiungi un filtro per il codice di risposta come segue:
   1. Fai clic su Aggiungi filtro.
   2. Fai clic nel campo Filtro e seleziona response_code dal menu a discesa.
   3. In Comparatore, seleziona =.
   4. Nel campo Valore, digita 200.
   5. Fai clic su Applica.

Configura l'attivatore di avvisi

Per configurare l'evento che attiva l'avviso, fai clic su Configura attivatore nel riquadro a sinistra. Poi segui questi passaggi:

1. In Tipo di condizione, seleziona Assenza metrica.
2. Nel campo Attivatore di avvisi, seleziona Qualsiasi violazione della serie temporale.
3. Nel campo Tempo di assenza metrica, seleziona 5 min.
4. Facoltativamente, nel campo Nome condizione, inserisci un nome per la condizione.

Con queste impostazioni, viene attivato un avviso quando il proxy non riceve un codice di risposta 200 per 5 minuti.

Fai clic su Avanti per aprire il riquadro Configurare le notifiche e finalizzare l'avviso.

Configura una notifica per l'avviso

Nel riquadro Configura le notifiche e finalizza l'avviso, puoi impostare una notifica che verrà inviata quando viene attivato un avviso. Ecco come fare:

1. Fai clic nel campo Canali di notifica. Se hai già creato un canale per la notifica, come un indirizzo email o un numero SMS, puoi selezionarlo in Canali di notifica.

   In caso contrario, devi aggiungere un canale selezionando Gestisci canali di notifica. Si aprirà il riquadro Canali di notifica, in cui puoi aggiungere uno o più canali. Per saperne di più, consulta la pagina relativa alla gestione dei canali di notifica. Al termine, torna al riquadro Configura le notifiche e finalizza l'avviso.

   Nota: per visualizzare un nuovo canale dopo averlo creato, potresti dover fare clic sul pulsante di aggiornamento accanto a Gestisci canali di notifica.

   Dopo aver selezionato uno o più canali di notifica, fai clic su OK.

2. Nel campo Documentazione, puoi aggiungere un messaggio che verrà inviato con la notifica. Ad esempio, il messaggio potrebbe descrivere il motivo dell'avviso e contenere link alla documentazione che spiega come rispondere.
3. Fai clic su Avanti per esaminare i dettagli dell'avviso. Se sono soddisfatti, fai clic su Crea criterio per creare il criterio di avviso.

Avviso relativo a un picco di traffico

Le sezioni seguenti mostrano come creare un avviso che viene attivato quando il numero di richieste API in un periodo di 1 minuto supera 3600.

Per creare l'avviso:

1. Apri la dashboard Crea criterio di avviso nella console Google Cloud.

2. Fai clic su Seleziona una metrica.
3. Deseleziona il pulsante Attivo.

   Nota:se nella tua organizzazione non sono disponibili dati recenti sul traffico API, la metrica nel passaggio successivo non verrà visualizzata, a meno che questa opzione non sia deselezionata.

4. Seleziona una metrica come segue:
   1. Copia e incolla quanto segue nel campo Seleziona una metrica:

      apigee.googleapis.com/proxy/request_count

      Nota: se utilizzi Apigee Hybrid v1.10 o v1.11, utilizza la seguente metrica:

      apigee.googleapis.com/proxyv2/request_count

   2. Seleziona Proxy Apigee.
   3. Nel riquadro che si apre a destra, seleziona Proxy.
   4. Nel riquadro successivo a destra, seleziona Conteggio richieste proxy Apigee.
   5. Fai clic su Applica.
5. Nel riquadro Trasforma i dati:
   • In All'interno di ogni serie temporale:
     • Nel campo Finestra temporale continua, seleziona 1 min.
     • In Funzione finestra temporale continua, seleziona Tasso.
   • In Tra serie temporali, in Aggregazione delle serie temporali, seleziona somma.

Configura l'attivatore di avvisi

Per configurare l'evento che attiva l'avviso, fai clic su Configura attivatore nel riquadro a sinistra. Poi segui questi passaggi:

1. In Tipo di condizione, seleziona Soglia.
2. Nel campo Attivatore di avvisi, seleziona Qualsiasi violazione della serie temporale.
3. Nel campo Posizione soglia, seleziona Sopra la soglia.
4. Nel campo Valore soglia, inserisci 60.

Il motivo per cui imposti Valore soglia su 60 (anziché su 3600) è che le unità di Valore soglia sono al secondo. Pertanto, se questa soglia viene mantenuta per 1 minuto, in questo periodo di tempo ci saranno almeno 3600 richieste.

Con queste impostazioni, verrà attivato un avviso quando il numero totale di richieste in un periodo di 1 minuto supera 3600.

Fai clic su Avanti per aprire il riquadro Configurare le notifiche e finalizzare l'avviso e segui i passaggi descritti in Configurare una notifica per l'avviso.

Avviso sulla latenza

Gli esempi riportati di seguito mostrano come creare un avviso che viene attivato quando il 95° percentile delle latenze medie nelle risposte, su intervalli di 10 minuti, è superiore a 600 ms.

• Crea l'avviso utilizzando Apigee o Apigee hybrid v1.12
• Creare l'avviso utilizzando Apigee hybrid 1.10 o 1.11

Crea l'avviso utilizzando Apigee o Apigee hybrid versione 1.12

Per creare l'avviso utilizzando Apigee:

1. Apri la dashboard Crea criterio di avviso nella console Google Cloud.

2. Fai clic su Seleziona una metrica.
3. Deseleziona il pulsante Attivo.

   Nota:se nella tua organizzazione non sono presenti dati recenti sul traffico API, la metrica nel passaggio successivo non verrà visualizzata, a meno che questa opzione non sia deselezionata.

4. Seleziona una metrica come segue:
   1. Copia e incolla quanto segue nel campo Seleziona una metrica:

      apigee.googleapis.com/proxy/latencies

   2. Seleziona Proxy Apigee.
   3. Nel riquadro che si apre a destra, seleziona Proxy.
   4. Nel riquadro successivo a destra, seleziona Latenze del proxy Apigee.
   5. Fai clic su Applica.
5. Nel riquadro Trasforma i dati, in All'interno di ogni serie temporale:
   • Nel campo Finestra temporale continua, seleziona 10 min.
   • Nel campo Funzione finestra mobile, inserisci Percentile 95.

Consulta Creare l'attivatore di avvisi per configurare l'evento che attiva l'avviso.

Crea l'avviso utilizzando Apigee hybrid 1.10 o 1.11

Per creare l'avviso utilizzando Apigee hybrid 1.10 o 1.11:

1. Apri la dashboard Crea criterio di avviso nella console Google Cloud.

2. Fai clic su Seleziona una metrica.
3. Deseleziona il pulsante Attivo.

   Nota:se nella tua organizzazione non sono presenti dati recenti sul traffico API, la metrica nel passaggio successivo non verrà visualizzata, a meno che questa opzione non sia deselezionata.

4. Seleziona una metrica come segue:
   1. Copia e incolla quanto segue nel campo Seleziona una metrica:

      apigee.googleapis.com/proxyv2/latencies_percentile

   2. Seleziona Proxy Apigee (v2).
   3. Nel riquadro che si apre a destra, seleziona Proxyv2.
   4. Nel riquadro successivo a destra, seleziona Percentile delle latenze di risposta del proxy Apigee.
   5. Fai clic su Applica.

5. Aggiungi un filtro come segue:

   1. Fai clic su Aggiungi un filtro.
   2. Fai clic nel campo Filtro e seleziona percentile dal menu a discesa.
   3. In Comparatore, seleziona =.
   4. Nel campo Valore, digita 95.
   5. Fai clic su Applica.
6. Nel riquadro Trasforma i dati, in All'interno di ogni serie temporale:
   • Nel campo Finestra temporale continua, seleziona 10 min.
   • Nel campo Funzione finestra temporale continua, inserisci media.

Consulta Creare l'attivatore di avvisi per configurare l'evento che attiva l'avviso.

Configura l'attivatore di avvisi

Per configurare l'evento che attiva l'avviso, fai clic su Configura attivatore nel riquadro a sinistra. Poi segui questi passaggi:

1. In Tipo di condizione, seleziona Soglia.
2. Nel campo Attivatore di avvisi, seleziona Qualsiasi violazione della serie temporale.
3. Nel campo Posizione soglia, seleziona Sopra la soglia.
4. Nel campo Valore soglia, inserisci 600.

Con queste impostazioni, viene attivato un avviso quando il 95° percentile delle latenze è superiore alla soglia di 600 ms.

Fai clic su Avanti per aprire il riquadro Configurare le notifiche e finalizzare l'avviso e segui i passaggi descritti in Configurare una notifica per l'avviso.

Quando ricevi una notifica e fai clic sul pulsante Visualizza in Apigee nell'email di notifica, la dashboard di indagine mostrerà un grafico della latenza con la soglia, simile all'esempio mostrato: