Usando a extensão do Application Health com os Conjuntos de Dimensionamento de Máquinas Virtuais

O monitoramento de integridade do seu aplicativo é um sinal importante para gerenciar e atualizar sua implantação. Os Conjuntos de Dimensionamento de Máquinas Virtuais do Microsoft Azure fornecem suporte para Atualizações sem interrupção inclusive Atualizações automáticas de imagem do sistema operacional e Aplicação de patch automática de VM de convidado, que dependem do monitoramento de integridade das instâncias individuais para atualizar sua implantação. Você também pode usar a Extensão de integridade de aplicativos para monitorar a integridade do aplicativo de cada instância no conjunto de dimensionamento e realizar reparos de instância usando os Reparos automáticos de instância.

Esse artigo descreve como usar os dois tipos de extensão de Integridade do Aplicativo, Estados de Integridade Binários ou Estados de Integridade Avançados, para monitorar a integridade de seus aplicativos implantados em Conjuntos de Dimensionamento de Máquinas Virtuais.

Pré-requisitos

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

• Extensões da Máquina Virtual do Azure
• Modificando os Conjuntos de Dimensionamento de Máquinas Virtuais

Quando usar a Extensão de Integridade do Aplicativo

A Extensão Integridade do Aplicativo é implantada dentro de uma instância de Conjunto de Dimensionamento de Máquinas Virtuais e emite relatórios de integridade do aplicativo de dentro da instância de conjunto de dimensionamento. A extensão investiga um ponto de extremidade do aplicativo local e vai atualizar o status de integridade com base nas respostas TCP/HTTP(S) recebidas do aplicativo. Esse status da integridade é usado pelo Azure para iniciar reparos em instâncias não íntegras e para determinar se uma instância está 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 investigação externa, como as investigações de integridade do Azure Load Balancer , não pode ser usada.

Estados de Integridade Binários versus Estados de Integridade Avançados

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

¹ O estado Desconhecido não está disponível no protocolo TCP. ² Aplicável somente para os protocolos HTTP/HTTPS. O protocolo TCP seguirá o mesmo processo de identificação de instâncias Não íntegras que nos Estados de Integridade Binários.

Em geral, você deverá usar Estados de Integridade Binários se:

• Você não estiver interessado em configurar a lógica personalizada para identificar e sinalizar uma instância não íntegra
• Você não precisar de um período de carência de inicialização para instâncias recém-criadas

Você deverá usar Estados de Integridade Avançados se:

• Você envia sinais de integridade por meio do protocolo HTTP/HTTPS e pode enviar informações de integridade por meio do corpo da resposta da investigação
• Você gostaria de usar a lógica personalizada para identificar e marcar instâncias não íntegras
• Você gostaria de definir um período de carência de inicialização para instâncias recém-criadas, para que elas se estabeleçam em um estado de integridade estável antes de tornar a instância qualificada para a atualização sem interrupção ou reparos da instância

Estados de Integridade Binários

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

Protocolo HTTP/HTTPS

Protocolo TCP

Alguns cenários que podem resultar em um estado Não íntegro 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 de 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

Estados de Integridade Avançados

Os relatórios dos Estados de Integridade Avançados contêm quatro Estados de Integridade, Inicializando, Íntegro, Não Íntegro e Desconhecido. As tabelas a seguir fornecem uma breve descrição de como cada Estado de Integridade é configurado.

Protocolo HTTP/HTTPS

Protocolo TCP

Estado Inicializando

Esse estado só se aplica aos Estados de Integridade Avançados. O estado Inicializando ocorre apenas uma vez na hora de início da extensão e pode ser definido pelas configurações gracePeriod e numberOfProbes da extensão.

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

• O mesmo Estado de Integridade (Íntegro ou Não íntegro) for relatado um número consecutivo de vezes, conforme configurado por meio do numberOfProbes
• O gracePeriod se expira

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

Exemplo

Se numberOfProbes = 3, isso significaria:

• Para fazer a transição de Inicializando para estado Íntegro : a extensão de integridade do aplicativo deverá receber três sinais Íntegros consecutivos via protocolo HTTP/HTTPS ou TCP
• Para fazer a transição de Inicializando para estado Não íntegro : a extensão de integridade do aplicativo deverá receber três sinais Não íntegros consecutivos via protocolo HTTP/HTTPS ou 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 fará a transição de Inicializando para Desconhecido
• Protocolo TCP: a integridade do aplicativo fará a transição de Inicializando para Não íntegro

Estado desconhecido

Esse estado só se aplica aos Estados de Integridade Avançados. O estado Desconhecido só é relatado para investigações "http" ou "https" e ocorre nos seguintes cenários:

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

Uma instância em um estado Desconhecido é tratada de maneira semelhante a uma instância Não íntegra. Se habilitados, os reparos de instância serão realizados em uma instância Desconhecida enquanto as atualizações sem interrupção serão pausadas até que a instância volte para um estado Íntegro.

A tabela a seguir mostra a interpretação do status de integridade para Atualizações Sem Interrupção e Reparos de Instância:

Esquema de extensão para Estados de Integridade Binários

O JSON a seguir mostra o esquema para a extensão para VM do 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

Configurações

Esquema de extensão para Estados de Integridade Avançados

O JSON a seguir mostra o esquema para a extensão de Estados de Integridade Avançados. A extensão requer no mínimo uma solicitação "http" ou "https" com uma porta associada ou caminho de solicitação, respectivamente. As investigações de TCP também têm suporte, mas não poderão definir o ApplicationHealthState por meio do corpo da resposta da investigação 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

Configurações

Implantar a Extensão de Integridade do Aplicativo

Há várias maneiras de implantar a extensão Integridade do Aplicativo em seus conjuntos de dimensionamento conforme detalhado nos exemplos a seguir.

Estados de Integridade 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 "*"

Estados de Integridade Avançados

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 "*"

Solucionar problemas

Precisa de ajuda para configurar uma resposta de investigação

Consulte exemplos de integridade do aplicativo para ver exemplos de emissão de respostas de investigação de integridade para um ponto de extremidade local.

Exibir VMHealth – instância única

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

Exibir VMHealth – chamada em lote

Esta opção está disponível somente para Conjuntos de Dimensionamento de Máquinas Virtuais com orquestração Uniforme.

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

O Estado de Integridade não está aparecendo

Se o Estado de Integridade não estiver aparecendo no portal do Azure ou por meio da 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 nos arquivos localizados 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óximas etapas

Aprenda como Implantar o aplicativo em Conjuntos de Dimensionamento de Máquinas Virtuais.