Ridimensionare automaticamente un'istanza di Gestione API di Azure

SI APPLICA A: Basic | Standard | Premium

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 di Consumo viene ridimensionato automaticamente in base al traffico, senza alcuna configurazione aggiuntiva necessaria.

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 Create an Azure API Management instance (Creare un'istanza di Gestione API di Azure).
  • Comprendere il concetto di capacità di un'istanza di Gestione API.
  • Comprendere il 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à. Al livello Premium è possibile aggiungere un numero qualsiasi di unità.
  • Il processo di ridimensionamento richiede almeno 20 minuti.
  • 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 (località), 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 solo manualmente.
  • Se l'istanza del servizio è configurata con zone di disponibilità nel percorso primario, tenere presente il numero di zone durante la configurazione della scalabilità automatica. Il numero di unità gestione API nelle regole e nei limiti di scalabilità automatica deve essere un multiplo del numero di zone.

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:

  1. Accedere al portale di Azure e passare all'istanza di Gestione API.

  2. Nel menu a sinistra selezionare Scale out (scalabilità automatica), e quindi selezionare Scalabilità automatica personalizzata.

    Screenshot delle opzioni di scalabilità orizzontale nel portale.

  3. Nella condizione di scalabilità predefinita, selezionare Ridimensiona in base a una metricae quindi selezionare Aggiungi una regola.

    Screenshot della configurazione della condizione di scalabilità predefinita nel portale.

  4. 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. Esaminare le limitazioni precedenti quando si definisce una regola di scalabilità orizzontale nell'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 di capacità è una metrica di Gestione API che riflette l'utilizzo delle risorse da parte di un'istanza di Gestione API di Azure.
    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 L'aumento del numero di istanze per il servizio Gestione API richiede almeno 20 minuti. Nella maggior parte dei casi, l'intervallo di disattivazione delle regole di 60 minuti impedisce l'attivazione di più scale-out.
  5. Selezionare Aggiungi per salvare la regola.

  6. 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.

  7. 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
    Threshold 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.
  8. Selezionare Aggiungi per salvare la regola.

  9. In Limiti dell'istanza, selezionare il minimo, massimo e numero predefinito di unità gestione API.

    Nota

    Gestione API prevede un limite per le unità che è possibile aumentare per un'istanza. Il limite dipende dal livello di servizio.

    Screenshot che mostra come impostare i limiti delle istanze nel portale.

  10. Seleziona Salva. La scalabilità automatica è configurata.