Usando a extensão de integridade do aplicativo com conjuntos de dimensionamento de máquina virtual

Monitorar a integridade do aplicativo é um sinal importante para gerenciar e atualizar sua implantação. Os Conjuntos de Dimensionamento de Máquinas Virtuais do Azure fornecem suporte para Atualizações Graduais, incluindo Atualizações Automáticas de Imagem do SO e Patching Automático de Convidado de VM, que dependem do monitoramento de integridade das instâncias individuais para atualizar a sua distribuição. Você também pode usar a Extensão de Integridade do Aplicativo para monitorizar a integridade do aplicativo de cada instância no seu conjunto de escalas e realizar reparos de instâncias usando Reparos Automáticos de Instância.

Este artigo descreve como poderá usar os dois tipos de extensões de Saúde da Aplicação, Estados de Saúde Binários ou Estados de Saúde Avançados, para monitorizar a saúde das suas aplicações implantadas em Conjuntos de Escala de Máquinas Virtuais.

Pré-requisitos

Este artigo pressupõe que você esteja familiarizado com:

• Extensões de máquina virtual do Azure
• Modificando conjuntos de dimensionamento de máquinas virtuais

Quando usar a extensão Integridade da Aplicação

A Extensão de Integridade do Aplicativo é implantada dentro de uma instância do Conjunto de Escalonamento de Máquinas Virtuais e relata a integridade do aplicativo de dentro da instância do conjunto de escalonamento. A extensão sonda um endpoint da aplicação local e atualizará o status de integridade com base nas respostas TCP/HTTP(S) recebidas da aplicação. Esse status de integridade é usado pelo Azure para iniciar reparos em instâncias não íntegras e para determinar se uma instância é qualificada para operações de atualização.

A extensão relata a integridade de dentro de uma VM e pode ser usada em situações em que uma sonda externa, como as sondas de integridade do Balanceador de Carga do Azure, não pode ser usada.

Estados de saúde binários versus ricos

As Extensões de Integridade do Aplicativo têm duas opções: Estados Binários de Integridade e Estados Avançados de Integridade disponíveis. A tabela a seguir destaca algumas diferenças importantes entre as duas opções. Consulte o final desta secção para recomendações gerais.

1 O estado Desconhecido não está disponível no protocolo TCP. 2 Aplicável apenas ao protocolo HTTP/HTTPS. O protocolo TCP seguirá o mesmo processo de identificação de instâncias mal funcionantes como nos Estados de Saúde Binários.

Em geral, você deve usar Rich Health States se:

• Você envia sinais de estado através do protocolo HTTP/HTTPS e pode submeter informações de saúde através do corpo de resposta da sonda.
• Você gostaria de usar lógica personalizada para identificar e marcar instâncias com problemas
• Você gostaria de definir um período de carência de inicialização para novas instâncias, para que elas atinjam um estado de integridade saudável antes de tornar a instância elegível para atualização gradual ou reparos de instâncias.
• Você está interessado em ter mais controle sobre o processo de pedido e atualização com atualizações contínuas, emitindo métricas personalizadas

Você deve usar Estados de saúde binários se:

• Você não tem interesse em configurar a lógica personalizada para identificar e sinalizar uma instância com problemas.
• Não é necessário um período de carência de inicialização para instâncias recém-criadas
• Você não precisa usar métricas personalizadas ao executar uma atualização contínua em suas VMs

Estados ricos em saúde

Os relatórios dos Estados de Saúde Ricos contêm quatro Estados de Saúde, Inicializando, Saudável, Não Saudável e Desconhecido. As tabelas a seguir fornecem uma breve descrição sobre como cada Estado de Saúde é configurado.

Protocolo HTTP/HTTPS

Protocolo TCP

Estado de inicialização

Este estado só se aplica aos Estados Ricos em Saúde. O estado de inicialização ocorre apenas uma vez na hora de início da extensão e pode ser configurado pelas configurações gracePeriod de extensão e numberOfProbes.

Na inicialização da extensão, a integridade do aplicativo permanecerá no estado de inicialização até que um dos dois cenários ocorra:

• O mesmo estado de integridade (íntegro ou não íntegro) é relatado um número consecutivo de vezes, conforme configurado por meio de numberOfProbes
• O gracePeriod prazo expira

Se o mesmo Estado de Integridade (Saudável ou Não Íntegro) for relatado consecutivamente, a integridade do aplicativo fará a transição do estado de Inicialização para o Estado de Integridade relatado (Saudável ou Não Íntegro).

Exemplo

Se numberOfProbes = 3, isso significaria:

• Para fazer a transição do estado Inicializando para o estado Íntegro: A extensão de integridade da aplicação deve receber três sinais de Estado Íntegro consecutivos via protocolo HTTP/HTTPS ou TCP.
• Para fazer a transição do estado Inicializando para o estado Não Íntegro: A extensão de integridade do aplicativo deve receber três sinais consecutivos de Não Íntegro via HTTP/HTTPS ou protocolo TCP

Se o gracePeriod expirar antes que um status de integridade consecutivo seja relatado pelo aplicativo, a integridade da instância será determinada da seguinte maneira:

• Protocolo HTTP/HTTPS: A integridade do aplicativo passará de Inicializando para Desconhecido
• Protocolo TCP: A saúde do aplicativo fará a transição de Inicializando para Não Saudável

Estado desconhecido

Este estado só se aplica aos Estados Ricos em Saúde. O estado Desconhecido é relatado apenas para testes "http" ou "https" e ocorre nos seguintes cenários:

• Quando um código de status não-2xx é retornado pelo aplicativo
• Quando o tempo limite da solicitação de sonda expira
• Quando o ponto de extremidade do aplicativo está inacessível ou configurado incorretamente
• Quando um valor ausente ou inválido é fornecido no ApplicationHealthState corpo da resposta
• Quando expira o período de carência

Uma instância em um estado Desconhecido é tratada de forma semelhante a uma instância Insalubre. Se ativado, os reparos de instância serão realizados numa instância Desconhecida enquanto as atualizações em curso serão pausadas até que a instância volte a um estado Saudável.

A tabela a seguir mostra a interpretação do estado de saúde para atualizações contínuas e reparos de instância::

Esquema de extensão para Estados de Saúde Avançados

O JSON a seguir mostra o esquema para a extensão Rich Health States. A extensão requer no mínimo uma solicitação "http" ou "https" com uma porta associada ou caminho de solicitação, respectivamente. As sondas TCP também são suportadas, mas não poderão definir através do corpo de resposta da sonda o ApplicationHealthState e não terão acesso ao estado Desconhecido.

{
  "extensionProfile" : {
     "extensions" : [
      {
        "name": "HealthExtension",
        "properties": {
          "publisher": "Microsoft.ManagedServices",
          "type": "<ApplicationHealthLinux or ApplicationHealthWindows>",
          "autoUpgradeMinorVersion": true,
          "typeHandlerVersion": "2.0",
          "settings": {
            "protocol": "<protocol>",
            "port": <port>,
            "requestPath": "</requestPath>",
            "intervalInSeconds": 5,
            "numberOfProbes": 1,
            "gracePeriod": 600
          }
        }
      }
    ]
  }
} 

Valores de propriedade

Definições

Estados de saúde binários

O relatório do Estado de Saúde Binário contém dois Estados de Saúde, Saudável e Não Saudável. As tabelas a seguir fornecem uma breve descrição sobre como os Estados de Saúde são configurados.

Protocolo HTTP/HTTPS

Protocolo TCP

Nalguns cenários que podem resultar em estado não saudável incluem:

• Quando o ponto de extremidade do aplicativo retorna um código de status diferente de 200
• Quando não há nenhum ponto de extremidade do aplicativo configurado dentro das instâncias da máquina virtual para fornecer o status de integridade do aplicativo
• Quando o ponto de extremidade do aplicativo está configurado incorretamente
• Quando o ponto de extremidade do aplicativo não está acessível

Esquema de extensão para estados de saúde binários

O JSON a seguir mostra o esquema para a extensão Application Health. A extensão requer no mínimo uma solicitação "tcp", "http" ou "https" com uma porta associada ou caminho de solicitação, respectivamente.

{
  "extensionProfile" : {
     "extensions" : [
      {
        "name": "HealthExtension",
        "properties": {
          "publisher": "Microsoft.ManagedServices",
          "type": "<ApplicationHealthLinux or ApplicationHealthWindows>",
          "autoUpgradeMinorVersion": true,
          "typeHandlerVersion": "1.0",
          "settings": {
            "protocol": "<protocol>",
            "port": <port>,
            "requestPath": "</requestPath>",
            "intervalInSeconds": 5,
            "numberOfProbes": 1
          }
        }
      }
    ]
  }
} 

Valores de propriedade

Definições

Implantar a extensão de integridade do aplicativo

Há várias maneiras de implantar a extensão Application Health em seus conjuntos de escala, conforme detalhado nos exemplos a seguir.

Estados ricos em saúde

PUT on `/subscriptions/subscription_id/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet/extensions/myHealthExtension?api-version=2018-10-01`

{
  "name": "myHealthExtension",
  "location": "<location>",
  "properties": {
    "publisher": "Microsoft.ManagedServices",
    "type": "ApplicationHealthWindows",
    "autoUpgradeMinorVersion": true,
    "typeHandlerVersion": "2.0",
    "settings": {
      "protocol": "<protocol>",
      "port": <port>,
      "requestPath": "</requestPath>",
      "intervalInSeconds": <intervalInSeconds>,
      "numberOfProbes": <numberOfProbes>,
      "gracePeriod": <gracePeriod>
    }
  }
}

POST on `/subscriptions/<subscriptionId>/resourceGroups/<myResourceGroup>/providers/Microsoft.Compute/virtualMachineScaleSets/< myScaleSet >/manualupgrade?api-version=2022-08-01`

{
  "instanceIds": ["*"]
}

# Define the scale set variables
$vmScaleSetName = "myVMScaleSet"
$vmScaleSetResourceGroup = "myVMScaleSetResourceGroup"

# Define the Application Health extension properties
$publicConfig = @{"protocol" = "http"; "port" = 80; "requestPath" = "/healthEndpoint"; "gracePeriod" = 600};
$extensionName = "myHealthExtension"
$extensionType = "ApplicationHealthWindows"
$publisher = "Microsoft.ManagedServices"

# Get the scale set object
$vmScaleSet = Get-AzVmss `
  -ResourceGroupName $vmScaleSetResourceGroup `
  -VMScaleSetName $vmScaleSetName

# Add the Application Health extension to the scale set model
Add-AzVmssExtension -VirtualMachineScaleSet $vmScaleSet `
  -Name $extensionName `
  -Publisher $publisher `
  -Setting $publicConfig `
  -Type $extensionType `
  -TypeHandlerVersion "2.0" `
  -AutoUpgradeMinorVersion $True

# Update the scale set
Update-AzVmss -ResourceGroupName $vmScaleSetResourceGroup `
  -Name $vmScaleSetName `
  -VirtualMachineScaleSet $vmScaleSet
  
# Upgrade instances to install the extension
Update-AzVmssInstance -ResourceGroupName $vmScaleSetResourceGroup `
  -VMScaleSetName $vmScaleSetName `
  -InstanceId '*'

az vmss extension set \
  --name ApplicationHealthLinux \
  --publisher Microsoft.ManagedServices \
  --version 2.0 \
  --resource-group <myVMScaleSetResourceGroup> \
  --vmss-name <myVMScaleSet> \
  --settings ./extension.json

{
  "protocol": "<protocol>",
  "port": <port>,
  "requestPath": "</requestPath>",
  "gracePeriod": <healthExtensionGracePeriod>
}

az vmss update-instances \
  --resource-group <myVMScaleSetResourceGroup> \
  --name <myVMScaleSet> \
  --instance-ids "*"

Estados de saúde binários

PUT on `/subscriptions/subscription_id/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet/extensions/myHealthExtension?api-version=2018-10-01`

{
  "name": "myHealthExtension",
  "location": "<location>", 
  "properties": {
    "publisher": "Microsoft.ManagedServices",
    "type": "ApplicationHealthWindows",
    "autoUpgradeMinorVersion": true,
    "typeHandlerVersion": "1.0",
    "settings": {
      "protocol": "<protocol>",
      "port": <port>,
      "requestPath": "</requestPath>"
    }
  }
}

POST on `/subscriptions/<subscriptionId>/resourceGroups/<myResourceGroup>/providers/Microsoft.Compute/virtualMachineScaleSets/< myScaleSet >/manualupgrade?api-version=2022-08-01`

{
  "instanceIds": ["*"]
}

# Define the scale set variables
$vmScaleSetName = "myVMScaleSet"
$vmScaleSetResourceGroup = "myVMScaleSetResourceGroup"

# Define the Application Health extension properties
$publicConfig = @{"protocol" = "http"; "port" = 80; "requestPath" = "/healthEndpoint"};
$extensionName = "myHealthExtension"
$extensionType = "ApplicationHealthWindows"
$publisher = "Microsoft.ManagedServices"

# Get the scale set object
$vmScaleSet = Get-AzVmss `
  -ResourceGroupName $vmScaleSetResourceGroup `
  -VMScaleSetName $vmScaleSetName

# Add the Application Health extension to the scale set model
Add-AzVmssExtension -VirtualMachineScaleSet $vmScaleSet `
  -Name $extensionName `
  -Publisher $publisher `
  -Setting $publicConfig `
  -Type $extensionType `
  -TypeHandlerVersion "1.0" `
  -AutoUpgradeMinorVersion $True

# Update the scale set
Update-AzVmss -ResourceGroupName $vmScaleSetResourceGroup `
  -Name $vmScaleSetName `
  -VirtualMachineScaleSet $vmScaleSet
  
# Upgrade instances to install the extension
Update-AzVmssInstance -ResourceGroupName $vmScaleSetResourceGroup `
  -VMScaleSetName $vmScaleSetName `
  -InstanceId '*'

az vmss extension set \
  --name ApplicationHealthLinux \
  --publisher Microsoft.ManagedServices \
  --version 1.0 \
  --resource-group <myVMScaleSetResourceGroup> \
  --vmss-name <myVMScaleSet> \
  --settings ./extension.json

{
  "protocol": "<protocol>",
  "port": <port>,
  "requestPath": "</requestPath>"
}

az vmss update-instances \
  --resource-group <myVMScaleSetResourceGroup> \
  --name <myVMScaleSet> \
  --instance-ids "*"

Resolver problemas

Precisa de ajuda para configurar uma resposta de sonda

Consulte amostras de integridade do aplicativo para obter exemplos de respostas de sondas de integridade que estão a ser enviadas para um ponto final local.

View VMHealth - instância única

Get-AzVmssVM 
  -InstanceView `
  -ResourceGroupName <rgName> `
  -VMScaleSetName <vmssName> `
  -InstanceId <instanceId> 

Ver VMHealth – batch call

Isso só está disponível para conjuntos de escala de máquina virtual com orquestração uniforme.

GET on `/subscriptions/<subscriptionID>/resourceGroups/<resourceGroupName>/providers/Microsoft.Compute/virtualMachineScaleSets/<vmssName>/virtualMachines/?api-version=2022-03-01&$expand=instanceview`

Estado de saúde não está aparecendo

Se o Estado de Integridade não estiver aparecendo no portal do Azure ou por meio de chamada GET, verifique se a VM foi atualizada para o modelo mais recente. Se a VM não estiver no modelo mais recente, atualize a VM e o status de integridade aparecerá.

Log de saída de execução de extensão

A saída de execução da extensão é registrada em arquivos encontrados nos seguintes diretórios:

C:\WindowsAzure\Logs\Plugins\Microsoft.ManagedServices.ApplicationHealthWindows\<version>\

/var/lib/waagent/Microsoft.ManagedServices.ApplicationHealthLinux-<extension_version>/status
/var/log/azure/applicationhealth-extension

Os logs também capturam periodicamente o status de integridade do aplicativo.

Próximos passos

Saiba como implantar seu aplicativo em conjuntos de dimensionamento de máquina virtual.