azure-linux-extensions/AzureMonitorAgent
Siddhartha Mathiharan 472ee53220
Copy Arc settings file in TST (#1973)
2024-09-17 15:33:10 -07:00
..
ama_tst Copy Arc settings file in TST (#1973) 2024-09-17 15:33:10 -07:00
services update ME startup args (#1963) 2024-08-23 14:11:18 -07:00
.gitignore update ME startup args (#1963) 2024-08-23 14:11:18 -07:00
HandlerManifest.json
README.md
agent.py Handle 2 byte unicode characters in locale (#1972) 2024-09-17 13:58:37 -07:00
agent.version
apply_version.sh
manifest.xml
packaging.sh
references
shim.sh
update_version.sh

README.md

AzureMonitorLinuxAgent Extension

Allow the owner of the Azure Virtual Machines to install the Azure Monitor Linux Agent

The Latest Version is 1.6.2

The extension is currently in Public Preview and is accessible to all public cloud regions in Azure.

You can read the User Guide below.

Azure Monitor Linux Agent Extension can:

  • Install the agent and pull configs from MCS

User Guide

1. Deploying the Extension to a VM

You can deploy it using Azure CLI

1.1. Using Azure CLI Resource Manager

You can view the availability of the Azure Monitor Linux Agent extension versions in each region by running:

az vm extension image list-versions -l <region> --name AzureMonitorLinuxAgent -p Microsoft.Azure.Monitor

You can deploy the Azure Monitor Linux Agent Extension by running:

az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --version <version> --resource-group <My Resource Group> --vm-name <My VM Name>

To update the version of the esisting installation of Azure Monitor Linux Agent extension on a VM, please add "--force-update" flag to the above command. (Currenty Waagent only supports this way of upgrading. Will update once we have more info from them.)

Supported Linux Distributions

Currently Manually tested only on -

  • CentOS Linux 6, and 7 (x64)
  • Red Hat Enterprise Linux Server 6 and 7 (x64)
  • Ubuntu 16.04 LTS, 18.04 LTS(x64)

Will Add more distros once they are tested

Troubleshooting

  • The status of the extension is reported back to Azure so that user can see the status on Azure Portal
  • All the extension installation and config files are unzipped into - /var/lib/waagent/Microsoft.Azure.Monitor.AzureMonitorLinuxAgent-<version>/packages/ and the tail of the output is logged into the log directory specified in HandlerEnvironment.json and reported back to Azure
  • The operation log of the extension is /var/log/azure/Microsoft.Azure.Monitor.AzureMonitorLinuxAgent-<version>/extension.log file.