Capaciteit van een Azure API Management-exemplaar
VAN TOEPASSING OP: Ontwikkelaar | Basic | Standaard | Premium
Capaciteit is de belangrijkste metrische gegevens van Azure Monitor voor het nemen van weloverwogen beslissingen over het schalen of upgraden van een API Management-exemplaar om meer belasting mogelijk te maken. De constructie is complex en legt bepaald gedrag op.
In dit artikel wordt uitgelegd wat de capaciteit is en hoe deze zich gedraagt. Het laat zien hoe u metrische capaciteitsgegevens opent in Azure Portal en aangeeft wanneer u uw API Management-exemplaar wilt schalen of upgraden.
Belangrijk
In dit artikel wordt beschreven hoe u uw Azure API Management-exemplaar kunt bewaken en schalen op basis van de metrische capaciteit. Het is echter even belangrijk om te begrijpen wat er gebeurt wanneer een afzonderlijk API Management-exemplaar daadwerkelijk de capaciteit heeft bereikt . Azure API Management past geen beperking op serviceniveau toe om een fysieke overbelasting van de exemplaren te voorkomen. Wanneer een exemplaar de fysieke capaciteit bereikt, gedraagt het zich net als elke overbelaste webserver die binnenkomende aanvragen niet kan verwerken: latentie neemt toe, verbindingen worden verbroken, time-outfouten treden op, enzovoort. Dit betekent dat API-clients moeten worden voorbereid op deze mogelijkheid, net zoals bij andere externe services (bijvoorbeeld door beleid voor opnieuw proberen toe te passen).
Vereisten
Als u de stappen in dit artikel wilt volgen, moet u het volgende hebben:
Een actief Azure-abonnement.
Als u geen Azure-abonnement hebt, kunt u een gratis Azure-account maken voordat u begint.
Een API Management-exemplaar. Zie Een Azure API Management-exemplaar maken voor meer informatie.
Beschikbaarheid
Belangrijk
De Max-aggregatie van de metrische capaciteitsgegevens wordt alleen ondersteund in de Premium-laag van API Management.
Wat is capaciteit?
Capaciteit is een indicator van de belasting van een API Management-exemplaar. Het weerspiegelt het gebruik van resources (CPU, geheugen) en netwerkwachtrijlengten. CPU- en geheugengebruik toont het verbruik van resources door:
- API Management-gegevensvlakservices, zoals aanvraagverwerking, zoals het doorsturen van aanvragen of het uitvoeren van een beleid.
- Api Management-beheervlakservices, zoals beheeracties die worden toegepast via Azure Portal of Azure Resource Manager, of belasting die afkomstig is van de ontwikkelaarsportal.
- Geselecteerde besturingssysteemprocessen, inclusief processen die kosten van TLS-handshakes voor nieuwe verbindingen met zich meebrengen.
- Platformupdates, zoals besturingssysteemupdates voor de onderliggende rekenresources voor het exemplaar.
- Het aantal geïmplementeerde API's, ongeacht de activiteit, die extra capaciteit kan verbruiken.
De totale capaciteit is een gemiddelde van zijn eigen waarden uit elke eenheid van een API Management-exemplaar.
Hoewel de metrische capaciteit is ontworpen om problemen met uw API Management-exemplaar op te lossen, zijn er gevallen waarin problemen niet worden weerspiegeld in wijzigingen in de metrische capaciteit.
Gedrag van metrische capaciteit
Vanwege de constructie kan de werkelijke capaciteit worden beïnvloed door veel variabelen, bijvoorbeeld:
- verbindingspatronen (nieuwe verbinding op een aanvraag versus het hergebruik van de bestaande verbinding)
- grootte van een aanvraag en antwoord
- beleid dat is geconfigureerd voor elke API of het aantal clients dat aanvragen verzendt.
Hoe complexere bewerkingen voor de aanvragen zijn, hoe hoger het capaciteitsverbruik is. Complexe transformatiebeleiden verbruiken bijvoorbeeld veel meer CPU dan een eenvoudig doorsturen van aanvragen. Trage back-endservicereacties zullen dit ook verhogen.
Belangrijk
Capaciteit is geen directe meting van het aantal aanvragen dat wordt verwerkt.
Capaciteit kan ook af en toe pieken of groter zijn dan nul, zelfs als er geen aanvragen worden verwerkt. Dit gebeurt vanwege systeem- of platformspecifieke acties en moet niet in overweging worden genomen bij het bepalen of een exemplaar moet worden geschaald.
Metrische gegevens over lage capaciteit betekenen niet noodzakelijkerwijs dat uw API Management-exemplaar geen problemen ondervindt.
Gebruik Azure Portal om capaciteit te onderzoeken
Navigeer naar uw API Management-exemplaar in Azure Portal.
Selecteer in het linkermenu onder Bewaking de optie Metrische gegevens.
Selecteer de metrische capaciteit in de beschikbare metrische gegevens en laat de standaardaggregatie Avg staan.
Tip
Als u uw exemplaar op meerdere locaties hebt geïmplementeerd, moet u altijd een uitsplitsing van capaciteitsgegevens per locatie bekijken om verkeerde interpretaties te voorkomen.
Als u de metrische waarde wilt splitsen op locatie, selecteert u splitsen toepassen in de sectie bovenaan en selecteert u Vervolgens Locatie.
Kies een gewenste periode in de bovenste balk van de sectie.
U kunt een waarschuwing voor metrische gegevens instellen om u te laten weten wanneer er iets onverwachts gebeurt. Ontvang bijvoorbeeld meldingen wanneer uw API Management-exemplaar de verwachte piekcapaciteit gedurende meer dan 20 minuten heeft overschreden.
Tip
U kunt waarschuwingen configureren om u te laten weten wanneer uw service weinig capaciteit heeft of automatische schaalaanpassing van Azure Monitor gebruikt om automatisch een Azure API Management-eenheid toe te voegen. De schaalbewerking kan ongeveer 30 minuten duren, dus u moet uw regels dienovereenkomstig plannen.
Alleen het schalen van de hoofdlocatie is toegestaan.
Capaciteit gebruiken voor schaalbeslissingen
Capaciteit is de meetwaarde voor het nemen van beslissingen over het schalen van een API Management-exemplaar om meer belasting mogelijk te maken. Hier volgen algemene overwegingen:
- Bekijk een langetermijntrend en een gemiddeld gemiddelde.
- Negeer plotselinge pieken die waarschijnlijk niet zijn gerelateerd aan een toename van de belasting (zie de sectie Metrische capaciteitsgedrag voor uitleg).
- Als algemene regel moet u uw exemplaar upgraden of schalen wanneer de capaciteitswaarde langer is dan 60% - 70% gedurende een lange periode (bijvoorbeeld 30 minuten). Verschillende waarden werken mogelijk beter voor uw service of scenario.
- Als uw exemplaar is geconfigureerd met slechts één eenheid, moet u uw exemplaar upgraden of schalen wanneer de capaciteitswaarde gedurende een lange periode groter is dan 40% . Deze aanbeveling is gebaseerd op de noodzaak om capaciteit te reserveren voor updates van gastbesturingssystemen in het onderliggende serviceplatform.
Tip
Als u uw verkeer vooraf kunt schatten, test u uw API Management-exemplaar op workloads die u verwacht. U kunt de belasting van de aanvraag voor uw tenant geleidelijk verhogen en de waarde bewaken van de metrische capaciteitsgegevens die overeenkomen met uw piekbelasting. Volg de stappen uit de vorige sectie om Azure Portal te gebruiken om te begrijpen hoeveel capaciteit op een bepaald moment wordt gebruikt.