Questa pagina si applica ad Apigee e Apigee hybrid.
Visualizza la documentazione di Apigee Edge.
Cosa imparerai a fare
In questo tutorial imparerai a:
- Vedi le intestazioni e i contenuti del corpo del messaggio di risposta.
- Visualizza i messaggi di errore.
Che cosa ti serve
- Prima di iniziare, devi completare i passaggi descritti in Panoramica e prerequisiti.
- Almeno un criterio nel proxy.
curl
installato sulla tua macchina per effettuare chiamate API dalla riga di comando.
Visualizza i dati dei messaggi
La vista Debug nell'editor proxy Apigee consente di visualizzare intestazioni, variabili, oggetti e altri dettagli, come il tempo di risposta nel flusso di richiesta e risposta del proxy API. La vista Debug consente anche di vedere come cambia una richiesta o una risposta mentre viene elaborata da un proxy API. Per una descrizione più dettagliata della visualizzazione di debug, consulta Utilizzo di debug.
Nel tutorial precedente hai limitato il numero di richieste con il criterio SpikeArrest. Questa pagina descrive come utilizzare la visualizzazione Debug per scoprire cosa succede quando questo valore viene superato.
Nuovo editor proxy
- Nella scheda Sviluppo del proxy API, modifica il valore
<Rate>
del criterio di Spike Arrest per impostare di nuovo 13:00, quindi Salva il proxy. In questo modo potrai visualizzare le chiamate API riuscite e non riuscite (oltre il limite). - Nell'editor proxy, fai clic sulla scheda Debug.
- Fai clic su Avvia sessione di debug.
- Seleziona l'Ambiente in cui vuoi eseguire la sessione di debug.
- (Facoltativo) Dall'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 la sezione Uso dei filtri predefiniti.
- Fai clic su Avvia.
-
Chiama di nuovo il proxy API utilizzando
curl
(o con l'URL in un browser web) più volte finché non vedi almeno una risposta200
e una risposta429
nel riquadro a sinistra. - Fai clic sulla transazione
429
nel riquadro a sinistra. Nel riquadro di destra viene visualizzato un grafico di Gantt relativo alla transazione.Tieni presente che è presente una riga per il criterio di arresto dei picchi, che viene visualizzata con un'icona di errore.
Fai clic sulla riga Errore. I dettagli dell'errore vengono visualizzati a destra del grafico. L'immagine seguente mostra la sezione Proprietà dei dettagli dell'errore:
Nella finestra di dialogo:
Puoi fare clic sui pulsanti Indietro e Avanti sotto il grafico a Gannt per spostarti tra i passaggi del flusso e visualizzare i relativi dettagli.
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 completamento, quindi se vuoi visualizzare la sessione dopo questo periodo, devi scaricarla prima.
Editor proxy classico
- Nella scheda Sviluppo del proxy API, modifica il valore
<Rate>
del criterio di Spike Arrest per impostare di nuovo 13:00, quindi Salva il proxy. In questo modo potrai visualizzare le chiamate API riuscite e non riuscite (oltre il limite). - Nell'editor proxy, fai clic sulla scheda Debug.
- In Avvia una sessione di debug, seleziona l'ambiente in cui viene eseguito il deployment del proxy.
- Fai clic su Avvia sessione di debug.
-
Chiama di nuovo il proxy API utilizzando
curl
(o con l'URL in un browser web) finché non vedi almeno una risposta200
e una risposta429
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. Vedi Trovare il nome host del gruppo di ambienti.Di seguito sono mostrate una risposta
200
e una risposta429
. - Fai clic sulla transazione
200
nel riquadro Transazioni a sinistra. I relativi dettagli di debug vengono caricati nella finestra principale sotto Mappa transazioni, in cui è visualizzato un diagramma di richiesta/risposta. L'icona di arresto del picco si trova nel flusso di richiesta. - Nel diagramma di flusso, fai clic sull'icona del 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 della risposta HTTP e il contenuto del corpo.
- Ora osserva un errore in Debug.
Fai clic sulla transazione
429
nel riquadro Transazioni. Nella finestra principale dell'editor viene visualizzato un diagramma di flusso con solo gli elementi della richiesta, inclusa un'icona di arresto con picchetto con un punto esclamativo rosso che indica un errore.Fai clic sulla piccola icona di errore a forma di tubo a destra dell'icona di arresto dei picchi e osserva i dettagli della violazione relativa ai picchi nel riquadro Dettagli fase.
Puoi fare clic sui pulsanti Indietro e Avanti nel diagramma di 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 Utilizzo del debug.