Document Details

(Get-Module Az.Compute).Version

   **Expected result**: Returns an XML document that contains the monitoring information of the virtual machine, its disks and network interfaces.

If the preceding check was not successful, run these additional checks:

1. Make sure that the waagent is installed and enabled.

   a. Run `sudo ls -al /var/lib/waagent/`

     **Expected result**: Lists the content of the waagent directory.

   b. Run `ps -ax | grep waagent`

   **Expected result**: Displays one entry similar to: `python /usr/sbin/waagent -daemon`

1. Make sure that the Azure Extension for SAP is installed and running.

   a. Run `sudo sh -c 'ls -al /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-*/'`

   **Expected result**: Lists the content of the Azure Extension for SAP directory.

   b. Run `ps -ax | grep AzureEnhanced`

   **Expected result**: Displays one entry similar to: `/var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-1.0.0.82/AzureEnhancedMonitoring -monitor`

1. Install SAP Host Agent as described in SAP Note [1031096], and check the output of `saposcol`.

   a. Run `/usr/sap/hostctrl/exe/saposcol -d`

   b. Run `dump ccm`

   c. Check whether the **Virtualization_Configuration\Enhanced Monitoring Access** metric is **true**.

If you already have an SAP NetWeaver ABAP application server installed, open transaction ST06 and check whether monitoring is enabled.

If any of these checks fail, and for detailed information about how to redeploy the extension, see [Troubleshooting][troubleshooting]
 
## <a name="e2d592ff-b4ea-4a53-a91a-e5521edb6cd1"></a>Health checks

If some of the infrastructure data isn't delivered correctly as indicated by the tests described in [Readiness check][readiness-check], run the health checks described in this chapter to check whether the Azure infrastructure and the Azure Extension for SAP are configured correctly.

### [Azure PowerShell](#tab/powershell5)

1. Make sure that you have installed the latest version of the Azure PowerShell cmdlet (at least 4.3.0).
1. Run the following PowerShell cmdlet. For a list of available environments, run the cmdlet `Get-AzEnvironment`. To use global Azure, select the **AzureCloud** environment. For Microsoft Azure operated by 21Vianet, select **AzureChinaCloud**.

   

    $env = Get-AzEnvironment -Name <name of the environment>
    Connect-AzAccount -Environment $env
    Set-AzContext -SubscriptionName <subscription name>

    Set-AzVMAEMExtension -ResourceGroupName <resource group name> -VMName <virtual machine name> -InstallNewExtension
    

---

## <a name="versions"></a> Versions of the VM Extension for SAP

If you want to disable automatic updates for the VM extension or want to deploy a specific version of the extension, you can retrieve the available versions with Azure CLI or Azure PowerShell.

### [Azure PowerShell](#tab/powershell4)

---

## <a name="readiness-check"></a>Readiness check

This check makes sure that all performance metrics that appear inside your SAP application are provided by the underlying Azure Extension for SAP.

### Run the readiness check on a Windows VM

1. Sign in to the Azure virtual machine (using an admin account isn't necessary).
1. Open a web browser and navigate to `http://127.0.0.1:11812/azure4sap/metrics`.
1. The browser should display or download an XML file that contains the monitoring data of your virtual machine. If that isn't the case, make sure that the Azure Extension for SAP is installed.
1. Check the content of the XML file. The XML file that you can access at `http://127.0.0.1:11812/azure4sap/metrics` contains all populated Azure performance counters for SAP. It also contains a summary and health indicator of the status of Azure Extension for SAP.
1. Check the value of the **Provider Health Description** element. If the value is not **OK**, follow the instructions in chapter [Health checks][health-check].
 
### Run the readiness check on a Linux VM

1. Connect to the Azure Virtual Machine by using SSH.
1. Check the output of the following command