Fouten opsporen in Azure API Management-beleid in Visual Studio Code

  • Artikel

VAN TOEPASSING OP: Ontwikkelaar

Beleidsregels in Azure API Management bieden krachtige mogelijkheden waarmee API-uitgevers kruislingse problemen kunnen aanpakken, zoals verificatie, autorisatie, beperking, caching en transformatie. Beleidsregels zijn een verzameling instructies die sequentieel worden uitgevoerd op de aanvraag of het antwoord van een API.

In dit artikel wordt beschreven hoe u fouten kunt opsporen in API Management-beleid met behulp van de Azure API Management-extensie voor Visual Studio Code.

Vereisten

Beperkingen en limieten

  • Deze functie maakt gebruik van het ingebouwde (serviceniveau) abonnement voor alle toegang (weergavenaam 'Ingebouwd abonnement voor alle toegang') voor foutopsporing. De instelling Tracering toestaan moet zijn ingeschakeld in dit abonnement.

Waarschuwing

  • Alleen tracering toestaan voor abonnementen die zijn bedoeld voor foutopsporing. Het delen van abonnementssleutels met tracering die is toegestaan met niet-geautoriseerde gebruikers kan leiden tot onthulling van gevoelige informatie in traceringslogboeken zoals sleutels, toegangstokens, wachtwoorden, interne hostnamen en IP-adressen.
  • In de testconsole schakelt API Management tracering automatisch 1 uur uit nadat deze is ingeschakeld voor een abonnement.

Een foutopsporingssessie starten

  1. Visual Studio Code starten
  2. Navigeer naar de API Management-extensie onder Azure-extensies
  3. Het API Management-exemplaar zoeken om fouten op te sporen
  4. De API en bewerking zoeken om fouten op te sporen
  5. Klik met de rechtermuisknop op de bewerking en selecteer Beleidsopsporing starten

Op dit moment probeert de extensie een foutopsporingssessie met de API Management-gateway te starten en tot stand te brengen.

foutopsporing initiëren

Een testaanvraag verzenden

Wanneer de foutopsporingssessie tot stand is gebracht, opent de extensie een nieuwe editor waarmee we een HTTP-testaanvraag kunnen maken en verzenden naar deze bewerking met behulp van de REST Client-extensie.

U ziet dat de header Ocp-Apim-Debug al aan de aanvraag is toegevoegd. Deze header is vereist en de waarde moet worden ingesteld op de abonnementssleutel op serviceniveau voor alle toegang om de functionaliteit voor foutopsporing in de API Management-gateway te activeren.

Wijzig de HTTP-aanvraag in de editor volgens uw testscenario. Klik vervolgens op Aanvraag verzenden om de testaanvraag naar de API Management-gateway te verzenden.

een testaanvraag verzenden

Fouten opsporen in beleid

Nadat de HTTP-testaanvraag is verzonden, opent de extensie het foutopsporingsvenster met het effectieve beleid van deze bewerking en stopt deze bij het eerste effectieve beleid.

foutopsporingsbeleid

Als u de beleidspijplijn wilt volgen, kunt u afzonderlijke beleidsregels één stap doorlopen of een onderbrekingspunt instellen op een beleid en rechtstreeks naar dat beleid gaan.

In het deelvenster Variabelen kunt u waarden controleren van door het systeem gemaakte en door de gebruiker gemaakte variabelen. In het deelvenster Onderbrekingspunten ziet u de lijst met alle onderbrekingspunten die zijn ingesteld. In het deelvenster Oproepstack ziet u het huidige effectieve beleidsbereik.

Als er een fout optreedt tijdens het uitvoeren van het beleid, ziet u de details van de fout in het beleid waar deze is opgetreden.

uitzonderingen

Tip

Vergeet niet om de foutopsporingssessie af te sluiten door op de knop Stoppen te klikken wanneer u klaar bent.

Volgende stappen