Esempi di avvisi

Stai visualizzando la documentazione di Apigee X.
Visualizza la documentazione di Apigee Edge.

Apigee consente di creare avvisi complessi basati su più condizioni e combinazioni logiche. Le seguenti sezioni presentano alcuni esempi di avvisi.

• Avviso relativo a nessun codice di risposta 200 per 5 minuti
• Avviso sul picco di traffico
• Avviso sulla latenza
• Avviso relativo a una diminuzione delle risposte con codice di risposta 200
• Avviso per combinazioni di codici di risposta e metodi HTTP

Avviso relativo a nessun codice di risposta 200 per 5 minuti

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

Passaggi iniziali

Per creare l'avviso, inizia eseguendo la procedura iniziale per creare un avviso basato su metriche.

Target

Nel riquadro Target, segui questi passaggi:

1. Aggiungi la metrica response_count copiando il codice riportato di seguito e incollandolo nel campo Seleziona una metrica.

   apigee.googleapis.com/proxyV2/response_count

2. Aggiungi un filtro per il conteggio delle risposte come segue:
   1. Nel campo Filtro, fai clic su Aggiungi un filtro e seleziona Risposta al proxy Apigee cumulativa dal menu a discesa.
   2. Nel campo successivo, seleziona =.
   3. Seleziona 200 nel campo Valore.
   4. Fai clic su APPLICA.

Puoi lasciare invariati i campi rimanenti nel riquadro Target, poiché non vengono utilizzati nell'esempio.

Configurazione

Nel riquadro Configurazione:

1. Nel campo Condizione, seleziona è assente.
2. Nel campo Per, seleziona 5 minuti. Se non ricevi codice di risposta 200 in un intervallo di 5 minuti, viene attivato l'avviso.

Infine, fai clic su AGGIUNGI per creare l'avviso.

Dopo aver eseguito questi passaggi, verrà attivato un avviso quando il proxy non riceve un codice di risposta 200 per 5 minuti.

Avviso di picco del traffico

Le seguenti sezioni mostrano come creare un avviso che viene attivato quando il traffico totale dell'API supera 3600 per 1 minuto.

Passaggi iniziali

Per creare l'avviso, inizia eseguendo la procedura iniziale per creare un avviso basato su metriche.

Target

Nel riquadro Target:

1. Copia l'esempio di codice riportato di seguito e incollalo nel campo Seleziona una metrica.

   apigee.googleapis.com/proxyv2/response_count

2. Fai clic sul campo Seleziona una metrica e scegli Cumulativo della risposta del proxy Apigee.

   

   Vengono visualizzati i campi mostrati di seguito.

   
3. Nel campo Aggregatore, seleziona somma. Somma il traffico totale nell'intervallo di tempo specificato da Periodo.
4. Imposta Periodo su 1 minuto.

   Queste impostazioni attiveranno un avviso in base al numero totale di richieste in ogni intervallo di un minuto dell'intervallo di tempo.

Configurazione

Le impostazioni di configurazione specificano le condizioni che attivano l'avviso. La soglia è il valore minimo della quantità specificata nella sezione Target, che in questo caso è di richieste al secondo, che attiverà l'avviso.

Ad esempio, supponiamo che tu debba attivare l'avviso se il traffico totale in un intervallo di 1 minuto è superiore a 36. Poiché la soglia viene misurata in richieste al secondo, dividi 3600 per 60 per ottenere una soglia di 60.

Inserisci i seguenti valori nel riquadro Configurazione:

• Imposta Soglia su 60.
• Imposta Per su 1 minute.

Il riquadro Configurazione viene mostrato come mostrato di seguito.

Infine, fai clic su AGGIUNGI per creare l'avviso.

Dopo aver eseguito questi passaggi, verrà attivato un avviso quando il traffico totale dell'API supera 3600 per 1 minuto.

Avviso di latenza

La sezione seguente mostra come creare un avviso che viene attivato quando per il 90° percentile la latenza API è superiore a 600 ms per 10 minuti.

Passaggi iniziali

Per creare l'avviso, inizia eseguendo la procedura iniziale per creare un avviso basato su metriche.

Target

Quindi, segui questi passaggi nel riquadro Target:

1. Copia il codice riportato di seguito e incollalo nel campo Seleziona una metrica.

   apigee.googleapis.com/proxyv2/latencies_percentile

2. Seleziona Percentile della risposta proxy Apigee.

   

3. In Filtro, fai clic nel campo Aggiungi un filtro e seleziona percentile.

   

4. Nel campo Valore visualizzato sotto Seleziona una metrica, seleziona 90.

   

5. Fai clic su Applica.

Configurazione

Nel riquadro Configurazione, procedi nel seguente modo:

1. Imposta Soglia su 600.

   

Infine, fai clic su AGGIUNGI per creare l'avviso.

Con queste impostazioni, verrà attivato un avviso quando il 90° percentile della latenza dell'API supera 600 per 10 minuti.

Se crei una notifica per l'avviso, quando la ricevi e fai clic sul pulsante Visualizza in Apigee nell'email di notifica, nella Dashboard Indagine viene visualizzato un grafico della latenza con la soglia simile all'esempio riportato di seguito:

Avviso in caso di diminuzione delle risposte con codice di risposta 200

L'esempio seguente mostra come creare un avviso per una riduzione del 5% delle risposte con codice di risposta 200 (risposta corretta) in un intervallo di 3 minuti.

Passaggi iniziali

Per creare l'avviso, inizia eseguendo la procedura iniziale per creare un avviso basato su metriche.

Target

Nel riquadro Target, segui questi passaggi:

1. Aggiungi la metrica response_count copiando il codice riportato di seguito e incollandolo nel campo Seleziona una metrica.

   apigee.googleapis.com/proxyV2/response_count

2. Aggiungi un filtro per response_code come segue:
   1. Nel campo Filtro, fai clic su Aggiungi un filtro e seleziona response_code dal menu a discesa.
   2. Seleziona 200 nel campo Valore.
   3. Fai clic su APPLICA.

   

3. Nel menu a discesa Aggregatore, seleziona somma.
4. Nel menu a discesa Periodo, seleziona 1 minuto. Le ultime due impostazioni specificano che le risposte saranno sommate su intervalli di tempo di 1 minuto.

Nota: il Periodo non è l'intervallo (3 minuti) della diminuzione delle risposte che attivano l'avviso. L'intervallo è specificato nel riquadro Configurazione, descritto di seguito.

Dopo aver eseguito questi passaggi, il riquadro Target dovrebbe apparire come mostrato di seguito:

Configurazione

Successivamente, effettua le seguenti selezioni nel riquadro Configurazione:

• Nel menu a discesa Configura, seleziona Diminuisci di.
• Nel campo Soglia, inserisci 5 percento.
• Nel menu Per, seleziona 3 minuti. Specifica che la diminuzione delle risposte deve durare tre minuti per attivare l'avviso.

Dopodiché, il riquadro Configurazione dovrebbe apparire come mostrato di seguito:

Infine, fai clic su AGGIUNGI per creare l'avviso.

Con queste impostazioni, verrà attivato un avviso quando la somma dei conteggi delle risposte nel minuto precedente ha subito un calo del 5% in 3 minuti.

Avviso per combinazioni di codici di risposta e metodi HTTP

Il campo Raggruppa per nel riquadro Target consente di suddividere i dati sul traffico API in gruppi che corrispondono alle etichette selezionate. L'esempio successivo suddivide i dati di response_count in quattro gruppi, in base a tutte le combinazioni dei metodi HTTP GET e PUT, e dei codici di risposta 400 e 500, come mostrato nella seguente tabella.

	Codice di risposta: 400	Codice di risposta: 500
Metodo HTTP: GET	GET&400	GET&500
Metodo HTTP: PUT	PUT&400	PUT&500

L'esempio crea quindi un avviso che viene attivato se si verifica un aumento del 25% delle risposte su un intervallo di 5 minuti per una qualsiasi delle quattro combinazioni nella tabella riportata sopra.

In questo esempio, le risposte con codice di risposta 200 saranno escluse dal conteggio, il che significa che vengono conteggiate solo le risposte non riuscite (a differenza dell'esempio precedente, in cui vengono conteggiate solo le risposte riuscite).

Passaggi iniziali

Per creare l'avviso, inizia eseguendo la procedura iniziale per creare un avviso basato su metriche.

Target

Nel riquadro Target, segui questi passaggi:

1. Per aggiungere la metrica request_count, copia il codice riportato di seguito e incollalo nel campo Seleziona un campo metrica.

   apigee.googleapis.com/proxyV2/response_count

2. Per escludere risposte con response_code 200, segui questi passaggi nel campo Filtro:
   1. Digita response_code.
   2. Nel campo seguente, seleziona !=.
   3. Nel campo Valore, seleziona 200.
   4. Fai clic su Applica.
3. Nel campo Raggruppa per:
   1. Fai clic su + Aggiungi un'etichetta e seleziona HTTP method sotto Valore.
   2. Fai di nuovo clic su + Aggiungi un'etichetta e seleziona response_code sotto il Valore.
4. Nel menu a discesa Aggregatore, seleziona somma.
5. Nel menu a discesa Periodo, seleziona 1 minuto.

Dopo aver eseguito questi passaggi, il riquadro Target dovrebbe apparire come mostrato di seguito:

Configurazione

Successivamente, effettua le seguenti selezioni nel riquadro Configurazione:

• Nel menu a discesa Configura, seleziona Aumenta di.
• Nel campo Soglia, inserisci 20.
• Nel menu Per, seleziona 5 minuti.

Dopodiché, il riquadro Configurazione dovrebbe apparire come mostrato di seguito:

Infine, fai clic su AGGIUNGI per creare l'avviso.

L'avviso viene attivato se si verifica un aumento del 25% delle risposte per una delle quattro combinazioni di metodo HTTP e codice di risposta nell'arco di 5 minuti.

Avvisi 4xx con un codice di errore specifico (forse l'errore di autenticazione? )

Avviso di latenza quando p95 ha superato 1 secondo.