将应用程序运行状况扩展与 Azure 虚拟机配合使用

以下示例将名为 myHealthExtension 的应用程序运行状况扩展添加到了一个基于 Windows 的虚拟机。

还可以使用此示例通过发出 PATCH 调用而不是 PUT，将现有扩展从丰富运行状况状态更改为二进制运行状况。

PUT on `/subscriptions/subscription_id/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/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>"
    }
  }
}

使用 PATCH 编辑已部署的扩展。

使用 Set-AzVmExtension cmdlet 向虚拟机添加或更新应用程序运行状况扩展。

以下示例将应用程序运行状况扩展添加到基于 Windows 的虚拟机。

还可以使用此示例将现有扩展从丰富运行状况状态更改为二进制运行状况。

# Define the Application Health extension properties
$publicConfig = @{"protocol" = "http"; "port" = 80; "requestPath" = "/healthEndpoint"};

# Add the Application Health extension to the virtual machine
Set-AzVMExtension -Name "myHealthExtension" `
  -ResourceGroupName "<myResourceGroup>" `
  -VMName "<myVM>" ` 
  -Publisher "Microsoft.ManagedServices" `
  -ExtensionType "ApplicationHealthWindows" `
  -TypeHandlerVersion "1.0" `
  -Location "<location>" `
  -Settings $publicConfig
  

使用 az vm extension set 将应用程序运行状况扩展添加到虚拟机。

以下示例将应用程序运行状况扩展添加到基于 Linux 的虚拟机。

还可以使用此示例将现有扩展从丰富运行状况状态更改为二进制运行状况。

az vm extension set \
  --name ApplicationHealthLinux \
  --publisher Microsoft.ManagedServices \
  --version 1.0 \
  --resource-group <myResourceGroup> \
  --vm-name <myVM> \
  --settings ./extension.json

extension.json 文件内容。

{
  "protocol": "<protocol>",
  "port": <port>,
  "requestPath": "</requestPath>"
}

以下示例将应用程序运行状况扩展添加到 Azure 门户上的现有虚拟机。

1. 导航到现有虚拟机
2. 在左侧边栏上，转到“运行状况监视”边栏选项卡
3. 单击“启用应用程序运行状况监视”，为“运行状况状态”选择“二进制”。 配置协议、端口等以设置运行状况探测。
4. 单击“保存”以保存设置

以下示例将应用程序运行状况 - 丰富状态扩展（名称为 myHealthExtension）添加到基于 Windows 的虚拟机。

还可以使用此示例通过发出 PATCH 调用而不是 PUT，将现有扩展从二进制升级到丰富运行状况状态。

PUT on `/subscriptions/subscription_id/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/extensions/myHealthExtension?api-version=2018-10-01`

{
  "name": "myHealthExtension",
  "location": "<location>", 
  "properties": {
    "publisher": "Microsoft.ManagedServices",
    "type": "ApplicationHealthWindows",
    "autoUpgradeMinorVersion": true,
    "typeHandlerVersion": "2.0",
    "settings": {
      "requestPath": "</requestPath>",
      "intervalInSeconds": <intervalInSeconds>,
      "numberOfProbes": <numberOfProbes>,
      "gracePeriod": <gracePeriod>
    }
  }
}

使用 PATCH 编辑已部署的扩展。

使用 Set-AzVmExtension cmdlet 向虚拟机添加或更新应用程序运行状况扩展。

以下示例将应用程序运行状况 - 丰富状态扩展添加到基于 Windows 的虚拟机。

还可以使用此示例将现有扩展从二进制运行状况状态升级到丰富运行状况状态。

# Define the Application Health extension properties
$publicConfig = @{"protocol" = "http"; "port" = 80; "requestPath" = "/healthEndpoint"; "gracePeriod" = 600};

# Add the Application Health extension to the virtual machine
Set-AzVMExtension -Name "myHealthExtension" `
  -ResourceGroupName "<myResourceGroup>" `
  -VMName "<myVM>" ` 
  -Publisher "Microsoft.ManagedServices" `
  -ExtensionType "ApplicationHealthWindows" `
  -TypeHandlerVersion "2.0" `
  -Location "<location>" `
  -Settings $publicConfig
  

使用 az vm extension set 将应用程序运行状况扩展添加到虚拟机。

以下示例将应用程序运行状况 - 丰富状态扩展添加到基于 Linux 的虚拟机。

还可以使用此示例将现有扩展从二进制运行状况状态升级到丰富运行状况状态。

az vm extension set \
  --name ApplicationHealthLinux \
  --publisher Microsoft.ManagedServices \
  --version 2.0 \
  --resource-group <myResourceGroup> \
  --vm-name <myVM> \
  --settings ./extension.json

extension.json 文件内容。

{
  "protocol": "<protocol>",
  "port": <port>,
  "requestPath": "</requestPath>",
  "gracePeriod": <healthExtensionGracePeriod>
}

以下示例将应用程序运行状况扩展添加到 Azure 门户上的现有虚拟机。

1. 导航到现有虚拟机
2. 在左侧边栏上，转到“运行状况监视”边栏选项卡
3. 单击“启用应用程序运行状况监视”，为“运行状况状态”选择“丰富(高级)”。 配置协议、端口等以设置运行状况探测。
4. 单击“保存”以保存设置

GET https://management.chinacloudapi.cn/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/instanceView?api-version=2023-07-01

示例响应（查看“vmHealth”对象了解最新的 VM 运行状况）

"vmHealth": {
    "status": {
      "code": "HealthState/unknown",
      "level": "Warning",
      "displayStatus": "The VM health is unknown",
      "time": "2023-12-04T22:25:39+00:00"
    }
}

Get-AzVM
  -ResourceGroupName "<rgName>" `
  -Name "<vmName>" `
  -Status

az vm get-instance-view --name <vmName> --resource-group <rgName>

1. 导航到现有虚拟机
2. 在左侧边栏上，转到“概述”边栏选项卡
3. 可以在“运行状况状态”字段下观察应用程序运行状况