Visualizzare i dati dei messaggi con la visualizzazione di debug

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Cosa imparerai a fare

In questo tutorial imparerai a:

• Visualizza le intestazioni e il contenuto del corpo del messaggio di risposta.
• Visualizza i messaggi di errore.

Che cosa ti serve

Prima di iniziare questo tutorial, segui questi passaggi:

• Assicurati che curl sia installato sul tuo computer per effettuare chiamate API dalla riga di comando.
• Completa i passaggi descritti in Prima di iniziare.
• Aggiungi un criterio SpikeArrest al proxy. Il criterio SpikeArrest limita il numero di richieste che possono essere inviate al proxy API. Il proxy deve avere almeno un criterio.

Visualizzare i dati dei messaggi

La visualizzazione di debug in Apigee Proxy Editor ti consente di visualizzare intestazioni, variabili, oggetti e altri dettagli come il tempo di risposta nella richiesta e nel flusso di risposta del proxy API. La visualizzazione di debug ti consente anche di vedere come una richiesta o una risposta cambia durante l'elaborazione da parte di un proxy API. Per una descrizione più dettagliata della vista di debug, consulta Utilizzare il debug.

Questa pagina descrive come utilizzare la visualizzazione di debug per vedere cosa succede quando viene superata la frequenza del criterio SpikeArrest.

Nota: lo strumento di debug è disponibile nella console Google Cloud e nell'interfaccia utente classica e alcune azioni di debug possono essere eseguite utilizzando l'API come descritto nelle seguenti schede. Le opzioni della console Google Cloud sono Debug v2 (nuova) e Debug v1 (rilasciata 07/01/2022). Puoi passare da una versione all'altra dello strumento di debug nella console Google Cloud e nell'interfaccia utente classica.

Interfaccia utente di Cloud ConsoleInterfaccia utente classica

Debug v2 (nuovo)Debug v1

Per utilizzare la visualizzazione di debug nell'interfaccia utente della console Cloud per vedere cosa succede quando viene superato il tasso del criterio SpikeArrest:

1. Apri l'interfaccia utente della console Cloud.
2. Seleziona il progetto.
3. Fai clic su Sviluppo proxy > Proxy API.
4. Fai clic sul nome del proxy API che vuoi eseguire il debug.
5. Fai clic sulla scheda Sviluppa.
6. Fai clic sul criterio Norme > SpikeArrest.
7. Nel riquadro di modifica, modifica Tariffa in 13:00.
8. Fai clic su Salva.In questo modo potrai visualizzare sia le chiamate API riuscite sia quelle non riuscite (oltre il limite).
9. Esegui il deployment del proxy aggiornato.
10. Fai clic sulla scheda Debug.
11. Fai clic su Avvia sessione di debug.

    Nella finestra di dialogo:

    1. Seleziona l'ambiente in cui vuoi eseguire la sessione di debug.

    2. (Facoltativo) Nell'elenco a discesa Filtro, seleziona un filtro da applicare a tutte le transazioni nella sessione di debug che stai creando. Il valore predefinito è None (All transactions), che include tutte le transazioni nei dati di debug.

       Per informazioni sull'utilizzo dei filtri, consulta Utilizzare i filtri in una sessione di debug. Per informazioni sui filtri integrati, consulta Utilizzare i filtri predefiniti.

    3. Fai clic su Avvia.

12. Chiama il proxy dell'API utilizzando curl (o con l'URL in un browser web) più volte finché non visualizzi almeno una risposta 200 e una risposta 429 nel riquadro Transazioni.

    
    Nota: il codice di stato HTTP per il superamento del limite di frequenza è 429 Too many requests.

13. Fai clic su una transazione 429. Nel riquadro Mappa transazioni viene visualizzato un diagramma di flusso che include un criterio SpikeArrest con un'icona di errore.

    

14. Fai clic sull'icona errore. Viene visualizzato il riquadro Proprietà errore.

    

Puoi fare clic sui pulsanti Indietro e Avanti per spostarti tra i passaggi del flusso e visualizzare i dettagli di ciascun passaggio.

Per scaricare l'intera sessione di debug come singolo documento, fai clic su Scarica sessione. Una sessione di debug viene eliminata entro 24 ore dalla sua compilazione, quindi se vuoi visualizzarla dopo questo periodo di tempo, devi scaricarla prima.

1. Nella scheda Sviluppa del proxy API, modifica il valore <Rate> del criterio Arresto picchi in modo che sia nuovamente 13:00, quindi Salva il proxy. In questo modo potrai visualizzare le chiamate API riuscite e non riuscite (oltre il limite).
2. Nell'editor proxy, fai clic sulla scheda Debug.
3. Fai clic su Avvia sessione di debug.

Nella finestra di dialogo:

1. Seleziona l'ambiente in cui vuoi eseguire la sessione di debug.
2. (Facoltativo) Nell'elenco a discesa Filtro, seleziona un filtro da applicare a tutte le transazioni nella sessione di debug che stai creando. Il valore predefinito è None (All transactions), che include tutte le transazioni nei dati di debug.

   Per informazioni sull'utilizzo dei filtri, vedi Utilizzare i filtri in una sessione di debug. Per informazioni sui filtri integrati, consulta Utilizzare i filtri predefiniti.

3. Fai clic su Avvia.

4. Chiama di nuovo il proxy dell'API utilizzando curl (o l'URL in un browser web) più volte fino a quando non visualizzi almeno una risposta 200 e una risposta 429 nel riquadro a sinistra.

   

   Nota: il codice di stato HTTP per il superamento del limite di frequenza è 429 Too many requests.
5. Fai clic sulla transazione 429 nel riquadro a sinistra. Nel riquadro a destra viene visualizzato un grafico di Gantt per la transazione.

   

   Tieni presente che è presente una riga per il criterio SpikeArrest, che viene visualizzata con un'icona di errore.

6. Fai clic sulla riga etichettata come Error (Errore). I dettagli dell'errore vengono visualizzati a destra del grafico. L'immagine seguente mostra la sezione Proprietà dei dettagli dell'errore:

   

Puoi fare clic sui pulsanti Indietro e Avanti sotto il grafico di Gannt per spostarti tra i passaggi del flusso e visualizzare i dettagli di ciascun passaggio.

Per scaricare l'intera sessione di debug come singolo documento, fai clic su Scarica sessione. Una sessione di debug viene eliminata entro 24 ore dal momento in cui viene completata, quindi se vuoi visualizzarla dopo questo lasso di tempo, devi scaricarla prima.

1. Nella scheda Sviluppa del proxy API, modifica il valore <Rate> del criterio Arresto picchi in modo che sia nuovamente 13:00, quindi Salva il proxy. In questo modo potrai vedere le chiamate API riuscite e non riuscite (oltre il limite).
2. Nell'editor proxy, fai clic sulla scheda Debug.
3. In Avvia una sessione di debug, seleziona l'ambiente in cui è disegnato il proxy.
4. Fai clic su Avvia sessione di debug.

5. Chiama di nuovo il proxy API utilizzando curl (o con l'URL in un browser web) finché non visualizzi almeno una risposta 200 e una risposta 429 nel riquadro Transazioni di debug.

   curl -v https://YOUR_ENV_GROUP_HOSTNAME/my-proxy

   dove YOUR ENV_GROUP_HOSTNAME è il nome host del gruppo di ambienti. Consulta Trovare il nome host del gruppo di ambienti.

   Di seguito sono riportate una risposta 200 e una risposta 429.

   

   Nota: il codice di stato HTTP predefinito per il superamento del limite di frequenza è 429 Too many requests.

   Se vuoi che il codice di stato sia diverso (ad esempio 500) per tutti i criteri di arresto picco utilizzati in un'organizzazione, è necessario impostare una proprietà per l'organizzazione. Se sei cliente di Cloud, contatta l'assistenza clienti Google Cloud per impostare la proprietà.

6. Fai clic sulla transazione 200 nel riquadro Transazioni a sinistra. I dettagli di debug vengono caricati nella finestra principale in Mappa transazioni, che mostra un diagramma di richiesta/risposta. L'icona Arresto picco è nel flusso di richiesta.
7. Nel diagramma di flusso, fai clic sull'icona a forma di cerchio nella risposta, quella più a destra (mostrata nel diagramma seguente).

   Il riquadro Dettagli fase mostra i dati disponibili in quel punto del flusso. Se scorri il riquadro, vedrai le intestazioni e il corpo della risposta HTTP.

8. Ora esamina un errore in Debug.

   Fai clic sulla transazione 429 nel riquadro Transazioni. Nella finestra dell'editor principale viene visualizzato un diagramma di flusso con gli elementi solo nella richiesta, inclusa un'icona di arresto picco con un punto esclamativo rosso che indica un errore.

   Fai clic sulla piccola icona di errore a forma di tubo a destra dell'icona Arresto picco e esamina i dettagli della violazione di arresto picco nel riquadro Dettagli fase.

   

Puoi fare clic sui pulsanti Indietro e Avanti nel diagramma del flusso per spostarti tra i punti del flusso e visualizzare i dettagli di debug.

Se vuoi visualizzare l'intera sessione di debug come un unico documento, scaricala facendo clic su Scarica sessione di debug.

Per ulteriori informazioni, consulta la sezione Utilizzare il debug.