Compartilhar via


Dimensionar automaticamente uma instância do Gerenciamento de API do Azure

APLICA-SE A: Básico | Standard | Premium

Uma instância do 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 da escala automática do Azure Monitor.

O artigo aborda o processo de configuração do dimensionamento automático e sugere a configuração ideal das regras de dimensionamento automático.

Observação

  • 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 nenhuma configuração adicional necessária.

Pré-requisitos

Para executar as etapas deste artigo, é necessário:

Limitações do 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.

  • O tipo de preço da instância de Gerenciamento de API determina o número máximo de unidades para as quais você pode dimensionar. Por exemplo, a camada Standard pode ser dimensionada para 4 unidades. Você pode adicionar qualquer número de unidades para a camada Premium.
  • O processo de dimensionamento demora pelo menos 20 minutos.
  • Se o serviço estiver bloqueado por outra operação, a solicitação de dimensionamento falhará e será repetida automaticamente.
  • Se a instância de serviço for implantada em várias regiões (localizações), somente as unidades na Localização primária poderão ser dimensionadas automaticamente com o dimensionamento automático do Azure Monitor. As unidades em outras localizações só podem ser dimensionadas manualmente.
  • Se sua instância de serviço estiver configurada com zonas de disponibilidade na Localização primária, lembre-se 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 essas etapas para configurar o dimensionamento automático em um serviço de Gerenciamento de API do Azure:

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

  2. No menu à esquerda, selecione Escalar horizontalmente (dimensionamento automático) e, em seguida, selecione Dimensionamento automático personalizado.

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

  3. Na condição de escala Padrão selecione Escala baseada 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 disparar a adição de 1 unidade de Gerenciamento de API, quando a métrica de capacidade média nos últimos 30 minutos excede 70%. A tabela a seguir fornece um exemplo de configuração para essa regra. Examine as limitações anteriores ao definir uma regra de expansão em seu ambiente.

    Parâmetro Valor Observações
    Origem da métrica Recurso atual Defina a regra com base nas atuais métricas de recursos de Gerenciamento de API.
    Critérios
    Nome da métrica Capacity Métrica de capacidade é uma métrica do 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
    Limite da métrica 70% O limite para a métrica de capacidade média. Para obter considerações sobre como definir esse limite, consulte Usar a capacidade em decisões de dimensionamento.
    Duração (em minutos) 30 O intervalo de tempo para 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. Picos intermitentes terão menos efeito na decisão de expansão. No entanto, ele também atrasará o gatilho de escala horizontal.
    Estatística de intervalo de agregação Média
    Ação
    Operação Aumentar a contagem em
    Contagem de instâncias 1 Escalar horizontalmente a instância do Gerenciamento de API do Azure por 1 unidade.
    Tempo de resfriamento (minutos) 60 O serviço de Gerenciamento de API demora pelo menos 20 minutos para expansão. Na maioria dos casos, o período de resfriamento de 60 minutos impede o disparo de muitas escalas horizontais.
  5. Selecione Adicionar para salvar a regra.

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

    Nesse momento, uma regra de redução horizontal precisa ser definida. Isso garante que os recursos não sejam desperdiçados quando o uso das APIs diminui.

  7. Defina uma nova regra de redução horizontal.

    Por exemplo, uma regra de redução horizontal pode disparar a remoção de 1 unidade de Gerenciamento de API quando a métrica de capacidade média nos últimos 30 minutos é inferior a 35%. A tabela a seguir fornece um exemplo de configuração para essa regra.

    Parâmetro Valor Observações
    Origem da métrica Recurso atual Defina a regra com base nas atuais métricas de recursos de Gerenciamento de API.
    Critérios
    Agregação de tempo Média
    Nome da métrica Capacity Mesma métrica mesma que aquela usada para a regra de expansão.
    Location Selecione o local principal da instância de Gerenciamento de API
    Operador Menor que
    Limite 35% Assim como na regra de escala expansão, esse valor depende em grande parte dos padrões de uso da instância de Gerenciamento de API.
    Duração (em minutos) 30 Mesmo valor que aquele usado para a regra de expansão.
    Estatística de intervalo de agregação Média
    Ação
    Operação Diminuir contagem em Ao contrário do que foi usado para a regra de expansão.
    Contagem de instâncias 1 Mesmo valor que aquele usado para a regra de expansão.
    Tempo de resfriamento (minutos) 90 A redução horizontal deve ser mais conservadora do que uma expansão, portanto, o período de resfriamento deve ser mais longo.
  8. Selecione Adicionar para salvar a regra.

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

    Observação

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

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

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