Sanal Makine Ölçek Kümeleri ile Uygulama Durumu uzantısını kullanma

Uygulamanızın sistem durumunu izlemek, dağıtımınızı yönetmek ve yükseltmek için önemli bir sinyaldir. Azure Sanal Makine Ölçek Kümeleri, dağıtımınızı yükseltmek için tek tek örneklerin sistem durumunu izlemeye dayanan Otomatik İşletim Sistemi-Görüntü Yükseltmeleri ve Otomatik VM Konuk Düzeltme Eki Uygulama gibi Sıralı Yükseltmeler için destek sağlar. Uygulama Durumu Uzantısı'nı ölçek kümenizdeki her örneğin uygulama durumunu izlemek ve Otomatik Örnek Onarımları'nı kullanarak örnek onarımları gerçekleştirmek için de kullanabilirsiniz.

Bu makalede, Sanal Makine Ölçek Kümeleri dağıtılan uygulamalarınızın durumunu izlemek için iki tür Uygulama Durumu uzantısını (İkili Sistem Durumu Durumları veya Zengin Sistem Durumu Durumları) nasıl kullanabileceğiniz açıklanmaktadır.

Önkoşullar

Bu makalede şunları bildiğiniz varsayılır:

• Azure sanal makine uzantıları
• Sanal Makine Ölçek Kümeleri değiştirme

Uygulama Durumu uzantısı ne zaman kullanılır?

Uygulama Durumu Uzantısı bir Sanal Makine Ölçek Kümesi örneği içinde dağıtılır ve ölçek kümesi örneğinin içinden uygulama durumuyla ilgili raporlar. Uzantı, yerel bir uygulama uç noktasında yoklar ve uygulamadan alınan TCP/HTTP(S) yanıtlarına göre sistem durumunu güncelleştirir. Bu sistem durumu Azure tarafından iyi durumda olmayan örneklerde onarım başlatmak ve bir örneğin yükseltme işlemleri için uygun olup olmadığını belirlemek için kullanılır.

Uzantı, vm içinden sistem durumunu raporlar ve Azure Load Balancer sistem durumu yoklamaları gibi bir dış yoklamanın kullanılamadığı durumlarda kullanılabilir.

İkili ve Zengin Sistem Durumu Karşılaştırması

Uygulama Durumu Uzantıları iki seçeneğe sahiptir: İkili Sistem Durumu Durumları ve Zengin Sistem Durumu Durumları. Aşağıdaki tabloda iki seçenek arasındaki bazı önemli farklar vurgulanır. Genel öneriler için bu bölümün sonuna bakın.

¹ Bilinmeyen durum TCP protokolünde kullanılamıyor. ² Yalnızca HTTP/HTTPS protokolü için geçerlidir. TCP protokolü, İkili Sistem Durumu Durumlarındaki iyi durumda olmayan örnekleri tanımlama işleminin aynısını izler.

Genel olarak, aşağıdaki durumlarda İkili Sistem Durumu durumları kullanmanız gerekir:

• İyi durumda olmayan bir örneği tanımlamak ve işaretlemek için özel mantık yapılandırmakla ilgilenmiyorsunuz
• Yeni oluşturulan örnekler için bir başlatma yetkisiz kullanım süresi gerekmez

Aşağıdaki durumlarda Zengin Sistem Durumu Durumlarını kullanmanız gerekir:

• HTTP/HTTPS protokolü aracılığıyla sistem durumu sinyalleri gönderirsiniz ve sistem durumu bilgilerini yoklama yanıt gövdesi aracılığıyla gönderebilirsiniz
• İyi durumda olmayan örnekleri tanımlamak ve işaretlemek için özel mantık kullanmak istiyorsunuz
• Örneği sıralı yükseltme veya örnek onarımları için uygun hale getirmeden önce düzenli bir Sistem Durumu durumuna geçmeleri için yeni oluşturulan örnekler için başlatma yetkisiz kullanım süresi ayarlamak istiyorsunuz

İkili Sistem Durumu Durumları

İkili Sistem Durumu raporlaması, sağlıklı ve iyi durumda olmayan iki Sistem Durumu içerir. Aşağıdaki tablolarda Sistem Durumu Durumlarının nasıl yapılandırıldığına ilişkin kısa bir açıklama sağlanır.

HTTP/HTTPS Protokolü

TCP Protokolü

İyi durumda olmayan bir duruma neden olabilecek bazı senaryolar şunlardır:

• Uygulama uç noktası 200 olmayan bir durum kodu döndürdüğünde
• Sanal makine örneklerinin içinde uygulama sistem durumu sağlamak için yapılandırılmış bir uygulama uç noktası olmadığında
• Uygulama uç noktası yanlış yapılandırıldığında
• Uygulama uç noktasına ulaşılamıyorsa

Zengin Sağlık Durumları

Zengin Sistem Durumu raporlaması başlatan, sağlıklı, iyi durumda olmayan ve bilinmeyen dört Sistem Durumu içerir. Aşağıdaki tablolarda, her sistem durumunun nasıl yapılandırıldığına ilişkin kısa bir açıklama sağlanır.

HTTP/HTTPS Protokolü

TCP Protokolü

Başlatma durumu

Bu durum yalnızca Zengin Sistem Durumu durumları için geçerlidir. Başlatma durumu, uzantı başlangıç zamanında yalnızca bir kez gerçekleşir ve uzantı ayarları gracePeriod ve numberOfProbesile yapılandırılabilir.

Uzantı başlangıcında, uygulama durumu iki senaryodan biri gerçekleşene kadar Başlatma durumunda kalır:

• NumberOfProbes aracılığıyla yapılandırıldığı şekilde aynı Sistem Durumu (sağlıklı veya iyi durumda değil) art arda birkaç kez bildirilir
• Süresi gracePeriod doluyor

Aynı Sistem Durumu (sağlıklı veya iyi durumda değil) art arda bildirilirse, uygulama durumu Başlatma durumundan ve bildirilen Sistem Durumu'na (İyi veya İyi Durumda Değil) geçiş yapacaktır.

Örnek

= 3 ise numberOfProbes , bu şu anlama gelir:

• Başlatma durumundan Sağlıklı duruma geçmek için: Uygulama sistem durumu uzantısı HTTP/HTTPS veya TCP protokolü aracılığıyla ardışık üç sağlıklı sinyal almalıdır
• Başlatmadan İyi Durumda Değil durumuna geçmek için: Uygulama sistem durumu uzantısı HTTP/HTTPS veya TCP protokolü aracılığıyla ardışık üç iyi durumda olmayan sinyal almalıdır

gracePeriod Uygulama tarafından ardışık sistem durumu bildirilmeden önce süresi dolarsa, örnek durumu aşağıdaki gibi belirlenir:

• HTTP/HTTPS protokolü: Uygulama durumu Başlatılıyor'dan Bilinmiyor'a geçiş yapacak
• TCP protokolü: Uygulama durumu Başlatılıyor'dan İyi Durumda Değil'e geçiş yapacak

Bilinmeyen durum

Bu durum yalnızca Zengin Sistem Durumu durumları için geçerlidir. Bilinmeyen durum yalnızca "http" veya "https" yoklamaları için bildirilir ve aşağıdaki senaryolarda gerçekleşir:

• Uygulama tarafından 2xx olmayan bir durum kodu döndürülürse
• Yoklama isteği zaman aşımına uğradıklarında
• Uygulama uç noktasına ulaşılamıyorsa veya yanlış yapılandırıldığında
• Yanıt gövdesinde eksik ApplicationHealthState veya geçersiz bir değer sağlandığında
• Yetkisiz kullanım süresi dolduğunda

Bilinmeyen durumdaki bir örnek, iyi durumda olmayan bir örneğe benzer şekilde değerlendirilir. Etkinleştirilirse, örnek onarımları Bilinmeyen bir örnekte gerçekleştirilirken, sıralı yükseltmeler örnek sağlıklı duruma geri dönene kadar duraklatılır.

Aşağıdaki tabloda Sıralı Yükseltmeler ve Örnek Onarımları için sistem durumu yorumu gösterilmektedir:

İkili Sistem Durumu Durumları için uzantı şeması

Aşağıdaki JSON, Uygulama Durumu uzantısının şemasını gösterir. Uzantı, ilişkili bağlantı noktası veya istek yolu ile en azından "tcp", "http" veya "https" isteği gerektirir.

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

Özellik değerleri

Ayarlar

Zengin Sistem Durumu Durumları için uzantı şeması

Aşağıdaki JSON, Zengin Sistem Durumu Durumları uzantısının şemasını gösterir. Uzantı, ilişkili bağlantı noktası veya istek yolu ile en az bir "http" veya "https" isteği gerektirir. TCP yoklamaları da desteklenir, ancak yoklama yanıt gövdesi aracılığıyla ayarlanamayacak ApplicationHealthState ve Bilinmeyen duruma erişimi olmayacaktır.

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

Özellik değerleri

Ayarlar

Uygulama Durumu uzantısını dağıtma

Aşağıdaki örneklerde ayrıntılı olarak açıklandığı gibi, Uygulama Durumu uzantısını ölçek kümelerinize dağıtmanın birden çok yolu vardır.

İkili Sistem Durumu Durumları

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

Zengin Sağlık Durumları

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

Sorun giderme

Yoklama yanıtlarını yapılandırma konusunda yardım gerekiyor

Yerel uç noktaya yayılan durum yoklaması yanıtlarının örnekleri için bkz . uygulama durumu örnekleri .

VMHealth görüntüleme - tek örnek

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

VMHealth görüntüleme – toplu çağrı

Bu yalnızca Tekdüzen düzenleme ile Sanal Makine Ölçek Kümeleri için kullanılabilir.

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

Sistem Durumu görünmüyor

Sistem Durumu Azure portalında veya GET çağrısıyla gösterilmiyorsa VM'nin en son modele yükseltildiğinden emin olun. VM en son modelde değilse VM'yi yükseltin ve sistem durumu açılır.

Uzantı yürütme çıkış günlüğü

Uzantı yürütme çıktısı aşağıdaki dizinlerde bulunan dosyalara kaydedilir:

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

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

Günlükler ayrıca düzenli aralıklarla uygulama sistem durumunu yakalar.

Sonraki adımlar

Uygulamanızı Sanal Makine Ölçek Kümeleri dağıtmayı öğrenin.