Visualizzare i dati dei messaggi con la vista Debug

Questa pagina si applica a Apigee e Apigee ibridi.

Visualizza documentazione di Apigee Edge.

Cosa imparerai a fare

In questo tutorial imparerai a:

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

Che cosa ti serve

• Prima di iniziare, devi completare i passaggi in Panoramica e prerequisiti.
• Almeno un criterio nel proxy.
• curl installato sulla 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 tempo di risposta nel flusso di richiesta e risposta proxy API. La vista Debug ti consente anche Cambiamenti di richiesta o risposta durante l'elaborazione da parte di un proxy API. Per una panoramica descrizione della vista di debug, consulta Utilizzo del debug.

Nel tutorial precedente, hai limitato Il numero di richieste con il criterio SpikeArrest. In questa pagina viene descritto come utilizzare lo strumento per vedere cosa succede quando questo tasso viene superato.

Nota: Apigee sta introducendo una nuova versione del proxy Editor, che semplificherà la gestione dei proxy.

Le istruzioni nelle prime due schede spiegano come utilizza il nuovo editor proxy o l'editor proxy classico.

Nuovo editor proxy

1. Nella scheda Develop del proxy API, modifica il valore del criterio Spike Arrest <Rate> sarà di nuovo alle 13:00, poi Salva il proxy. In questo modo potrai vedere sia le operazioni riuscite sia quelle non riuscite (oltre non supera il limite) di chiamate API.
2. In Proxy Editor, fai clic sulla scheda Debug.
3. Fai clic su Start Debug Session (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 a cui applicare tutte le transazioni nella sessione di debug che stai creando. Il valore predefinito è None (All transactions) e 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, vedi Utilizzo dei filtri predefiniti.

3. Fai clic su Avvia.

4. Chiamare l'API nuovamente utilizzando curl (o con l'URL in un browser web) più volte finché non vedi almeno una risposta 200 e una risposta 429 nel riquadro a sinistra.

   

   Nota: il codice di stato HTTP per il superamento della frequenza il limite è 429 Too many requests.
5. Fai clic sulla transazione 429 nel riquadro a sinistra. Viene visualizzata una Diagramma di Gantt relativa alla transazione nel riquadro a destra.

   

   Tieni presente che è presente una riga per il criterio Arresto dei picchi, visualizzata con un'icona di errore.

6. Fai clic sulla riga Errore. I dettagli dell'errore vengono mostrati al a destra del grafico. L'immagine seguente mostra la sezione Proprietà dei dettagli dell'errore:

   

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

Per scaricare l'intera sessione di debug come singolo documento, fai clic su Download Session (Scarica sessione). Una sessione di debug viene eliminata entro 24 ore dal suo completamento, pertanto se Se vuoi vedere la sessione dopo questo orario, devi scaricarla prima di allora.

Editor proxy classico

1. Nella scheda Sviluppo del proxy API, modifica il valore del criterio Spike Arrest <Rate> sarà di nuovo alle 13:00, poi Salva il proxy. In questo modo potrai vedere sia le operazioni riuscite sia quelle non riuscite (oltre non supera il limite) di chiamate API.
2. In Proxy Editor, fai clic sulla scheda Debug.
3. In Avvia una sessione di debug, seleziona l'ambiente in cui il proxy viene eseguito il deployment.
4. Fai clic su Start Debug Session (Avvia sessione di debug).

5. Chiama di nuovo il proxy API utilizzando curl (o con l'URL in un browser web) finché non viene visualizzato 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 Trova 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 superare la frequenza il limite è 429 Too many requests.

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

6. Fai clic sulla transazione 200 nel riquadro Transazioni a sinistra. Il suo debug il dettaglio viene caricato nella finestra principale in Transaction Map, che mostra una richiesta/risposta in questo diagramma. 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 (come illustrato nel seguente diagramma).

   Il riquadro Dettagli fase mostra i dati disponibili a quel punto nella flusso di lavoro. Se scorri il riquadro, vedrai le intestazioni e il corpo della risposta HTTP contenuti.

8. Ora osserva un errore in Debug.

   Fai clic sulla transazione 429 nel riquadro Transazioni. Nell'editor principale viene visualizzato un diagramma di flusso con solo gli elementi della richiesta, tra cui un arresto di 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 dell'arresto dei picchi e consulta i dettagli della violazione dell'arresto dei picchi nel riquadro Dettagli fase.

   

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

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

Per ulteriori informazioni, consulta Utilizzo del debug.