Skip to content

Commit 4344183

Browse files
Merge pull request #283266 from kainawroth/kainawroth-troubleshoot
Updating troubleshoot doc -- adding 'not' to sentence
2 parents 2ba3fb5 + 979e083 commit 4344183

File tree

2 files changed

+35
-38
lines changed

2 files changed

+35
-38
lines changed

articles/azure-monitor/agents/azure-monitor-agent-troubleshoot-windows-vm.md

Lines changed: 24 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -12,43 +12,41 @@ ms.reviewer: jeffwo
1212
[!INCLUDE [azure-monitor-agent-architecture](../../../includes/azure-monitor-agent/azure-monitor-agent-architecture-include.md)]
1313

1414
## Basic troubleshooting steps (installation, agent not running, configuration issues)
15-
1615
Follow the steps below to troubleshoot the latest version of the Azure Monitor agent running on your Windows virtual machine:
1716

18-
1. **Carefully review the [prerequisites here](./azure-monitor-agent-manage.md#prerequisites).**
17+
1. **Carefully review the [prerequisites here](./azure-monitor-agent-manage.md#prerequisites).**
1918

20-
2. **Verify that the extension was successfully installed and provisioned, which installs the agent binaries on your machine**:
21-
1. Open Azure portal > select your virtual machine > Open **Settings** : **Extensions + applications** from the pane on the left > 'AzureMonitorWindowsAgent'should show up with Status: 'Provisioning succeeded'
22-
2. If not, check if machine can reach Azure and find the extension to install using the command below:
19+
2. **Verify that the extension was successfully installed and provisioned, which installs the agent binaries on your machine**:
20+
1. Open Azure portal > select your virtual machine > Open **Settings** : **Extensions + applications** from the pane on the left > 'AzureMonitorWindowsAgent'should show up with Status: 'Provisioning succeeded'
21+
2. If not, check if machine can reach Azure and find the extension to install using the command below:
2322
```azurecli
2423
az vm extension image list-versions --location <machine-region> --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor
2524
```
26-
3. Wait for 10-15 minutes as extension maybe in transitioning status. If it still doesn't show up, [uninstall and install the extension](./azure-monitor-agent-manage.md) again and repeat the verification to see the extension show up.
27-
4. If not, check if you see any errors in extension logs located at `C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent` on your machine
28-
29-
3. **Verify that the agent is running**:
25+
3. Wait for 10-15 minutes as extension maybe in transitioning status. If it still doesn't show up, [uninstall and install the extension](./azure-monitor-agent-manage.md) again and repeat the verification to see the extension show up.
26+
4. If not, check if you see any errors in extension logs located at `C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent` on your machine
27+
28+
3. **Verify that the agent is running**:
3029
1. Check if the agent is emitting heartbeat logs to Log Analytics workspace using the query below. Skip if 'Custom Metrics' is the only destination in the DCR:
31-
```kusto
32-
Heartbeat | where Category == "Azure Monitor Agent" and Computer == "<computer-name>" | take 10
30+
```Kusto
31+
Heartbeat | where Category == "Azure Monitor Agent" and 'Computer' == "<computer-name>" | take 10
3332
```
34-
2. If not, open Task Manager and check if 'MonAgentCore.exe' process is running. If it is, wait for 5 minutes for heartbeat to show up.
35-
3. If not, check if you see any errors in core agent logs located at `C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Configuration` on your machine
36-
37-
4. **Verify that the DCR exists and is associated with the virtual machine:**
38-
1. If using Log Analytics workspace as destination, verify that DCR exists in the same physical region as the Log Analytics workspace.
33+
2. If not, open Task Manager and check if 'MonAgentCore.exe' process is running. If it is, wait for 5 minutes for heartbeat to show up.
34+
3. If not, check if you see any errors in core agent logs located at `C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Configuration` on your machine
35+
36+
4. **Verify that the DCR exists and is associated with the virtual machine:**
37+
1. If using Log Analytics workspace as destination, verify that DCR exists in the same physical region as the Log Analytics workspace.
3938
2. On your virtual machine, verify the existence of the file `C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.latest.xml`. If this file doesn't exist:
40-
* The virtual machine may not be associated with a DCR. See step 3
41-
* The virtual machine may not have Managed Identity enabled. [See here](../../active-directory/managed-identities-azure-resources/qs-configure-portal-windows-vm.md#enable-system-assigned-managed-identity-during-creation-of-a-vm) on how to enable.
42-
* IMDS service isn't running/accessible from the virtual machine. [Check if you can access IMDS from the machine](../../virtual-machines/windows/instance-metadata-service.md?tabs=windows).
43-
* AMA can't access IMDS. Check if you see IMDS errors in `C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Tables\MAEventTable.tsf` file.
44-
3. Open Azure portal > select your data collection rule > Open **Configuration** : **Resources** from the pane on the left > You should see the virtual machine listed here
39+
- The virtual machine may not be associated with a DCR. See step 3
40+
- The virtual machine may not have Managed Identity enabled. [See here](../../active-directory/managed-identities-azure-resources/qs-configure-portal-windows-vm.md#enable-system-assigned-managed-identity-during-creation-of-a-vm) on how to enable.
41+
- IMDS service isn't running/accessible from the virtual machine. [Check if you can access IMDS from the machine](../../virtual-machines/windows/instance-metadata-service.md?tabs=windows).
42+
- AMA can't access IMDS. Check if you see IMDS errors in `C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Tables\MAEventTable.tsf` file.
43+
3. Open Azure portal > select your data collection rule > Open **Configuration** : **Resources** from the pane on the left > You should see the virtual machine listed here
4544
4. If not listed, click 'Add' and select your virtual machine from the resource picker. Repeat across all DCRs.
4645
47-
5. **Verify that agent was able to download the associated DCR(s) from AMCS service:**
48-
Check if you see the latest DCR downloaded at this location `C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\configchunks`
49-
46+
5. **Verify that agent was able to download the associated DCR(s) from AMCS service:**
47+
1. Check if you see the latest DCR downloaded at this location `C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\configchunks`
48+
5049
## Issues collecting Performance counters
51-
5250
1. Check that your DCR JSON contains a section for 'performanceCounters'. If not, fix your DCR. See [how to create DCR](./azure-monitor-agent-data-collection.md) or [sample DCR](./data-collection-rule-sample-agent.md).
5351
2. Check that the file `C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.lkg.xml` exists.
5452
3. Open the file and check if it contains `CounterSet` nodes as shown in the example below:
@@ -63,8 +61,8 @@ Follow the steps below to troubleshoot the latest version of the Azure Monitor a
6361
</CounterSet>
6462
```
6563
66-
### Issues using 'Custom Metrics' as destination
6764
65+
### Issues using 'Custom Metrics' as destination
6866
1. Carefully review the [prerequisites here](./azure-monitor-agent-manage.md#prerequisites).
6967
2. Ensure that the associated DCR is correctly authored to collect performance counters and send them to Azure Monitor metrics. You should see this section in your DCR:
7068
```json
@@ -86,7 +84,6 @@ Follow the steps below to troubleshoot the latest version of the Azure Monitor a
8684
2. Open it and look for any Level 2 errors and try to fix them.
8785
8886
## Issues collecting Windows event logs
89-
9087
1. Check that your DCR JSON contains a section for 'windowsEventLogs'. If not, fix your DCR. See [how to create DCR](./azure-monitor-agent-data-collection.md) or [sample DCR](./data-collection-rule-sample-agent.md).
9188
2. Check that the file `C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.lkg.xml` exists.
9289
3. Open the file and check if it contains `Subscription` nodes as shown in the example below:

articles/azure-monitor/vm/vminsights-troubleshoot.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -9,17 +9,17 @@ ms.custom: references_regions
99

1010
---
1111

12-
# Troubleshoot VM insights
12+
# Troubleshoot VM Insights
1313

1414
This article provides troubleshooting information to help you with problems that you might experience when you try to enable or use the VM Insights feature in Azure Monitor.
1515

1616
## Can't enable VM Insights on a machine
1717

1818
When you onboard an Azure virtual machine (VM) from the Azure portal, the following actions occur:
1919

20-
- A default Log Analytics workspace is created if you selected that option.
21-
- The Azure Monitor Agent is installed on the virtual machine through an extension, if the agent is already installed.
22-
- The Dependency Agent is installed on the virtual machine through an extension, if it's required.
20+
* A default Log Analytics workspace is created if you selected that option.
21+
* The Azure Monitor Agent is installed on the virtual machine through an extension, if the agent isn't already installed.
22+
* The Dependency Agent is installed on the virtual machine through an extension, if it's required.
2323

2424
During the onboarding process, each of these steps is verified and a notification status appears in the portal. Configuration of the workspace and the agent installation typically takes 5 to 10 minutes. It takes another 5 to 10 minutes for data to become available to view in the portal.
2525

@@ -155,8 +155,8 @@ Heartbeat
155155

156156
If no data appears or if the computer didn't send a heartbeat recently, you might have problems with your agent. For agent troubleshooting information, see these articles:
157157

158-
- [Troubleshoot issues with the Log Analytics agent for Windows](../agents/agent-windows-troubleshoot.md)
159-
- [Troubleshoot issues with the Log Analytics agent for Linux](../agents/agent-linux-troubleshoot.md)
158+
* [Troubleshoot issues with the Log Analytics agent for Windows](../agents/agent-windows-troubleshoot.md)
159+
* [Troubleshoot issues with the Log Analytics agent for Linux](../agents/agent-linux-troubleshoot.md)
160160

161161
## Virtual machine doesn't appear in the Map view
162162

@@ -178,13 +178,13 @@ Use the log query in the [Performance view has no data](#performance-view-has-no
178178

179179
If the virtual machine is in the **Map** view and the Dependency Agent is installed and running, but the kernel driver didn't load, check the log file at the following locations:
180180

181-
| Operating system | Log |
182-
|:---|:---|
183-
| Windows | C:\Program Files\Microsoft Dependency Agent\logs\wrapper.log |
184-
| Linux | /var/opt/microsoft/dependency-agent/log/service.log |
181+
| Operating system | Log |
182+
|:-----------------|:-------------------------------------------------------------|
183+
| Windows | C:\Program Files\Microsoft Dependency Agent\logs\wrapper.log |
184+
| Linux | /var/opt/microsoft/dependency-agent/log/service.log |
185185

186186
The last lines of the file should indicate why the kernel didn't load. For example, the kernel might not be supported on Linux if you updated your kernel.
187187

188188
## Related content
189189

190-
- For more information on installing VM Insights agents, see [Enable VM Insights overview](vminsights-enable-overview.md)
190+
* For more information on installing VM Insights agents, see [Enable VM Insights overview](vminsights-enable-overview.md)

0 commit comments

Comments
 (0)