Использование расширения "Работоспособности приложений" с Масштабируемые наборы виртуальных машин

Мониторинг работоспособности приложения предоставляет важные сведения, которые позволяют определить, когда требуется администрирование и обновление развертывания. Azure Масштабируемые наборы виртуальных машин предоставляют поддержку последовательного обновления, включая автоматическое обновление образа ОС и автоматическое исправление гостевой виртуальной машины, которые зависят от мониторинга работоспособности отдельных экземпляров для обновления вашего развертывания. Вы также можете использовать расширение Application Health Extension для мониторинга работоспособности каждого экземпляра в вашем масштабируемом наборе и проведения ремонтных работ с помощью автоматического восстановления экземпляров.

В этой статье описывается, как использовать два типа расширения "Работоспособность приложений", "Двоичные состояния работоспособности" или "Богатые состояния здоровья" для мониторинга работоспособности приложений, развернутых на Масштабируемые наборы виртуальных машин.

Предварительные условия

Для работы с этой статьей нужны знания в следующих областях:

• Расширения виртуальной машины Azure.
• Изменение масштабируемых наборов виртуальных машин

Когда использовать расширение "Работоспособность приложения"

Расширение работоспособности приложений развертывается в экземпляре масштабируемого набора виртуальных машин и сообщает о работоспособности приложений из экземпляра масштабируемого набора. Модуль проверяет конечную точку локального приложения и обновляет состояние работоспособности на основе ответов TCP/HTTP(S), полученных от приложения. Это состояние работоспособности используется Azure для запуска восстановления неработоспособных экземпляров и определения того, имеет ли экземпляр право на операции обновления.

Расширение сообщает о состоянии из виртуальной машины и может использоваться в ситуациях, когда внешние проверки, например запросы состояния в Azure Load Balancer, использовать нельзя.

Бинарные и сложные состояния здоровья

Расширения здоровья приложений имеют два варианта: двойичные состояния здоровья и богатые состояния здоровья. В следующей таблице перечислены некоторые ключевые различия между двумя параметрами. В конце этого раздела приведены общие рекомендации.

¹ Неизвестное состояние недоступно в протоколе TCP. ² Применимо только для протокола HTTP/HTTPS. Протокол TCP будет следовать тому же процессу определения неисправных экземпляров, как и в двоичных состояниях работоспособности.

В целом, следует использовать Rich Health States, если:

• Вы отправляете сигналы работоспособности через протокол HTTP/HTTPS и можете отправлять сведения о работоспособности через текст ответа проверки.
• Вы хотите использовать пользовательскую логику для идентификации и маркировки неработоспособных экземпляров
• Вы хотите установить льготный период инициализации для вновь созданных экземпляров, чтобы они достигли устойчивого состояния работоспособности, прежде чем они будут готовы для поочередного обновления или ремонта.
• Вам нужно более контролировать процесс упорядочивания и обновления с помощью последовательного обновления, предоставляя пользовательские метрики

Вам следует использовать двоичные состояния работоспособности, если:

• Вы не заинтересованы в настройке пользовательской логики для идентификации и флагирования нездорового экземпляра
• Не требуется инициализация льготного периода для только что созданных экземпляров
• При выполнении последовательного обновления на виртуальных машинах не нужно использовать пользовательские метрики .

Богатые состояния здоровья

Отчеты о богатых состояниях здравоохранения содержат четыре состояния здоровья, инициализацию, работоспособность, неработоспособную и неизвестнаю. В следующих таблицах приводится краткое описание настройки каждого состояния работоспособности.

Протокол HTTP/HTTPS

Протокол TCP

Инициализация состояния

Это состояние относится только к богатым состояниям здравоохранения. Состояние инициализации происходит только один раз во время начала расширения и может быть настроено параметрами gracePeriod расширения и numberOfProbes.

При запуске расширения работоспособность приложения останется в состоянии инициализации до тех пор, пока не произойдет одно из двух сценариев:

• То же состояние работоспособности (работоспособное или неработоспособное) сообщается последовательное число раз, как настроено с помощью numberOfProbes.
• Срок gracePeriod действия истекает

Если одно и то же состояние работоспособности (работоспособное или неработоспособное) сообщается последовательно, работоспособность приложения переходит из состояния инициализации и в сообщаемое состояние работоспособности (работоспособное или неработоспособное).

Пример

Если numberOfProbes = 3, это означает:

• Чтобы перейти от инициализации к работоспособному состоянию: расширение работоспособности приложения должно получать три последовательных сигналов работоспособности через протокол HTTP/HTTPS или TCP
• Для перехода из состояния Инициализация в состояние Неработоспособность расширение работоспособности приложения должно получать три последовательных сигнала Неработоспособность через протокол HTTP/HTTPS или TCP.

gracePeriod Если срок действия истекает до того, как приложение сообщает о последовательных состояниях работоспособности, работоспособность экземпляра будет определена следующим образом:

• Протокол HTTP/HTTPS: работоспособность приложения переходит от инициализации к неизвестному
• ПРОТОКОЛ TCP: работоспособность приложения переходит от инициализации к неработоспособной

Неизвестное состояние

Это состояние относится только к богатым состояниям здравоохранения. Неизвестное состояние сообщается только для http- или https-запросов и возникает в следующих сценариях:

• Если приложением возвращается код состояния, неравный 2xx.
• Когда время ожидания запроса пробы истекает
• Если конечная точка приложения недоступна или неправильно настроена
• Когда в теле ответа предоставлено отсутствующее или недопустимое значение для ApplicationHealthState
• Когда истекает льготный период

Экземпляр в состоянии "Неизвестно" рассматривается аналогично экземпляру в состоянии "Неработоспособно". Если этот параметр включен, восстановление экземпляра будет выполнено в неизвестном экземпляре во время приостановки обновлений, пока экземпляр не вернется в работоспособное состояние.

В следующей таблице показана интерпретация состояния работоспособности для скользящего обновления и восстановления экземпляров:

Схема расширения для полноценных состояний здоровья

Следующий JSON-файл показывает схему расширения "Rich Health States". Для расширения требуется как минимум запрос http или https с соответствующим портом или путем запроса соответственно. Также поддерживаются пробы TCP, но они не смогут установить ApplicationHealthState через тело ответа пробы и не будут иметь доступа к состоянию Неизвестно.

{
  "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
          }
        }
      }
    ]
  }
} 

Значения свойств

Настройки

Двоичные состояния работоспособности

Отчеты о состоянии работоспособности двоичного состояния содержат два состояния работоспособности, работоспособность и неработоспособность. В следующих таблицах представлено краткое описание настройки состояний здоровья.

Протокол HTTP/HTTPS

Протокол TCP

К некоторым сценариям, которые могут привести к неработоспособному состоянию , относятся:

• Когда конечная точка приложения возвращает код состояния, отличный от 200
• Если в экземплярах виртуальной машины не настроена конечная точка приложения для передачи состояния работоспособности приложения.
• конечная точка приложения настроена неправильно;
• Когда конечная точка приложения недоступна

Схема расширения для двоичных состояний работоспособности

В следующем JSON показана схема расширения "Здоровье приложения". Для расширения требуется как минимум запрос "tcp", "http" или "https" с указанным соответственно портом или путем запроса.

{
  "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
          }
        }
      }
    ]
  }
} 

Значения свойств

Настройки

Разверните расширение "Здоровье приложения"

Существует несколько способов развертывания расширения для мониторинга состояния приложений в ваших масштабируемых наборах, как описано в следующих примерах.

Регионы с высоким уровнем здравоохранения

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

Двоичные состояния здоровья

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

Устранение неполадок

Нужна помощь в настройке ответа пробы

Смотрите примеры работоспособности приложения для примеров ответов проб работоспособности, передаваемых на локальную конечную точку.

Просмотр VMHealth — один экземпляр

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

Просмотр VMHealth — пакетный вызов

Это доступно только для масштабируемых наборов виртуальных машин с единообразной оркестрацией.

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

Состояние здоровья не отображается

Если состояние работоспособности не отображается на портале Azure или через запрос GET, убедитесь, что виртуальная машина обновлена до последней версии. Если виртуальная машина не соответствует последней модели, обновите виртуальную машину, и отобразится статус работоспособности.

Журнал выходных данных выполнения расширения

Выходные данные выполнения расширения регистрируются в файле, расположенном в следующих каталогах:

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

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

Журналы также периодически записывают состояние работоспособности приложения.

Следующие шаги

Узнайте, как развернуть приложение на масштабируемых наборах виртуальных машин.