Použití rozšíření Application Health se škálovacími sadami virtuálních počítačů

Monitorování stavu aplikace je důležitým signálem pro správu a upgrade nasazení. Škálovací sady virtuálních počítačů Azure poskytují podporu pro postupné upgrady, včetně automatických upgradů imagí operačního systému a automatických oprav hosta virtuálního počítače, které při upgradu nasazení spoléhají na monitorování stavu jednotlivých instancí. Rozšíření stavu aplikace můžete také použít k monitorování stavu aplikace jednotlivých instancí ve škálovací sadě a provádění oprav instancí pomocí automatických oprav instancí.

Tento článek popisuje, jak můžete ke sledování stavu vašich aplikací nasazených ve škálovacích sadách virtuálních počítačů použít dva typy rozšíření služby Application Health, Binary Health States nebo Rich Health States.

Požadavky

Tento článek předpokládá, že znáte:

• Rozšíření virtuálních počítačů Azure
• Úprava škálovacích sad virtuálních počítačů

Kdy použít rozšíření Stav aplikace

Rozšíření stavu aplikace se nasadí v instanci škálovací sady virtuálních počítačů a hlásí stav aplikace z instance škálovací sady. Rozšíření testuje místní koncový bod aplikace a aktualizuje stav na základě odpovědí TCP/HTTP(S) přijatých z aplikace. Azure tento stav používá k zahájení oprav instancí, které nejsou v pořádku, a k určení, jestli má instance nárok na operace upgradu.

Rozšíření hlásí stav z virtuálního počítače a dá se použít v situacích, kdy nejde použít externí sondu, jako jsou sondy stavu Azure Load Balanceru.

Binární versus Rich Health States

Rozšíření služby Application Health má k dispozici dvě možnosti: Binární stavy stavu a Rich Health States. Následující tabulka uvádí některé klíčové rozdíly mezi těmito dvěma možnostmi. Obecná doporučení najdete na konci této části.

¹ Neznámý stav není v protokolu TCP k dispozici. ² Platí pouze pro protokol HTTP/HTTPS. Protokol TCP se bude řídit stejným procesem identifikace instancí, které nejsou v pořádku, jako v binárních stavových stavech.

Obecně byste měli použít binární stavy stavu, pokud:

• Nemáte zájem o konfiguraci vlastní logiky pro identifikaci a označení instance, která není v pořádku.
• Pro nově vytvořené instance nevyžadujete inicializaci období odkladu.

Pokud:

• Signály stavu odesíláte prostřednictvím protokolu HTTP/HTTPS a můžete odesílat informace o stavu prostřednictvím těla odpovědi sondy.
• K identifikaci a označení instancí, které nejsou v pořádku, byste chtěli použít vlastní logiku.
• Chcete nastavit období odkladu inicializace pro nově vytvořené instance tak, aby se urovnaly do stabilního stavu před tím, než instance opraví postupný upgrade nebo opravy instancí.

Binární stavy stavu

Generování sestav stavu binárního stavu obsahuje dva stavy, stav v pořádku a není v pořádku. Následující tabulky obsahují stručný popis konfigurace stavů.

Protokol HTTP/HTTPS

Protokol TCP

Mezi scénáře, které můžou vést ke stavu Není v pořádku , patří:

• Když koncový bod aplikace vrátí stavový kód, který není 200.
• Pokud v instancích virtuálního počítače není nakonfigurovaný žádný koncový bod aplikace pro zajištění stavu aplikace
• Pokud je koncový bod aplikace nesprávně nakonfigurovaný
• Pokud koncový bod aplikace není dostupný

Bohaté stavy stavu

Sestavy bohatých stavů obsahují čtyři stavy stavu, inicializace, v pořádku, není v pořádku a neznámá. Následující tabulky obsahují stručný popis konfigurace jednotlivých stavů.

Protokol HTTP/HTTPS

Protokol TCP

Inicializace stavu

Tento stav platí jenom pro rich health states. Stav inicializace probíhá pouze jednou při spuštění rozšíření a lze ho nakonfigurovat nastavením rozšíření gracePeriod a numberOfProbes.

Při spuštění rozšíření zůstane stav aplikace ve stavu Inicializace , dokud nedojde k jednomu ze dvou scénářů:

• Stejný stav (v pořádku nebo není v pořádku) se hlásí po sobě jdoucím počtem nakonfigurovaných prostřednictvím parametru numberOfProbes.
• Platnost vyprší.gracePeriod

Pokud je stejný stav (v pořádku nebo není v pořádku) hlášen po sobě, stav aplikace přejde z inicializačního stavu a do hlášeného stavu (v pořádku nebo není v pořádku).

Příklad

Pokud numberOfProbes = 3, to by znamenalo:

• Přechod z inicializace do stavu V pořádku : Rozšíření stavu aplikace musí přijímat tři po sobě jdoucí signály v pořádku prostřednictvím protokolu HTTP/HTTPS nebo TCP.
• Přechod z inicializace do stavu Není v pořádku : Rozšíření stavu aplikace musí přijímat tři po sobě jdoucí signály, které nejsou v pořádku, přes protokol HTTP/HTTPS nebo TCP.

gracePeriod Pokud vyprší platnost před po sobě jdoucím stavem aplikace, bude stav instance určen následujícím způsobem:

• Protokol HTTP/HTTPS: Stav aplikace se přepne z inicializace na Neznámý.
• Protokol TCP: Stav aplikace přejde z inicializace na není v pořádku.

Neznámý stav

Tento stav platí jenom pro rich health states. Neznámý stav je hlášen pouze pro sondy http nebo https a vyskytuje se v následujících scénářích:

• Pokud aplikace vrátí stavový kód, který není 2xx
• Když vyprší časový limit požadavku sondy
• Pokud je koncový bod aplikace nedostupný nebo nesprávně nakonfigurovaný
• Pokud je v textu odpovědi zadaná ApplicationHealthState chybějící nebo neplatná hodnota
• Po vypršení lhůty odkladu

Instance v neznámém stavu je považována za podobnou instanci, která není v pořádku. Pokud je tato možnost povolená, budou opravy instancí prováděny v neznámé instanci, zatímco postupné upgrady budou pozastaveny, dokud instance nepřejde zpět do stavu V pořádku .

Následující tabulka uvádí interpretaci stavu pro postupné upgrady a opravy instancí:

Schéma rozšíření pro binární stavy stavu

Následující KÓD JSON ukazuje schéma pro rozšíření Stav aplikace. Rozšíření vyžaduje minimálně požadavek "tcp", "http" nebo "https" s přidruženým portem nebo cestou požadavku.

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

Hodnoty vlastností

Nastavení

Schéma rozšíření pro rich health states

Následující kód JSON ukazuje schéma rozšíření Rich Health States. Rozšíření vyžaduje minimálně požadavek http nebo https s přidruženým portem nebo cestou požadavku. Podporují se také sondy PROTOKOLU TCP, ale nebudou moct nastavit ApplicationHealthState tělo odpovědi sondy a nebudou mít přístup k neznámému stavu.

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

Hodnoty vlastností

Nastavení

Nasazení rozšíření Stav aplikace

Rozšíření Služby Application Health můžete do škálovacích sad nasadit několika způsoby, jak je podrobně popsáno v následujících příkladech.

Binární stavy stavu

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

Bohaté stavy stavu

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

Odstraňování potíží

Potřebuji pomoc s konfigurací odpovědi sondy

Příklady odpovědí sondy stavu generovaných do místního koncového bodu najdete v ukázkách stavu aplikace.

Zobrazení VMHealth – jedna instance

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

Zobrazení VMHealth – dávkové volání

Tato možnost je k dispozici pouze pro škálovací sady virtuálních počítačů s jednotnou orchestrací.

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

Stav se nezobrazuje

Pokud se stav nezobrazuje na webu Azure Portal nebo prostřednictvím volání GET, zkontrolujte, jestli je virtuální počítač upgradovaný na nejnovější model. Pokud virtuální počítač není v nejnovějším modelu, upgradujte virtuální počítač a stav se objeví.

Výstupní protokol spouštění rozšíření

Výstup spouštění rozšíření se protokoluje do souborů nalezených v následujících adresářích:

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

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

Protokoly také pravidelně zaznamenávají stav aplikace.

Další kroky

Zjistěte, jak nasadit aplikaci ve škálovacích sadách virtuálních počítačů.