Capaciteit van een Azure API Management-exemplaar
Capaciteit is het belangrijkste Azure Monitor metrische gegevens voor het nemen van weloverwogen beslissingen of een exemplaar van API Management schaal moet worden geschaald om meer belasting aan te kunnen. De constructie is complex en legt bepaald gedrag op.
In dit artikel wordt uitgelegd wat de capaciteit is en hoe deze zich gedraagt. U ziet hoe u toegang krijgt tot metrische capaciteitsgegevens in Azure Portal en stelt voor wanneer u het schalen of upgraden van uw API Management overweegt.
Belangrijk
In dit artikel wordt beschreven hoe u uw Azure API Management kunt bewaken en schalen op basis van de metrische capaciteitsmetrische gegevens. Het is echter net zo belangrijk om te begrijpen wat er gebeurt wanneer een API Management exemplaar daadwerkelijk de capaciteit heeft bereikt. Azure API Management zal geen beperking op serviceniveau toepassen om een fysieke overbelasting van de exemplaren te voorkomen. Wanneer een exemplaar de fysieke capaciteit bereikt, gedraagt deze zich op dezelfde manier als elke overbelaste webserver die geen binnenkomende aanvragen kan verwerken: latentie neemt toe, verbindingen worden verwijderd, time-outfouten optreden, enzovoort. Dit betekent dat API-clients moeten worden voorbereid om met deze mogelijkheid om te gaan, net als bij andere externe service (bijvoorbeeld door beleid voor opnieuw proberen toe te passen).
Vereisten
Als u de stappen uit dit artikel wilt volgen, hebt u het volgende nodig:
Een actief Azure-abonnement.
Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
Een APIM-exemplaar. Zie Een Azure API Management maken voor meer informatie.
Beschikbaarheid
Belangrijk
Deze functie is beschikbaar in de Premium-, Standard-, Basic- en Developer-lagen van API Management.
Wat is capaciteit?

Capaciteit is een indicator van de belasting van een API Management exemplaar. Het geeft het gebruik van resources (CPU, geheugen) en de lengte van de netwerkwachtrij weer. 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 de Azure-portal of ARM, of belasting die afkomstig is van de ontwikkelaarsportal.
- Geselecteerde besturingssysteemprocessen, inclusief processen die kosten van TLS-handshakes voor nieuwe verbindingen met zich mee brengen.
Totale capaciteit is een gemiddelde van de eigen waarden uit elke eenheid van een API Management exemplaar.
Hoewel de metrische capaciteitsmetrische gegevens zijn ontworpen om problemen met uw API Management-exemplaar aan het licht te brengen, zijn er gevallen waarin problemen niet worden weerspiegeld in wijzigingen in de capaciteitsmetrische gegevens.
Gedrag van capaciteitsmetrische gegevens
Vanwege de constructie kan de werkelijke capaciteit worden beïnvloed door veel variabelen, bijvoorbeeld:
- verbindingspatronen (nieuwe verbinding bij een aanvraag versus hergebruik van de bestaande verbinding)
- grootte van een aanvraag en antwoord
- beleid dat is geconfigureerd voor elke API of het aantal clients dat aanvragen verstuurt.
Hoe complexer de bewerkingen voor de aanvragen zijn, hoe hoger het capaciteitsverbruik. Complexe transformatiebeleidsregels verbruiken bijvoorbeeld veel meer CPU dan het eenvoudig doorsturen van aanvragen. Trage reacties van de back-en-service verhogen dit ook.
Belangrijk
Capaciteit is geen directe meting van het aantal aanvragen dat wordt verwerkt.

De 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 instantie moet worden geschaald.
Metrische gegevens van lage capaciteit betekenen niet noodzakelijkerwijs dat uw API Management-instantie geen problemen ondervindt.
De Azure-portal gebruiken om capaciteit te onderzoeken

Navigeer naar uw APIM-exemplaar in Azure Portal.
Selecteer Metrische gegevens.
Selecteer in de paarse sectie Capaciteitsmetriek uit beschikbare metrische gegevens en laat de standaardaggregatie Gem. staan.
Tip
Bekijk altijd een uitsplitsing van metrische capaciteitsgegevens per locatie om verkeerde interpretaties te voorkomen.
Selecteer in de groene sectie Locatie om de metrische gegevens te splitsen op dimensie.
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 APIM-exemplaar de verwachte piekcapaciteit gedurende meer dan 20 minuten overschrijdt.
Tip
U kunt waarschuwingen configureren om u te laten weten wanneer de capaciteit van uw service bijna op is of u kunt Azure Monitor functie voor automatisch schalen gebruiken om automatisch een Azure API Management toevoegen. Het schalen kan ongeveer 30 minuten duren, dus u moet uw regels dienovereenkomstig plannen.
Alleen het schalen van de hoofdlocatie is toegestaan.
Capaciteit gebruiken voor beslissingen over schalen
Capaciteit is de metrische gegevens voor het nemen van beslissingen over het schalen van een API Management om meer belasting aan te kunnen. Overweeg het volgende:
- Kijkend naar een trend op de lange termijn en het gemiddelde.
- Het negeren van plotselinge pieken die waarschijnlijk niet zijn gerelateerd aan een toename van de belasting (zie de sectie Gedrag van metrische capaciteitsmetrische gegevens voor uitleg).
- Upgraden of schalen van uw exemplaar wanneer de waarde van de capaciteit voor een langere periode (bijvoorbeeld 30 minuten) 60% of 70% overschrijdt. Verschillende waarden werken mogelijk beter voor uw service of scenario.
Tip
Als u uw verkeer vooraf kunt schatten, test u uw APIM-exemplaar op workloads die u verwacht. U kunt de belasting van aanvragen voor uw tenant geleidelijk verhogen en controleren welke waarde van de metrische capaciteitswaarde overeenkomt met uw piekbelasting. Volg de stappen uit de vorige sectie om Azure Portal te begrijpen hoeveel capaciteit er op een bepaald moment wordt gebruikt.