Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo mostra como habilitar a autoescalabilidade para um namespace do Grade de Eventos do Azure. O dimensionamento automático requer apenas três propriedades de configuração: um sinalizador de habilitação e os limites mínimo e máximo das unidades de taxa de transferência (TU). O Event Grid gerencia toda a lógica de escalabilidade internamente.
Você pode ativar a autoescala usando o portal do Azure, um template do Azure Resource Manager ou a API REST.
Pré-requisitos
- Uma assinatura do Azure. Crie uma conta gratuita se ainda não tiver a sua.
- Um namespace do Event Grid na camada Standard.
Importante
A autoescala não está disponível no nível Básico.
Ativar escala automática - portal do Azure
Entre no portal do Azure.
Na barra de busca, digite Event Grid Namespaces e selecione-o nos resultados.
Selecione seu namespace da lista.
Em Configurações, selecione Escalar.
Selecione Autoscal.
Defina o valor das unidades de rendimento mínimo . Esse valor é o menor número de TUs para o qual o namespace pode ser reduzido.
Defina o valor das unidades de rendimento máximo . Esse valor é o maior número de TUs até o qual o namespace pode aumentar. O valor máximo suportado é 40.
Selecione Aplicar.
Revise o resumo das mudanças e selecione Confirmar para aplicar as novas configurações de autoescala.
Note
Depois que você aplica as mudanças, o Autoscale entra em vigor quase imediatamente. O namespace avalia a utilização continuamente e ajusta as TUs conforme necessário.
Ativar dimensionamento automático - modelo ARM
Use o seguinte modelo do Azure Resource Manager para criar ou atualizar um namespace de Grade de Eventos com o autoscale ativado.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"namespaceName": {
"type": "string",
"metadata": { "description": "Name of the Event Grid namespace." }
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]",
"metadata": { "description": "Azure region for the namespace." }
},
"minThroughputUnits": {
"type": "int",
"defaultValue": 1,
"minValue": 1,
"maxValue": 40,
"metadata": { "description": "Minimum number of throughput units." }
},
"maxThroughputUnits": {
"type": "int",
"defaultValue": 10,
"minValue": 1,
"maxValue": 40,
"metadata": { "description": "Maximum number of throughput units." }
},
"enableAutoscale": {
"type": "bool",
"defaultValue": true,
"metadata": { "description": "Set to true to enable autoscale." }
}
},
"resources": [
{
"type": "Microsoft.EventGrid/namespaces",
"apiVersion": "2025-11-15-preview",
"name": "[parameters('namespaceName')]",
"location": "[parameters('location')]",
"sku": {
"name": "Standard",
"capacity": "[parameters('minThroughputUnits')]"
},
"properties": {
"autoScaleConfiguration": {
"enableAutoScale": "[parameters('enableAutoscale')]",
"minimumThroughputUnits": "[parameters('minThroughputUnits')]",
"maximumThroughputUnits": "[parameters('maxThroughputUnits')]"
}
}
}
]
}
Implante o template usando CLI do Azure:
az deployment group create \
--resource-group <resource-group-name> \
--template-file autoscale-namespace.json \
--parameters namespaceName=<namespace-name> \
minThroughputUnits=2 maxThroughputUnits=10
Ativar autoescalabilidade - API REST
Você pode ativar a autoescalabilidade ao criar ou atualizar um namespace de Grade de Eventos usando a API REST.
Crie ou atualize um namespace com dimensionamento automático habilitado (PUT)
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/namespaces/{namespaceName}?api-version=2025-11-15-preview
Corpo da solicitação:
{
"location": "eastus",
"sku": {
"name": "Standard",
"capacity": 1
},
"properties": {
"autoScaleConfiguration": {
"enableAutoScale": true,
"minimumThroughputUnits": 2,
"maximumThroughputUnits": 8
}
}
}
Atualizar o dimensionamento automático em um namespace existente (PATCH)
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/namespaces/{namespaceName}?api-version=2025-11-15-preview
Corpo da solicitação:
{
"properties": {
"autoScaleConfiguration": {
"enableAutoScale": true,
"minimumThroughputUnits": 1,
"maximumThroughputUnits": 10
}
}
}
Verificar configuração do Autoscale
Após ativar o Autoscale, verifique a configuração recuperando os detalhes do namespace.
API REST
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/namespaces/{namespaceName}?api-version=2025-11-15-preview
O corpo da resposta inclui a autoScaleConfiguration seção:
{
"id": "/subscriptions/12345678-.../providers/Microsoft.EventGrid/namespaces/my-namespace",
"name": "my-namespace",
"type": "Microsoft.EventGrid/namespaces",
"location": "eastus",
"sku": {
"name": "Standard",
"capacity": 1
},
"properties": {
"provisioningState": "Succeeded",
"autoScaleConfiguration": {
"enableAutoScale": true,
"minimumThroughputUnits": 1,
"maximumThroughputUnits": 10
},
"topicsConfiguration": {
"inputSchema": "CloudEventSchemaV1_0"
},
"topicSpacesConfiguration": {
"state": "Enabled",
"maximumSessionExpiryInHours": 1,
"maximumClientSessionsPerAuthenticationName": 1
},
"publicNetworkAccess": "Enabled",
"isZoneRedundant": false,
"minimumTlsVersionAllowed": "1.2"
},
"systemData": {
"createdBy": "user@contoso.com",
"createdByType": "User",
"createdAt": "2026-01-15T10:30:00.0000000Z",
"lastModifiedBy": "user@contoso.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2026-01-15T11:45:00.0000000Z"
}
}
Desativar escala automática
Esta seção mostra como desativar o autoescalonamento para um namespace de Grade de Eventos usando o portal do Azure e a API REST. O namespace mantém sua alocação atual de TU e para de escalar automaticamente.
portal do Azure
Siga estes passos para desativar a autoescala usando o portal do Azure:
Acesse o namespace da Grade de Eventos no portal do Azure.
Em Configurações, selecione Escalar.
Selecione Escala Manual para desativar a escala automática.
Selecione Aplicar para salvar as alterações.
API REST
Ao usar a API REST, defina enableAutoScale como false em propriedades .
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/namespaces/{namespaceName}?api-version=2025-11-15-preview
Corpo da solicitação:
{
"properties": {
"autoScaleConfiguration": {
"enableAutoScale": false
}
}
}
Práticas recomendadas
- Defina o número mínimo de TUs para lidar com sua carga base. O autoscale precisa de tempo para detectar mudanças de utilização e fornecer mais capacidade. Um valor mínimo que cubra o tráfego normal evita a redução de velocidade durante a aceleração inicial.
- Não defina a contagem máxima de TUs além do que seu orçamento permite. Cada TU alocado gera custos. Defina o valor máximo como a maior capacidade pela qual você está disposto a pagar nos períodos de pico.
- Leve em consideração o período de espera durante picos de tráfego. Após uma expansão, há um período dinâmico de espera antes da próxima operação de dimensionamento. Se sua carga de trabalho passar de ocioso para pico em segundos, defina um número mínimo de TU que absorva o surto inicial.
- Revise os limites de capacidade por TU para todas as categorias. O dimensionamento automático avalia todas as categorias (entrada de eventos, saída de eventos, publicação MQTT, clientes MQTT) juntas. Se sua carga de trabalho for dominada por uma categoria (por exemplo, conexões MQTT), seus requisitos de TU podem ser direcionados principalmente por essa categoria.