Partilhar via


Crie automaticamente uma instância de dimensionamento da Gestão de API do Azure

APLICA-SE A: BÁSICO | Padrão | Prémio

Uma instância de serviço de Gerenciamento de API do Azure pode ser dimensionada automaticamente com base em um conjunto de regras. Esse comportamento pode ser habilitado e configurado por meio do dimensionamento automático do Azure Monitor.

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.
  • Atualmente, não há suporte para o dimensionamento automático para o gateway de espaço de trabalho em espaços de trabalho de Gerenciamento de API.

Pré-requisitos

Para seguir as etapas deste artigo, você deve:

  • Ter uma subscrição ativa do Azure.
  • Tenha uma instância de Gerenciamento de API do Azure. Para obter mais informações, consulte Criar uma instância de Gerenciamento de API do Azure.
  • Entenda o conceito de capacidade de uma instância de Gerenciamento de API.
  • Entenda o dimensionamento manual de uma instância de Gerenciamento de API, incluindo as consequências de custo.

Limitações de dimensionamento automático do Gerenciamento de API 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 da sua instância de Gerenciamento de API determina o número máximo de unidades para as quais você pode ser dimensionado. Por exemplo, a camada Standard pode ser dimensionada para 4 unidades. Você pode adicionar qualquer número de unidades ao nível Premium .
  • O processo de dimensionamento leva pelo menos 20 minutos.
  • Se o serviço for bloqueado por outra operação, a solicitação de dimensionamento falhará e tentará novamente automaticamente.
  • Se sua instância de serviço for implantada em várias regiões (locais), somente as unidades no local Principal poderão ser dimensionadas automaticamente com o dimensionamento automático do Azure Monitor. As unidades em outros locais só podem ser dimensionadas manualmente.
  • Se sua instância de serviço estiver configurada com zonas de disponibilidade no local principal, esteja ciente do número de zonas ao configurar o dimensionamento automático. O número de unidades de gerenciamento de API em regras e limites de dimensionamento automático deve ser um múltiplo do número de zonas.

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

Siga estas etapas para configurar o dimensionamento automático para um serviço de Gerenciamento de API do Azure:

  1. Entre no portal do Azure e navegue até sua instância de Gerenciamento de API.

  2. No menu à esquerda, selecione Dimensionamento (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 Value 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 A métrica de capacidade é uma métrica de Gerenciamento de API que reflete o uso de recursos por uma instância de Gerenciamento de API do Azure.
    Location 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 do intervalo de agregação Média
    Ação
    Operação Aumentar a contagem em
    Contagem de instâncias 1 Dimensione a instância de Gerenciamento de API do Azure em 1 unidade.
    Repouso (minutos) 60 Leva pelo menos 20 minutos para que o serviço de Gerenciamento de API seja expandido. 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 Value 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.
    Location Selecione o local principal da instância de Gerenciamento de API
    Operador Menor que
    Threshold 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 do intervalo de agregação 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 usado para a regra de expansão.
    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 Guardar. O dimensionamento automático está configurado.