Visualizzare i dati dei messaggi con Trace

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X.
informazioni

Cosa imparerai a fare

Con 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

  • Almeno un criterio nel proxy (parte anche del tutorial introduttivo).
  • curl installato sulla tua macchina per effettuare chiamate API dalla riga di comando.

Visualizzare i dati dei messaggi

Lo strumento Trace proxy API consente di visualizzare intestazioni, variabili, oggetti e altri dettagli, come il tempo di risposta nel flusso di richiesta e risposta del proxy API. Lo strumento Trace consente inoltre di vedere come cambia una richiesta o una risposta mentre viene elaborata da un proxy API.

Nel tutorial precedente, hai limitato il numero di richieste con il criterio SpikeArrest. Ora utilizzerai lo strumento Trace per visualizzare dettagli interessanti quando questo valore viene superato.

  1. Nella scheda Sviluppo del proxy API, modifica il valore <Rate> del criterio di Spike Arrest impostandolo su 13:00, quindi Salva il proxy. In questo modo potremo visualizzare le chiamate API riuscite e non riuscite (oltre il limite).
  2. Nell'editor proxy API, fai clic sulla scheda Trace (Traccia).

  3. Fai clic su Avvia sessione di traccia.

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

    curl "http://org_name-test.apigee.net/getstarted"

  5. Fai clic su Interrompi sessione di traccia.

  6. Fai clic sulla transazione 200 nel riquadro Transazioni a sinistra. I relativi dettagli di traccia vengono caricati nella finestra principale della Mappa transazioni, in cui è visualizzato un diagramma di richiesta/risposta. L'icona di arresto con picco si trova 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 della risposta HTTP e il contenuto del corpo.

  8. Ora osserva un errore in Trace.

    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 i picchi con un punto esclamativo rosso che indica un errore.

    Fai clic sulla piccola icona di errore del tubo a destra dell'icona di Arresto del picco ed esamina i dettagli della violazione in questione nel riquadro Dettagli fase.

    Picco di errore di arresto

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

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

Per ulteriori informazioni, consulta la sezione Utilizzo dello strumento Trace.