Gerenciar o status da integridade do Azure Load Balancer

2024-11-02

O status da integridade é um recurso do Azure Load Balancer que traz informações detalhadas de integridade sobre as instâncias de back-end no pool de back-end do Azure Load Balancer. Vinculado à regra de balanceamento de carga, esse status apresenta insights sobre o estado de integridade e o raciocínio dessas instâncias de back-end.

Estado das instâncias de back-end

O status da integridade expõe o estado das instâncias de back-end. Há dois valores de estado:

State	Descrição
Operante	Esse valor de estado representa uma instância de back-end íntegra.
Para baixo	Esse valor de estado representa uma instância de back-end não íntegra.

Códigos de motivos

O status da integridade também expõe códigos de motivo, categorizados em códigos de motivo disparados pelo usuário e códigos de motivo disparados pela plataforma. Esses códigos ajudam você a entender os motivos precisos para o estado de investigação de integridade das suas instâncias de back-end e por que elas estão sendo investigadas como ativas ou inativas.

Códigos de motivo disparados pelo usuário

Os códigos de motivo disparados pelo usuário são disparados com base em como você configurou o Load Balancer. Elas podem ser tratadas por você, o usuário. As tabelas a seguir descrevem os códigos de motivo disparados pelo usuário, juntamente com o motivo exibido no portal para códigos de motivo com sucesso e com falha.

Códigos de motivo com sucesso

A seguinte tabela descreve os códigos de motivo com sucesso em que o estado de back-end é igual a Ativo:

Código de Motivo	Motivo exibido no portal	Descrição
Up_Probe_Success	A instância de back-end está respondendo à investigação de integridade com sucesso.	Sua instância de back-end está respondendo à investigação de integridade com sucesso.
Up_Probe_AllDownIsUp	A instância de back-end é considerada íntegra devido à habilitação de NoHealthyBackendsBehavior.	O estado de investigação de integridade da instância de back-end é ignorado porque NoHealthyBackendsBehavior está habilitado. A instância de back-end é considerada íntegra e pode receber o tráfego.
Up_Probe_ApproachingUnhealthyThreshold	A investigação de integridade está se aproximando de um limite não íntegro, mas a instância de back-end permanece íntegra de acordo com a última resposta.	A investigação mais recente não respondeu, mas a instância de back-end permanece íntegra o suficiente com base nas respostas anteriores.
Up_Admin	A instância de back-end está íntegra devido ao Estado do Administrador estar definido como Ativo.	O estado de investigação de integridade da instância de back-end é ignorado porque o Estado do Administrador está definido como Ativo. A instância de back-end é considerada íntegra e pode receber o tráfego.

Códigos de motivo com falha

A seguinte tabela descreve os códigos de motivo com falha em que o estado de back-end é igual a Inativo:

Código de Motivo	Motivo exibido no portal	Descrição
Down_Probe_ApproachingHealthyThreshold	A investigação de integridade está se aproximando de um limite íntegro, mas a instância de back-end permanece não íntegra de acordo com a última resposta.	O resultado da investigação mais recente é positivo, mas não atende ao número necessário de respostas no limite íntegro. Portanto, a instância de back-end permanece não íntegra.
Down_Probe_HttpStatusCodeError	Um código de status HTTP não 200 recebido, o que significa que há um problema com o aplicativo que escuta a porta.	Sua instância de back-end está retornando um código de status HTTP não 200, o que indica um problema com o aplicativo que escuta a porta.
Down_Probe_HttpEndpointUnreachable	Ponto de extremidade HTTP inacessível, o que significa uma porta de bloqueio de regra NSG ou um aplicativo não íntegro que escuta a porta.	A investigação de integridade foi capaz de estabelecer um handshake TCP com a sua instância de back-end, mas a sessão HTTP foi rejeitada, o que indica duas possibilidades: uma regra NSG está bloqueando a porta ou nenhum aplicativo íntegro está escutando a porta.
Down_Probe_TcpProbeTimeout	Tempo limite da investigação TCP; ou seja, uma instância de back-end não íntegra, uma porta de investigação de integridade bloqueada ou um aplicativo não íntegro que escuta a porta.	Sua instância de back-end não enviou uma resposta TCP dentro do intervalo de investigação. Isso indica três possibilidades: uma instância de back-end não íntegra, uma porta de investigação de integridade bloqueada ou um aplicativo não íntegro que escuta a porta.
Down_Probe_NoHealthyBackend	Nenhuma instância de back-end íntegra por trás do balanceador de carga regional.	O balanceador de carga regional associado a um balanceador de carga global não está protegido por nenhuma instância de back-end íntegra.
Down_Admin	A instância de back-end não está íntegra devido ao Estado do Administrador estar definido como Inativo.	O estado de investigação de integridade da instância de back-end é ignorado porque o Estado do Administrador está definido como Inativo. A instância de back-end é considerada não íntegra e não pode receber um novo tráfego.
Down_Probe_HttpNoResponse	O aplicativo não está retornando uma resposta.	A investigação de integridade foi capaz de estabelecer uma sessão HTTP, mas o aplicativo não está retornando uma resposta. Isso indica um aplicativo não íntegro que escuta a porta.

Observação

Em casos raros, NÃO.DISP será mostrado como um código de motivo. Esse código é mostrado quando a investigação de integridade ainda não investigou a instância de back-end e, portanto, não há nenhum código de motivo a ser exibido.

Códigos de motivo disparados pela plataforma

Os códigos de motivo disparados pela plataforma são disparados com base na plataforma do Azure Load Balancer. Esses códigos não podem ser resolvidos por você, o usuário. A seguinte tabela descreve cada um dos códigos de motivo:

Código de Motivo	Motivo exibido no portal	Descrição
Up_Platform	A instância de back-end está respondendo à investigação de integridade com sucesso, mas pode haver um problema relacionado à infraestrutura. A equipe de serviço do Azure foi alertada e resolverá o problema.	A instância de back-end está respondendo à investigação de integridade com sucesso, mas pode haver um problema relacionado à infraestrutura. A equipe de serviço do Azure foi alertada e resolverá o problema.
Down_Platform	A instância de back-end não está íntegra devido a um problema relacionado à infraestrutura. A equipe de serviço do Azure foi alertada e resolverá o problema.	A instância de back-end não está íntegra devido a um problema relacionado à infraestrutura. A equipe de serviço do Azure foi alertada e resolverá o problema.

Como recuperar o status da integridade

O status da integridade pode ser recuperado por regra de balanceamento de carga. Há suporte para esse recurso por meio da porta do Azure e da API REST.

Portal do Azure
REST API

Entre no portal do Azure.
Na barra de pesquisa, insira Balanceadores de carga e selecione Balanceadores de carga nos resultados da pesquisa.
Na página Balanceadores de carga, selecione o balanceador de carga na lista.
Na seção Configurações do balanceador de carga, selecione Regras de balanceamento de carga.
Na página Regras de balanceamento de carga, selecione Exibir detalhes na coluna status da integridade da regra que deseja exibir.
Analise o status da integridade das instâncias de back-end na janela status da integridade da regra de balanceamento de carga.
Para recuperar o status da integridade mais recente, selecione Atualizar.

Importante

A janela Status da integridade da regra de balanceamento de carga pode levar alguns minutos para carregar o status da integridade das instâncias de back-end.
Selecione Fechar para sair da janela Status da integridade da regra de balanceamento de carga.

Para recuperar as informações de status da integridade por meio da API REST, você precisa realizar um processo de duas solicitações.

Observação

Usar o método REST API requer que você tenha um token de acesso do portador para autorização. Para obter assistência na recuperação do token de acesso, confira Get-AzAccessToken para obter detalhes.

Use a solicitação POST a seguir para obter o URI de localização dos cabeçalhos de resposta.

  POST https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/loadBalancers/<loadBalancerName>/loadBalancingRules/<loadBalancingRulesName>/health?api-version=2024-03-01&preserve-view=true
    Authorization: Bearer <access token>

Copie o URI de localização dos cabeçalhos de resposta. O URI de localização deve seguir esse esquema.

    https://management.azure.com/subscriptions/<subscriptionId>/providers/Microsoft.Network/locations/<locationName>/operationResults/<operationResultsId>?api-version=2024-03-01&preserve-view=true

Use o URI de localização copiado para fazer uma solicitação GET.

    GET https://management.azure.com/subscriptions/<subscriptionId>/providers/Microsoft.Network/locations/<locationName>/operationResults/<operationResultsId>?api-version=2024-03-01&preserve-view=true

    Authorization: Bearer <access token>

Um código de status igual a 200 será retornado e as informações de status da integridade serão exibidas no corpo da resposta, de modo semelhante a este exemplo de resposta:

{
  "up": 2,
  "down": 0,
  "loadBalancerBackendAddresses": [
    {
      "ipAddress": "10.0.2.5",
      "networkInterfaceIPConfigurationId": "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/networkInterfaces/<networkInterfaceName>/ipConfigurations/<ipConfigurationName>",
      "state": "Up",
      "reason": "Up_Admin"
    },
    {
      "ipAddress": "10.0.2.4",
      "networkInterfaceIPConfigurationId": "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/networkInterfaces/<networkInterfaceName>/ipConfigurations/<ipConfigurationName>",
      "state": "Up",
      "reason": "Up_Probe_Success"
    }
  ]
}

Considerações sobre o design

Ao usar o recurso de status da integridade, leve em conta as seguintes considerações sobre design:

Se a instância da máquina virtual no pool de back-end estiver desativada, o status da integridade retornará valores vazios, pois o status da integridade não é recuperável.
Se você estiver usando um balanceador de carga global, o status da integridade exibirá o motivo como Down_Platform* quando o pool de back-end de um balanceador de carga regional for um endereço de back-end baseado em IP que não esteja associado a uma instância de máquina virtual.
Para recuperar o status da integridade, o portal do Azure e os métodos da API REST são os únicos métodos com suporte.

Limitações

Ao usar o recurso de status da integridade, considere as seguintes limitações:

Não há suporte para o status da integridade para regras de balanceamento de carga não investigadas.
Não há suporte para o status da integridade no Balanceador de carga do gateway.

Próximas etapas

Criar um balanceador de carga público com um back-end baseado em IP usando o portal do Azure