Partilhar via


Escalar automaticamente uma instância do API Management do Azure

APLICA-SE A: BÁSICO | Básico v2 | Padrão | Padrão v2 | Prémio | Premium v2

Uma instância de serviço API Management do Azure pode escalar automaticamente com base num conjunto de regras. Este comportamento pode ser ativado e configurado através de Azure Monitor autoscale.

O artigo descreve o processo de configuração da escala automática e sugere a configuração ideal das regras de escala automática.

Nota

  • Em camadas de serviço que oferecem suporte a várias unidades de escala, você também pode dimensionar manualmente sua instância de Gerenciamento de API.
  • Um serviço de Gerenciamento de API na camada de Consumo é dimensionado automaticamente com base no tráfego, sem necessidade de qualquer configuração adicional.

Importante

As alterações na infraestrutura do serviço de Gerenciamento de API (como configuração de domínios personalizados, adição de certificados de CA, dimensionamento, configuração de rede virtual, alterações de zona de disponibilidade e adições de região) podem levar 15 minutos ou mais para serem concluídas, dependendo da camada de serviço e do tamanho da implantação. Espere tempos de espera mais longos para uma instância com um maior número de unidades de escalabilidade ou configuração de múltiplas regiões (gateways em várias localizações). As alterações contínuas no Gerenciamento de API são executadas cuidadosamente para preservar a capacidade e a disponibilidade.

Enquanto o serviço está sendo atualizado, outras alterações na infraestrutura do serviço não podem ser feitas. No entanto, você pode definir APIs, produtos, políticas e configurações de usuário. O serviço não enfrentará tempo de inatividade do gateway e o Gerenciamento de API continuará a atender solicitações de API sem interrupção (exceto na camada de desenvolvedor).

Pré-requisitos

Para seguir as etapas deste artigo, você deve:

Limitações de escala automática no API Management do Azure

Certas limitações e consequências das decisões de dimensionamento precisam ser consideradas antes de configurar o comportamento de dimensionamento automático.

  • A camada de preços de sua instância de Gestão de API determina o número máximo de unidades para o qual a sua instância pode ser dimensionada. Por exemplo, a camada Standard pode ser escalada para 4 unidades. Você pode adicionar qualquer número de unidades ao nível Premium .
  • Se o serviço for bloqueado por outra operação, a solicitação de dimensionamento falhará e tentará novamente automaticamente.
  • Se a sua instância de serviço estiver implantada em várias regiões (localizações), apenas as unidades na Primary location podem ser autoescaladas com Azure Monitor autoscale. As unidades em outros locais podem ser dimensionadas manualmente ou usando ferramentas de dimensionamento personalizadas.
  • Se sua instância de serviço estiver configurada com zonas de disponibilidade no local principal, recomendamos deixar a configuração Automática padrão para zonas de disponibilidade. Se você selecionar zonas específicas, o número de unidades de gerenciamento de API em regras e limites de dimensionamento automático deverá ser um múltiplo do número de zonas configuradas.

Habilitar e configurar o dimensionamento automático para uma instância de Gerenciamento de API

Siga estes passos para configurar a autoescalabilidade para um serviço API Management do Azure:

  1. Inicie sessão no portal Azure e navegue até à sua instância de Gestão de APIs.

  2. No menu à esquerda, selecione Implementação + infraestrutura>Escalonar (dimensionamento automático) e, em seguida, selecione Dimensionamento automático personalizado.

    Captura de ecrã das opções de expansão no portal.

  3. Na condição Escala padrão , selecione Dimensionar com base em uma métrica e, em seguida, selecione Adicionar uma regra.

    Captura de tela da configuração da condição de escala padrão no portal.

  4. Defina uma nova regra de expansão.

    Por exemplo, uma regra de expansão pode acionar a adição de 1 unidade de Gerenciamento de API, quando a métrica de capacidade média nos 30 minutos anteriores exceder 70%. A tabela a seguir fornece um exemplo de configuração para tal regra. Analise as limitações anteriores ao definir uma regra de expansão em seu ambiente.

    Parâmetro Valor Notas
    Origem métrica Recurso atual Defina a regra com base nas métricas de recursos atuais do Gerenciamento de API.
    Critérios
    Nome da métrica Capacidade Métrica de Capacidade é uma das métricas de Gestão de API do Azure que reflete a utilização de recursos de uma instância do API Management do Azure. Escolha uma métrica de capacidade suportada em sua camada de serviço de Gerenciamento de API.
    Localização Selecione o local principal da instância de Gerenciamento de API
    Operador Maior que
    Limiar métrico 70% O limite para a métrica de capacidade média. Para obter considerações sobre como definir esse limite, consulte Usando a capacidade para decisões de dimensionamento.
    Duração (em minutos) 30 O período de tempo para calcular a média da métrica de capacidade é específico para padrões de uso. Quanto maior a duração, mais suave será a reação. Os picos intermitentes terão menos efeito na decisão de expansão. No entanto, também atrasará o gatilho de expansão.
    Estatística de granularidade temporal Média
    Ação
    Operação Aumentar a contagem em
    Contagem de instâncias 1 Escala a instância do API Management do Azure em 1 unidade.
    Repouso (minutos) 60 Na maioria dos casos, o período de resfriamento de 60 minutos impede o desencadeamento de muitas escalas.
  5. Selecione Adicionar para salvar a regra.

  6. Para adicionar outra regra, selecione Adicionar uma regra.

    Desta vez, é necessário definir uma regra de escalonamento. Ele garante que os recursos não estejam sendo desperdiçados quando o uso de APIs diminuir.

  7. Defina uma nova regra de expansão.

    Por exemplo, uma regra de escalonamento pode acionar uma remoção de 1 unidade de Gerenciamento de API quando a métrica de capacidade média nos 30 minutos anteriores for inferior a 35%. A tabela a seguir fornece um exemplo de configuração para tal regra.

    Parâmetro Valor Notas
    Origem métrica Recurso atual Defina a regra com base nas métricas de recursos atuais do Gerenciamento de API.
    Critérios
    Agregação de tempo Média
    Nome da métrica Capacidade Mesma métrica usada para a regra de expansão.
    Localização Selecione o local principal da instância de Gerenciamento de API
    Operador Menor que
    Limite 35% Assim como acontece com a regra de expansão, esse valor depende muito dos padrões de uso da instância de Gerenciamento de API.
    Duração (em minutos) 30 O mesmo valor usado para a regra de expansão.
    Estatística de granularidade temporal Média
    Ação
    Operação Diminuir a contagem em Ao contrário do que foi usado para a regra de scale-out.
    Contagem de instâncias 1 O mesmo valor que o utilizado para a regra de escalabilidade.
    Repouso (minutos) 90 O scale-in deve ser mais conservador do que o scale-out, pelo que o período de arrefecimento deve ser mais longo.
  8. Selecione Adicionar para salvar a regra.

  9. Em Limites de instância, selecione o número Mínimo, Máximo e Padrão das unidades de gerenciamento de API.

    Nota

    O Gerenciamento de API tem um limite de unidades para as quais uma instância pode ser dimensionada. O limite depende da camada de serviço.

    Captura de tela mostrando como definir limites de instância no portal.

  10. Selecione Salvar. O dimensionamento automático está configurado.