Używanie rozszerzenia Application Health z zestawami skalowania maszyn wirtualnych

Monitorowanie kondycji aplikacji jest ważnym sygnałem do zarządzania i uaktualniania wdrożenia. Zestawy skalowania maszyn wirtualnych platformy Azure zapewniają obsługę uaktualnień stopniowego, w tym automatycznych uaktualnieńOS-Image i automatycznego stosowania poprawek gościa maszyn wirtualnych, które polegają na monitorowaniu kondycji poszczególnych wystąpień w celu uaktualnienia wdrożenia. Za pomocą rozszerzenia usługi Application Health można również monitorować kondycję aplikacji każdego wystąpienia w zestawie skalowania i wykonywać naprawy wystąpień przy użyciu automatycznych napraw wystąpień.

W tym artykule opisano sposób używania dwóch typów rozszerzeń usługi Application Health, Stanów kondycji binarnej lub Bogatych stanów kondycji w celu monitorowania kondycji aplikacji wdrożonych w zestawach skalowania maszyn wirtualnych.

Wymagania wstępne

W tym artykule założono, że znasz następujące elementy:

• Rozszerzenia platformy Azure maszyn wirtualnych
• Modyfikowanie Skalowanie zestawów maszyn wirtualnych

Kiedy należy używać rozszerzenia Application Health

Rozszerzenie kondycji aplikacji jest wdrażane w wystąpieniu zestawu skalowania maszyn wirtualnych i raportuje kondycję aplikacji z wnętrza wystąpienia zestawu skalowania. Sondy rozszerzenia są uruchamiane w lokalnym punkcie końcowym aplikacji i zaktualizują stan zdrowia na podstawie odpowiedzi TCP/HTTP(S) odebranych z aplikacji. Ten stan kondycji jest używany przez platformę Azure do inicjowania napraw w wystąpieniach o złym stanie i określenia, czy wystąpienie kwalifikuje się do operacji aktualizacji.

Rozszerzenie zgłasza kondycję z poziomu maszyny wirtualnej i może być używane w sytuacjach, gdy nie można używać sondy zewnętrznej, takiej jak sondy kondycji usługi Azure Load Balancer .

Stany dwuwartościowe a Bogate stany zdrowia

Rozszerzenia kondycji aplikacji mają dwie dostępne opcje: Binarne stany kondycji i Zaawansowane stany kondycji. W poniższej tabeli przedstawiono niektóre kluczowe różnice między dwiema opcjami. Zapoznaj się z końcem tej sekcji, aby uzyskać ogólne zalecenia.

¹Nieznany stan jest niedostępny w protokole TCP. ² Dotyczy tylko protokołu HTTP/HTTPS. Protokół TCP będzie postępować zgodnie z tym samym procesem identyfikowania wystąpień w złej kondycji co w stanach kondycji binarnej.

Ogólnie rzecz biorąc, należy użyć Rozwiniętych Stanów Zdrowia, jeśli:

• Możesz wysyłać sygnały zdrowotne za pośrednictwem protokołu HTTP/HTTPS i przesyłać informacje o kondycji poprzez treść odpowiedzi sondy.
• Chcesz użyć logiki niestandardowej do identyfikowania i oznaczania niezdrowych instancji.
• pl-PL: Chcesz ustawić okres karencyjny inicjowania dla nowo utworzonych wystąpień, aby ustabilizowały się w stałym stanie zdrowia przed umożliwieniem im udziału w stopniowym uaktualnieniu lub naprawach.
• Chcesz mieć większą kontrolę nad koordynacją i procesem aktualizacji przy użyciu ulepszeń stopniowych, emitując metryki niestandardowe

Należy użyć dwu-stanowych stanów zdrowia, jeśli:

• Nie interesuje Cię konfigurowanie logiki niestandardowej w celu identyfikowania i oznaczania w złym stanie działania instancji.
• Nie trzeba okresu karencji dla nowo utworzonych wystąpień.
• Nie musisz używać metryk niestandardowych podczas przeprowadzania uaktualnienia stopniowego na maszynach wirtualnych

Zaawansowane stany zdrowia

Raport Rich Health States zawiera cztery stany zdrowotne: Inicjowanie, Zdrowy, Niezdrowy i Nieznany. W poniższych tabelach przedstawiono krótki opis sposobu konfigurowania poszczególnych stanów kondycji.

Protokół HTTP/HTTPS

Protokół TCP

Inicjowanie stanu

Ten stan dotyczy tylko Stany Bogatego Zdrowia. Stan inicjowania występuje tylko raz przy uruchomieniu rozszerzenia i można go skonfigurować za pomocą ustawień rozszerzenia gracePeriod i numberOfProbes.

Podczas uruchamiania rozszerzenia kondycja aplikacji pozostanie w stanie Inicjowanie do momentu wystąpienia jednego z dwóch scenariuszy:

• Ten sam stan zdrowia (dobry lub zły) jest zgłaszany przez określoną liczbę razy skonfigurowaną za pośrednictwem parametru liczby prób
• Czas trwania gracePeriod dobiega końca

Jeśli ten sam stan zdrowia (Dobry lub Zły) jest zgłaszany kolejno, stan zdrowia aplikacji przejdzie ze stanu Inicjowanie do zgłoszonego Stanu zdrowia (Dobry lub Zły).

Przykład

Jeśli numberOfProbes = 3, oznacza to:

• Aby przejść ze stanu inicjowania do stanu w dobrej kondycji: rozszerzenie kondycji aplikacji musi odbierać trzy kolejne sygnały zdrowe za pośrednictwem protokołu HTTP/HTTPS lub TCP
• Aby przejść z Inicjowanie do stanu złej kondycji: rozszerzenie kondycji aplikacji musi otrzymywać trzy kolejne sygnały w złej kondycji za pośrednictwem protokołu HTTP/HTTPS lub TCP

Jeśli status zdrowia gracePeriod wygaśnie, zanim aplikacja zgłosi kolejny status zdrowia, stan zdrowia instancji zostanie określony w następujący sposób:

• Protokół HTTP/HTTPS: kondycja aplikacji przejdzie z Inicjowanie do Nieznane
• Protokół TCP: kondycja aplikacji przejdzie z inicjowania do złej kondycji

Nieznany stan

Ten stan dotyczy tylko Stany Bogatego Zdrowia. Nieznany stan jest zgłaszany tylko dla sond "http" lub "https" i występuje w następujących scenariuszach:

• Gdy przez aplikację jest zwracany kod stanu innego niż 2xx
• Gdy żądanie sondy upływa limit czasu
• Gdy punkt końcowy aplikacji jest niemożliwy do osiągnięcia lub niepoprawnie skonfigurowany
• W przypadku, gdy w treści odpowiedzi podano brakującą lub nieprawidłową wartość dla ApplicationHealthState
• Kiedy okres prolongaty wygaśnie

Instancja w stanie Nieznany jest traktowana podobnie jak instancja w Złej kondycji. Jeśli to ustawienie zostanie włączone, naprawy wystąpień zostaną wykonane w nieznanym wystąpieniu, podczas gdy uaktualnienia stopniowe zostaną wstrzymane, dopóki wystąpienie nie powróci do stanu w dobrej kondycji.

W poniższej tabeli przedstawiono interpretację stanu kondycji dla uaktualnień stopniowego i napraw wystąpień:

Schemat rozszerzenia dla bogatych stanów zdrowotnych

Poniższy kod JSON przedstawia schemat rozszerzenia Rich Health States. Rozszerzenie wymaga co najmniej żądania "http" lub "https" z skojarzonym portem lub ścieżką żądania odpowiednio. Sondy TCP są również obsługiwane, ale nie będą mogły skonfigurować ApplicationHealthState za pośrednictwem treści odpowiedzi i nie będą miały dostępu do stanu Nieznany.

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

Wartości właściwości

Ustawienia

Binarne Stany Zdrowotne

Raportowanie binarnego stanu zdrowia zawiera dwa stany, Zdrowy i Niezdrowy. W poniższych tabelach przedstawiono krótki opis konfiguracji stanów zdrowia.

Protokół HTTP/HTTPS

Protokół TCP

Niektóre scenariusze, które mogą powodować złą kondycję, obejmują:

• Gdy punkt końcowy aplikacji zwraca kod stanu inny niż 200
• Jeśli w instancjach maszyn wirtualnych nie skonfigurowano punktu końcowego aplikacji do monitorowania kondycji aplikacji
• Gdy punkt końcowy aplikacji jest niepoprawnie skonfigurowany
• Gdy punkt końcowy aplikacji nie jest osiągalny

Schemat rozszerzenia dla binarnych stanów zdrowotnych

Poniższy kod JSON przedstawia schemat rozszerzenia Application Health. Rozszerzenie wymaga co najmniej żądania "tcp", "http" lub "https" z skojarzonym portem lub ścieżką żądania odpowiednio.

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

Wartości właściwości

Ustawienia

Wdrażanie rozszerzenia Application Health

Istnieje wiele sposobów wdrażania rozszerzenia Application Health do swoich grup skalowania, co pokazano w poniższych przykładach.

Zaawansowane stany zdrowia

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

Binarne Stany Zdrowotne

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

Rozwiązywanie problemów

Potrzebna pomoc dotycząca konfigurowania odpowiedzi sondy

Zobacz przykłady dotyczące kondycji aplikacji, aby zapoznać się z przykładami odpowiedzi sondy zdrowia wysyłanych do lokalnego punktu końcowego.

Wyświetlanie kondycji maszyny wirtualnej — pojedyncze wystąpienie

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

Wyświetlanie stanu VMHealth – wywołanie wsadowe

Jest to dostępne tylko dla zestawów skalowania maszyn wirtualnych z jednolitym zarządzaniem.

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

Stan kondycji nie jest wyświetlany

Jeśli stan kondycji nie jest wyświetlany w witrynie Azure Portal lub za pośrednictwem wywołania GET, sprawdź, czy maszyna wirtualna została uaktualniona do najnowszego modelu. Jeśli maszyna wirtualna nie znajduje się w najnowszym modelu, uaktualnij maszynę wirtualną i zostanie wyświetlony stan kondycji.

Dziennik danych wyjściowych wykonywania rozszerzenia

Dane wyjściowe wykonywania rozszerzenia są rejestrowane w plikach znajdujących się w następujących katalogach:

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

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

Dzienniki okresowo przechwytują również stan kondycji aplikacji.

Następne kroki

Dowiedz się, jak wdrożyć aplikację w zestawach skalowania maszyn wirtualnych.