|
1 | 1 | --- |
2 | | -title: Troubleshoot the Azure VM Extension for SAP | Microsoft Docs |
3 | | -description: Learn how to troubleshoot the new VM Extension for SAP. |
4 | | -services: virtual-machines-linux,virtual-machines-windows |
5 | | -author: imnotfromhere |
| 2 | +title: Troubleshoot the Azure VM Extension for SAP |
| 3 | +description: Troubleshoot common issues with the Azure VM Extension for SAP, including missing performance counters, empty installation directories, and error codes. |
| 4 | +author: mareusch |
6 | 5 | manager: juergent |
7 | 6 | ms.custom: devx-track-azurepowershell, devx-track-azurecli, linux-related-content |
8 | | -ms.assetid: 1c4f1951-3613-4a5a-a0af-36b85750c84e |
9 | 7 | ms.service: sap-on-azure |
10 | 8 | ms.subservice: sap-vm-workloads |
11 | | -ms.topic: article |
12 | | -ms.tgt_pltfrm: vm-linux |
13 | | -ms.date: 06/22/2021 |
| 9 | +ms.topic: troubleshooting-general |
| 10 | +ms.date: 04/02/2026 |
14 | 11 | ms.author: mareusch |
15 | | -# Customer intent: "As a system administrator managing SAP workloads on virtual machines, I want to troubleshoot the Azure VM Extension for SAP, so that I can ensure accurate performance metrics collection and maintain optimal performance of my applications." |
| 12 | +# Customer intent: As a system administrator managing SAP workloads on virtual machines, I want to troubleshoot the Azure VM Extension for SAP, so that I can ensure accurate performance metrics collection and maintain optimal performance of my applications. |
16 | 13 | --- |
17 | 14 |
|
18 | 15 | # Troubleshoot the Azure VM Extension for SAP |
| 16 | + |
19 | 17 | [1999351]:https://launchpad.support.sap.com/#/notes/1999351 |
20 | 18 | [configure]:vm-extension-for-sap-new.md#configure-the-azure-vm-extension-for-sap-solutions (Configure the Azure VM extension for SAP solutions) |
21 | 19 |
|
22 | | -## <a name="dee9099b-7b8a-4cdd-86a2-3f6ee964266f"></a>Troubleshooting for Windows |
| 20 | +The Azure VM Extension for SAP collects performance metrics from Azure virtual machines (VMs) and forwards them to the SAP Host Agent so that SAP monitoring tools can report on system health. When the extension isn't working correctly, performance counters might be missing or empty, which can prevent you from identifying resource bottlenecks in your SAP environment. |
23 | 21 |
|
24 | | -### Azure performance counters don't show up at all |
25 | | -The AzureEnhancedMonitoring process collects performance metrics in Azure. If the process isn't running in your virtual machine (VM), no performance metrics can be collected. |
| 22 | +This article helps you diagnose and resolve common issues with the extension on both Windows and Linux VMs, including missing performance counters, empty installation directories, and authentication errors. |
26 | 23 |
|
27 | | -#### The installation directory of the Azure Extension for SAP is empty |
28 | | -##### Issue |
29 | | -The installation directory |
30 | | -C:\\Packages\\Plugins\\Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Windows\\<version> |
31 | | -is empty. |
32 | | -##### Solution |
33 | | -The extension isn't installed. Determine whether it is a proxy issue. You might need to restart the machine or install the VM extension again. |
| 24 | +## Azure performance counters don't show up at all |
34 | 25 |
|
35 | | -### Some Azure performance counters are missing |
| 26 | +The `AzureEnhancedMonitoring` process (Windows) or daemon (Linux), collects the performance metrics. If the process isn't running on your VM, the VM can't collect performance metrics. |
36 | 27 |
|
37 | | -The AzureEnhancedMonitoring Windows process collects performance metrics in Azure. The process gets data from several sources. Some configuration data is collected locally, and some performance metrics are read from Azure Monitor. |
| 28 | +### Check the installation directory |
38 | 29 |
|
39 | | -If troubleshooting by using SAP Note [1999351] doesn't resolve the issue, open an SAP customer support message. For a Windows VM use the component BC-OP-NT-AZR or BC-OP-LNX-AZR for a Linux virtual machine. Attach the log file C:\\Packages\\Plugins\\Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Windows\\<version>\\logapp.txt to the incident. |
| 30 | +Verify that the extension installation directory isn't empty. |
40 | 31 |
|
41 | | -## <a name="02783aa4-5443-43f5-bc11-7af19ebf0c36"></a>Troubleshooting for Linux |
| 32 | +- **Windows**: Check the directory `C:\Packages\Plugins\Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Windows\<version>`. |
| 33 | +- **Linux**: Check that `/var/lib/waagent/` has a subdirectory for the Azure Extension for SAP. |
42 | 34 |
|
43 | | -### Azure performance counters don't show up at all |
44 | | -Performance metrics in Azure are collected by a daemon. If the daemon isn't running, no performance metrics can be collected. |
| 35 | +If the directory is empty, the extension isn't installed. Determine whether the issue is proxy-related. You might need to restart the VM or [install the VM extension again][configure]. |
45 | 36 |
|
46 | | -#### The installation directory of the Azure Extension for SAP is empty |
47 | | -##### Issue |
48 | | -The directory /var/lib/waagent/ doesn't have a subdirectory for the Azure Extension for SAP. |
49 | | -##### Solution |
50 | | -The extension isn't installed. Determine whether it is a proxy issue. You might need to restart the machine and/or install the VM extension again. |
| 37 | +## Some Azure performance counters are missing |
51 | 38 |
|
52 | | -### Some Azure performance counters are missing |
| 39 | +Performance metrics are collected from several sources. Some configuration data is collected locally, and some performance metrics are read from Azure Monitor. |
53 | 40 |
|
54 | | -Performance metrics in Azure are collected by a daemon, which gets data from several sources. Some configuration data is collected locally, and some performance metrics are read from Azure Monitor. |
55 | | -For a complete and up-to-date list of known issues, see SAP Note [1999351], which has additional troubleshooting information for Azure Extension for SAP. |
56 | | -If troubleshooting by using SAP Note [1999351] doesn't resolve the issue, install the extension again as described in [Configure the Azure Extension for SAP][configure]. If the problem persists, open an SAP customer support message on the component BC-OP-NT-AZR for Windows or BC-OP-LNX-AZR for a Linux virtual machine. Attach the log file /var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-<version>/logapp.txt to the incident. |
| 41 | +For a complete and up-to-date list of known issues, see SAP Note [1999351], which has extra troubleshooting information for the Azure Extension for SAP. |
57 | 42 |
|
| 43 | +If troubleshooting by using SAP Note [1999351] doesn't resolve the issue, [install the extension again][configure]. If the problem persists, open an SAP customer support message on the following component: |
58 | 44 |
|
59 | | -## Azure extension error codes |
| 45 | +- **Windows**: BC-OP-NT-AZR |
| 46 | +- **Linux**: BC-OP-LNX-AZR |
60 | 47 |
|
61 | | -All error IDs have a unique tag in the form of a-#, where # is a number. It allows a fast search for a specific error and possible solutions. |
| 48 | +Attach the relevant log file to the incident: |
62 | 49 |
|
63 | | -### <a name="a-0116"></a> a-0116 |
| 50 | +- **Windows**: `C:\Packages\Plugins\Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Windows\<version>\logapp.txt` |
| 51 | +- **Linux**: `/var/lib/waagent/Microsoft.AzureCAT.AzureEnhancedMonitoring.MonitorX64Linux-<version>/logapp.txt` |
| 52 | + |
| 53 | +## Azure extension error codes |
64 | 54 |
|
65 | | -Error description | Solutions | |
66 | | ----|---| |
67 | | - no auth token | More info:<br />The extension can't obtain authentication token to access VM metrics in Azure monitor. To deliver VM metrics it needs access to VM resources like VM itself, all disks and all NICs attached to a VM<br />Solution:<br />Enable VM managed Identity and give it a reader role for a VM resource group. When you use a setup script, the script does it for you. Normally you don’t need to enable and assign VM managed identity manually. | |
| 55 | +All error codes have a unique tag in the form of `a-#`, where `#` is a number. Use the tag to search for a specific error and its solution. |
68 | 56 |
|
| 57 | +| Code | Error message | Solution | |
| 58 | +|---|---|---| |
| 59 | +| a-0116 | No auth token | The extension can't obtain an authentication token to access VM metrics in Azure Monitor. To deliver VM metrics, it needs access to VM resources like the VM itself, all disks, and all network interfaces attached to a VM. Enable a managed identity for the VM and assign it the Reader role for the VM's resource group. When you use a setup script, the script performs this action for you. Normally, you don't need to enable and assign a managed identity manually. | |
69 | 60 |
|
| 61 | +## Related content |
70 | 62 |
|
71 | | -## Next steps |
72 | | -* [Azure Virtual Machines deployment for SAP NetWeaver](./deployment-guide.md) |
73 | | -* [Azure Virtual Machines planning and implementation for SAP NetWeaver](./planning-guide.md) |
| 63 | +- [Configure the Azure VM Extension for SAP solutions](vm-extension-for-sap-new.md) |
| 64 | +- [Azure Virtual Machines deployment for SAP NetWeaver](./deployment-guide.md) |
| 65 | +- [Azure Virtual Machines planning and implementation for SAP NetWeaver](./planning-guide.md) |
0 commit comments