Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
SI APPLICA A: Basic | Basic v2 | Standard | Standard v2 | Premium | Premium v2
Un'istanza del servizio Gestione API di Azure esegue la scalabilità automaticamente in base a un set di regole. Questo comportamento può essere abilitato e configurato tramite la scalabilità automatica di Monitoraggio di Azure.
L'articolo illustra il processo di configurazione della scalabilità automatica e suggerisce una configurazione ottimale delle regole di scalabilità automatica.
Nota
- Nei livelli di servizio che supportano più unità di scala, è anche possibile ridimensionare manualmente l'istanza di Gestione API.
- Un servizio Gestione API nel livello a consumo viene ridimensionato automaticamente in base al traffico, senza alcuna configurazione aggiuntiva necessaria.
Importante
Il completamento delle modifiche apportate all'infrastruttura del servizio Gestione API, ad esempio la configurazione di domini personalizzati, l'aggiunta di certificati CA, la scalabilità, la configurazione della rete virtuale, le modifiche della zona di disponibilità e le aggiunte all'area, possono richiedere 15 minuti o più, a seconda del livello di servizio e delle dimensioni della distribuzione. Prevedere tempi più lunghi per un'istanza con un numero maggiore di unità di scala o configurazione in più aree. Modifiche progressive al servizio di gestione delle API vengono eseguite con attenzione per preservare la capacità e la disponibilità.
Durante l'aggiornamento del servizio, non è possibile apportare altre modifiche all'infrastruttura del servizio. Tuttavia, è possibile configurare API, prodotti, criteri e impostazioni utente. Il servizio non riscontra tempi di inattività del gateway e Gestione API continuerà a gestire le richieste API senza interruzioni (ad eccezione del livello Sviluppatore).
Prerequisiti
Per eseguire i passaggi in questo articolo è necessario:
- Avere una sottoscrizione di Azure attiva.
- Disporre di un'istanza di Gestione API. Per altre informazioni, vedere Creare un'istanza di Gestione API di Azure.
- Comprendere il concetto di capacità di un'istanza di Gestione API.
- Informazioni sul ridimensionamento manuale di un'istanza di Gestione API, incluse le conseguenze dei costi.
Limitazioni di scalabilità automatica per Gestione API di Azure
Alcune limitazioni e conseguenze di decisioni di scalabilità devono essere prese in considerazione prima di configurare il comportamento di scalabilità automatica.
- Il piano tariffario dell'istanza di Gestione API determina il numero massimo di unità che è possibile ridimensionare. Ad esempio, il livello Standard può essere ridimensionato a 4 unità. È possibile aggiungere un numero qualsiasi di unità al livello Premium .
- Se il servizio è bloccato da un'altra operazione, la richiesta di ridimensionamento avrà esito negativo e riprova automaticamente.
- Se l'istanza del servizio viene distribuita in più aree (posizioni), solo le unità nella posizione primaria possono essere ridimensionate automaticamente con la scalabilità automatica di Monitoraggio di Azure. Le unità in altre posizioni possono essere ridimensionate manualmente o usando strumenti di ridimensionamento personalizzati.
- Se l'istanza del servizio è configurata con zone di disponibilità nella posizione primaria, è consigliabile lasciare l'impostazione automatica predefinita per le zone di disponibilità. Se si selezionano zone specifiche, il numero di unità di Gestione API nelle regole e nei limiti di scalabilità automatica deve essere un multiplo del numero di zone configurate.
Abilitare e configurare la scalabilità automatica per un'istanza di Gestione API
Seguire questa procedura per configurare la scalabilità automatica per un servizio Gestione API di Azure:
Accedere al portale di Azure e passare all'istanza di Gestione API.
Nel menu a sinistra selezionare Distribuzione e scalabilità orizzontale dell'infrastruttura>(scalabilità automatica) e quindi selezionare Scalabilità automatica personalizzata.
Nella condizione di scalabilità predefinita selezionare Ridimensiona in base a una metrica e quindi selezionare Aggiungi una regola.
Definire una nuova regola di scalabilità orizzontale.
Ad esempio, una regola di scalabilità orizzontale potrebbe attivare l'aggiunta di 1 unità gestione API, quando la metrica di capacità media dei 30 minuti precedenti supera il 70%. Nella tabella seguente viene fornita una configurazione di esempio per tale regola. Riesaminare le limitazioni sopraccitate quando si definisce una regola di scalabilità orizzontale nel tuo ambiente.
Parametro Valore Note Origine della metrica Risorsa corrente Definire la regola in base alle metriche delle risorse di Gestione API correnti. Criteri Nome metrica Capacità La metrica della capacità è una delle metriche di Gestione API che riflette l'utilizzo delle risorse da un'istanza di Gestione API di Azure. Scegliere una metrica di capacità supportata nel livello di servizio Gestione API. Ufficio Selezionare il percorso primario dell'istanza di Gestione API Operatore Maggiore di Soglia della metrica 70% Soglia per la metrica della capacità media. Per considerazioni sull'impostazione di questa soglia, vedere Uso della capacità per le decisioni di ridimensionamento. Durata (in minuti) 30 L'intervallo di tempo per calcolare la media della metrica della capacità è specifico per i modelli di utilizzo. Più lunga è la durata, più fluida sarà la reazione. I picchi intermittenti avranno un effetto minore sulla decisione di scalabilità orizzontale. Tuttavia, verrà ritardato anche il trigger di Scalabilità orizzontale. Statistica intervallo di tempo Media Azione Operazione Aumenta numero di Numero di istanze 1 Aumentare di un'unità il numero di istanze per un'istanza di Gestione API di Azure. Disattiva regole dopo (minuti) 60 Nella maggior parte dei casi, il periodo di pausa di 60 minuti evita l'innesco di molti scale-out. Selezionare Aggiungi per salvare la regola.
Per aggiungere un'altra regola, selezionare Aggiungi una regola.
Questa volta dovrà essere definita una regola di riduzione. Garantisce che le risorse non vengano sprecate quando l'utilizzo delle API diminuisce.
Definire una nuova regola di riduzione.
Ad esempio, una regola di scalabilità orizzontale potrebbe attivare una rimozione di 1 unità gestione API quando la metrica di capacità media dei 30 minuti precedenti è inferiore al 35%. Nella tabella seguente viene fornita una configurazione di esempio per tale regola.
Parametro Valore Note Origine della metrica Risorsa corrente Definire la regola in base alle metriche delle risorse di Gestione API correnti. Criteri Aggregazione temporale Media Nome metrica Capacità Metrica identica a quella usata per la regola della scalabilità orizzontale. Ufficio Selezionare il percorso primario dell'istanza di Gestione API Operatore Minore di Soglia 35% Proprio come per la regola della scalabilità orizzontale, questo valore dipende in modo rilevante dai modelli di utilizzo di Gestione API di Azure. Durata (in minuti) 30 Valore identico a quello usato per la regola della scalabilità orizzontale. Statistica intervallo di tempo Media Azione Operazione Riduci numero di Valore opposto a quello usato per la regola della scalabilità orizzontale. Numero di istanze 1 Valore identico a quello usato per la regola della scalabilità orizzontale. Disattiva regole dopo (minuti) 90 La riduzione deve essere più conservativa rispetto a una scalabilità orizzontale, pertanto il periodo di disattivazione delle regole dovrà essere più lungo. Selezionare Aggiungi per salvare la regola.
In Limiti dell'istanza selezionare il numero minimo, massimo e predefinito di unità di Gestione API.
Nota
Gestione API prevede un limite per le unità che è possibile aumentare per un'istanza. Il limite dipende dal livello di servizio.
Selezionare Salva. La scalabilità automatica è configurata.