Azure / Azure/azure-linux-extensions

Azure Monitor Agent Troubleshooting Tool Reports Subcomponent Installation Errors on ARM Linux VM

Open
#2,046 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
333
Forks
278
Avg merge
2d 9h
Merged PRs (30d)
4

Description

**Environment:**

**OS:** Linux (ARM Architecture VM)
**Machine Type:** Standard_D4pds_v5
**Ubuntu Version:** Ubuntu 20.04
**Agent:** Azure Monitor Agent (AMA)
**Tool:** AMA Troubleshooter (ama_troubleshooter.sh)
**Command Used:** sudo sh ama_troubleshooter.sh -A

**Issue Description:**

I created the required Data Collection Rule (DCR), Data Collection (DC), and associated LAW table. Everything works as expected on AMD-based VM types.

However, on ARM-based machines, it's not working. After debugging, I discovered the following:

The AMA troubleshooting tool (ama_troubleshooter.sh) reports that subcomponents agentlauncher and amacoreagent are not installed correctly.

Despite this, binaries such as mdsd, fluent-bit, and MetricsExtension are present in /opt/microsoft/azuremonitoragent/bin/.

This indicates a potential issue with AMA on ARM architecture.

Running the AMA troubleshooting tool produces the following error:

```bash
ERROR FOUND: Subcomponents(s) agentlauncher, amacoreagent not installed correctly.
However, binaries appear to be present:
```

```bash
ls -l /opt/microsoft/azuremonitoragent/bin/
total 79076
-rwxr-xr-x 1 root root 20125392 Apr 30 15:57 MetricsExtension
-rwxr-xr-x 1 root root 13638968 Apr 30 15:52 fluent-bit
drwxr-xr-x 2 root root 4096 Apr 30 15:52 kqlextension
-rwxr-xr-x 1 root root 25410456 Apr 30 15:52 mdsd
-rwxr-xr-x 1 root root 4153424 Apr 30 15:52 mdsdmgr
-rwxr-xr-x 1 root root 7245944 Apr 21 23:35 mdsdmgrctl
-rwxr-xr-x 1 root root 10380632 Apr 21 23:35 telegraf
```

❓Questions:
Why is the tool reporting agentlauncher and amacoreagent as missing, despite binaries existing in the expected location?

Is this a known limitation or bug on ARM-based Linux VMs?

What steps can be taken to explicitly install or verify agentlauncher and amacoreagent?

Is there a supported ARM installer variant for AMA or a known issue with subcomponent registration on ARM architecture?

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reproducing `sudo sh ama_troubleshooter.sh -A` on the described Ubuntu 20.04 ARM VM and inspect the checks for `agentlauncher` and `amacoreagent`. Compare those checks with the contents of `/opt/microsoft/azuremonitoragent/bin/`, including the listed binaries. Done means documenting whether this is an ARM-specific reporting or installation issue and identifying supported verification or installation steps.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure, linux, shell
Domain
devops, infrastructure, observability-sre
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.