Eseguire il debug delle API con la traccia delle richiesteDebug your APIs using request tracing

Questa esercitazione descrive come esaminare l'elaborazione delle richieste per aiutare gli sviluppatori a eseguire il debug e la risoluzione dei problemi correlati alle API.This tutorial describes how to inspect request processing to help you with debugging and troubleshooting your API.

In questa esercitazione si apprenderà come:In this tutorial, you learn how to:

  • Tenere traccia di una chiamataTrace a call

Controllo API

PrerequisitiPrerequisites

Per passare all'istanza di Gestione API, seguire questa procedura:To navigate to your APIM instance, follow these steps:

  1. Accedere al portale di Azure.Sign in to the Azure portal.
  2. SelezionareSelect freccia..
  3. Nella casella di ricerca digitare "api".Type "api" in the search box.
  4. Fare clic su Servizi Gestione API.Click API Management services.

    Esplorare

  5. Selezionare l'istanza del servizio Gestione API.Select your APIM service instance.

Suggerimento

Aggiungere Gestione API ai Preferiti del portale di Azure facendo clic sulla stella.Add API Management (APIM) to your favorites in the Azure portal by clicking the star.
L'icona Gestione API viene aggiunta al menu disponibile nella parte sinistra del portale.This adds the APIM icon to the menu on the left of the portal. Per visualizzare tutti i servizi di Gestione API, fare clic sull'icona (icona Gestione API).To see all your APIM services, click the icon (APIM icon).

Tenere traccia di una chiamataTrace a call

  1. Selezionare API.Select APIs.
  2. Fare clic su Demo Conference API (API Demo Conference) nell'elenco di API.Click Demo Conference API from your API list.
  3. Selezionare l'operazione GetSpeakers.Select GetSpeakers operation.
  4. Passare alla scheda Test.Switch to the Test tab.
  5. Includere un'impostazione HTTP denominata Ocp-Apim-Trace con valore impostato su true.Make sure to include an HTTP header named Ocp-Apim-Trace with the value set to true.
  6. Fare clic su "Invia" per effettuare una chiamata API.Click "Send" to make an API call.
  7. Attendere il completamento della chiamata.Wait for the call to complete.
  8. Passare alla scheda Traccia della console API.Go to the Trace tab in the API console. Fare clic su uno dei collegamenti seguenti per visualizzare informazioni di traccia dettagliate: inbound, backend, outbound.You can click any of the following links to jump to detailed trace info: inbound, backend, outbound.

    Nella sezione inbound vengono visualizzate le richieste originali che Gestione API ha ricevuto dal chiamante e tutti i criteri applicati alla richiesta, inclusi i criteri rate-limit e set-header aggiunti al passaggio 2.In the inbound section, you see the original request API Management received from the caller and all the policies applied to the request including the rate-limit and set-header policies we added in step 2.

    Nella sezione backend vengono visualizzate le richieste che Gestione API ha inviato al back-end dell'API e la risposta che ha ricevuto.In the backend section, you see the requests API Management sent to the API backend and the response it received.

    Nella sezione outbound vengono visualizzati tutti i criteri applicati alla risposta prima di restituirla al chiamante.In the outbound section, you see all the policies applied to the response before sending back to the caller.

    Suggerimento

    Ogni passaggio mostra inoltre il tempo trascorso da quando la richiesta è stata ricevuta da Gestione API.Each step also shows the elapsed time since the request is received by API Management.

Passaggi successiviNext steps

In questa esercitazione si è appreso come:In this tutorial, you learned how to:

  • Tenere traccia di una chiamataTrace a call

Passare all'esercitazione successiva:Advance to the next tutorial: