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.
- Atualmente, o dimensionamento automático não tem suporte para o gateway do espaço de trabalho em espaços de trabalho de Gerenciamento de API.
Pré-requisitos
Para executar as etapas deste artigo, é necessário:
- Ter uma assinatura ativa do Azure.
- Ter uma instância do Gerenciamento de API do Azure. Para obter mais informações, consulte Criar uma instância do Gerenciamento de API do Azure.
- Entenda o conceito de capacidade de uma instância do Gerenciamento de API.
- Entenda a dimensionamento manual de uma instância de Gerenciamento de API, incluindo as consequências de custo.
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:
Entre no portal do Azure e navegue até a sua instância do Gerenciamento de API.
No menu à esquerda, selecione Escalar horizontalmente (dimensionamento automático) e, em seguida, selecione Dimensionamento automático personalizado.
Na condição de escala Padrão selecione Escala baseada em uma métrica e, em seguida, selecione Adicionar uma regra.
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. Selecione Adicionar para salvar a regra.
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.
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. Selecione Adicionar para salvar a regra.
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.
Selecione Salvar. O dimensionamento automático está configurado.