Potential breaking changes for VM Insights Linux customers - Update your Dependency Agent

Published Mar 30 2022 01:41 PM 2,984 Views

Who is impacted?  

All VM Insights customers on Linux running Dependency Agent with versions 9.10.12 or below will be impacted. 


What is the impact? 

Dependency Agent for Linux versions 9.10.12 and lower are incompatible with the upcoming OMS Agent for Linux version 1.14.11  

If the OMS Agent is upgraded while running an incompatible Dependency Agent version, the VM Insights solution will stop working for the affected computer. The affected system will not appear on the Insights map. The affected system will not have data in the VMComputer, VMBoundPort, VMConnection, VMProcess, and InsightsMetrics tables. Alerts relying on data from Dependency Agent/VM Insights will not trigger correctly. 


Why are the changes being made? 

The OMS Agent for Linux is being upgraded to its latest version 1.14.11 with critical security updates. This includes data access mechanisms available to the Dependency Agent. The Dependency Agent for Linux has already been updated to handle these changes in version 9.10.13 


What do I need to do? 

If your VM extensions are enabled for auto-update, no action is needed from you.  

As part of the auto-update process, both extensions will be updated together and there should not be any impact on your data. To check the auto-update status for your VMs, see the “Detailed Guidance” section below. 

Customers may proactively update their version of Dependency Agent before the automatic update, steps are available in the “Detailed Guidance” section.  

If your VM extensions are not enabled for auto-update or if you are an Arc customer, you will need ensure that the Dependency Agent is updated to the latest version before the OMS agent is updated.  

See the “Detailed Guidance” section below for manual update instructions.  


Important dates – when are the changes going live? 

The changes will be deployed starting 11th April and will reach your Virtual Machines depending upon your region. 


Detailed Guidance  


Check status of VM extension auto-update  

In the Resource Graph Explorer, run the following query 


| extend props = parse_json(properties) 

| where props.publisher =~ "Microsoft.Azure.Monitoring.DependencyAgent" 

| extend AutomaticUpgradeEnabled = iif(props.enableAutomaticUpgrade == "true", "true", "false") 

| extend AutomaticUpgradeMinorVersionEnabled = iif(props.autoUpgradeMinorVersion == "true", "true", "false") 

| parse ['id'] with * "/resourceGroups/" resourceGroup "/providers/" provider "/" providerType "/" Computer "/" * 

| project subscriptionId, resourceGroup, provider, providerType, Computer, location, AutomaticUpgradeEnabled, AutomaticUpgradeMinorVersionEnabled, ['id'] 

| sortby subscriptionId asc, Computer asc 


The results will show your auto-update status for every Dependency Agent VM installation, along with some key properties to locate the VM. 


Find all systems needing an update 


In Log Analytics, run the query below 

| where OperatingSystemFamily == "linux"  
| summarize arg_max(TimeGenerated, DependencyAgentVersion) by Computer, _ResourceId 
| where parse_version(DependencyAgentVersion) < parse_version("9.10.13") 
| order by DependencyAgentVersion asc  

Note: The query only returns systems with older versions of the Dependency Agent. Updated systems are not returned.  


Check individual machines from the Azure Portal 

Go to the ‘Extensions’ blade of your Virtual Machine in the Azure Portal.   




Click on the ‘DependencyAgentLinux extension to see the details pane.  





Locate the version number in the ‘Version’ field.  You can also see the auto-update status here.  


Update the Dependency Agent  


For Azure VMs 

Modify the script below to set resource group and VM name, then execute script via Azure Cloud Shell. 



$daExtension = az vm extension list --resource-group $resourceGroup --vm-name $vmName --query "[?typePropertiesType=='DependencyAgentLinux']" | ConvertFrom-Json
az vm extension set --resource-group $resourceGroup --vm-name $vmName --publisher $daExtension.publisher --name $daExtension.name


For Azure Arc-enabled servers 

Modify the script below to set resource group and VM name, then execute script via Azure Cloud Shell. 



az connectedmachine upgrade-extension --machine-name $vmName --resource-group $resourceGroup --extension-targets '{\"DependencyAgentLinux \":{\"targetVersion\":\"\"}}'  


For On-Premises machines 

Please see steps for “Non-Azure VMs” here: https://docs.microsoft.com/en-us/azure/azure-monitor/vm/vminsights-dependency-agent-maintenance#upgr.... 


Version history
Last update:
‎Apr 06 2022 10:34 AM
Updated by: