Merge pull request #249608 from guywi-ms/patch-67

v-dirichards · web-flow · commit bdc3b33294c9 · 2023-09-18T10:01:24.000-05:00
Update agent-dependency-linux.md
diff --git a/articles/virtual-machines/extensions/agent-dependency-linux.md b/articles/virtual-machines/extensions/agent-dependency-linux.md
@@ -2,17 +2,17 @@
 title: Azure Monitor Dependency virtual machine extension for Linux
 description: Deploy the Azure Monitor Dependency agent on Linux virtual machine by using a virtual machine extension.
 ms.topic: article
-ms.service: virtual-machines
-ms.subservice: extensions
+ms.service: azure-monitor
+ms.subservice: agents
 ms.custom: devx-track-azurecli
-author: mgoedtel
-ms.author: magoedte
+author: guywi-ms
+ms.author: guywild
 ms.collection: linux
-ms.date: 06/01/2021
+ms.date: 08/29/2023
 ---
 # Azure Monitor Dependency virtual machine extension for Linux
 
-The Azure Monitor for VMs Map feature gets its data from the Microsoft Dependency agent. The Azure VM Dependency agent virtual machine extension for Linux is published and supported by Microsoft. The extension installs the Dependency agent on Azure virtual machines. This document details the supported platforms, configurations, and deployment options for the Azure VM Dependency agent virtual machine extension for Linux.
+The Azure Monitor for VMs Map feature gets its data from the Microsoft Dependency agent. The Azure VM Dependency agent virtual machine extension for Linux installs the Dependency agent on Azure virtual machines. This document details the supported platforms, configurations, and deployment options for the Azure VM Dependency agent virtual machine extension for Linux.
 
 ## Prerequisites
 
@@ -28,30 +28,32 @@ The following JSON shows the schema for the Azure VM Dependency agent extension
 {
     "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
-  "parameters": {
-    "vmName": {
-      "type": "string",
-      "metadata": {
-        "description": "The name of existing Linux Azure VM."
+    "parameters": {
+      "vmName": {
+        "type": "string",
+        "metadata": {
+            "description": "The name of existing Linux Azure VM."
       }
     }
   },
   "variables": {
-    "vmExtensionsApiVersion": "2017-03-30"
+      "vmExtensionsApiVersion": "2017-03-30"
   },
   "resources": [
     {
       "type": "Microsoft.Compute/virtualMachines/extensions",
       "name": "[concat(parameters('vmName'),'/DAExtension')]",
       "apiVersion": "[variables('vmExtensionsApiVersion')]",
       "location": "[resourceGroup().location]",
-      "dependsOn": [
-      ],
+      "dependsOn": [],
       "properties": {
-        "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
-        "type": "DependencyAgentLinux",
-        "typeHandlerVersion": "9.5",
-        "autoUpgradeMinorVersion": true
+          "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
+          "type": "DependencyAgentLinux",
+          "typeHandlerVersion": "9.5",
+          "autoUpgradeMinorVersion": true,
+          "settings": {
+              "enableAMA": "true"
+        }
       }
     }
   ],
@@ -68,6 +70,10 @@ The following JSON shows the schema for the Azure VM Dependency agent extension
 | publisher | Microsoft.Azure.Monitoring.DependencyAgent |
 | type | DependencyAgentLinux |
 | typeHandlerVersion | 9.5 |
+| settings | "enableAMA": "true" |
+
+> [!IMPORTANT]
+> Be sure to add `enableAMA` to your template if you're using Azure Monitor Agent; otherwise, Dependency agent attempts to send data to the legacy Log Analytics agent.
 
 ## Template deployment
 
@@ -85,13 +91,16 @@ The following example assumes the Dependency agent extension is nested inside th
 	"apiVersion": "[variables('apiVersion')]",
 	"location": "[resourceGroup().location]",
 	"dependsOn": [
-		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
+      "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
 	],
 	"properties": {
-		"publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
+        "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
         "type": "DependencyAgentLinux",
         "typeHandlerVersion": "9.5",
-        "autoUpgradeMinorVersion": true
+        "autoUpgradeMinorVersion": true,
+        "settings": {
+            "enableAMA": "true"
+        }
 	}
 }
 ```
@@ -105,13 +114,16 @@ When you place the extension JSON at the root of the template, the resource name
 	"apiVersion": "[variables('apiVersion')]",
 	"location": "[resourceGroup().location]",
 	"dependsOn": [
-		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
+      "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
 	],
 	"properties": {
-		"publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
+        "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
         "type": "DependencyAgentLinux",
         "typeHandlerVersion": "9.5",
-        "autoUpgradeMinorVersion": true
+        "autoUpgradeMinorVersion": true,
+        "settings": {
+            "enableAMA": "true"
+        }
 	}
 }
 ```
@@ -137,7 +149,7 @@ To enable automatic extension upgrade for an extension, you must ensure the prop
 
 When automatic extension upgrade is enabled on a VM or VM scale set, the extension is upgraded automatically whenever the extension publisher releases a new version for that extension. The upgrade is applied safely following availability-first principles as described [here](../automatic-extension-upgrade.md#how-does-automatic-extension-upgrade-work).
 
-The `enableAutomaticUpgrade` attribute's functionality is different from that of the `autoUpgradeMinorVersion`. The  `autoUpgradeMinorVersion` attributes does not automatically trigger a minor version update when the extension publisher releases a new version. The `autoUpgradeMinorVersion` attribute indicates whether the extension should use a newer minor version if one is available at deployment time. Once deployed, however, the extension will not upgrade minor versions unless redeployed, even with this property set to true.
+The `enableAutomaticUpgrade` attribute's functionality is different from that of the `autoUpgradeMinorVersion`. The  `autoUpgradeMinorVersion` attribute doesn't automatically trigger a minor version update when the extension publisher releases a new version. The `autoUpgradeMinorVersion` attribute indicates whether the extension should use a newer minor version if one is available at deployment time. Once deployed, however, the extension won't upgrade minor versions unless redeployed, even with this property set to true.
 
 To keep your extension version updated, we recommend using `enableAutomaticUpgrade` with your extension deployment.
 
diff --git a/articles/virtual-machines/extensions/agent-dependency-windows.md b/articles/virtual-machines/extensions/agent-dependency-windows.md
@@ -2,17 +2,17 @@
 title: Azure Monitor Dependency virtual machine extension for Windows
 description: Deploy the Azure Monitor Dependency agent on Windows virtual machine by using a virtual machine extension.
 ms.topic: article
-ms.service: virtual-machines
-ms.subservice: extensions
-author: mgoedtel
-ms.author: magoedte
+ms.service: azure-monitor
+ms.subservice: agents
+author: guywi-ms
+ms.author: guywild
 ms.reviewer: erd
 ms.collection: windows
-ms.date: 03/27/2023
+ms.date: 08/29/2023
 ---
 # Azure Monitor Dependency virtual machine extension for Windows
 
-The Azure Monitor for VMs Map feature gets its data from the Microsoft Dependency agent. The Azure VM Dependency agent virtual machine extension for Windows is published and supported by Microsoft. The extension installs the Dependency agent on Azure virtual machines. This document details the supported platforms, configurations, and deployment options for the Azure VM Dependency agent virtual machine extension for Windows.
+The Azure Monitor for VMs Map feature gets its data from the Microsoft Dependency agent. The Azure VM Dependency agent virtual machine extension for Windows installs the Dependency agent on Azure virtual machines. This document details the supported platforms, configurations, and deployment options for the Azure VM Dependency agent virtual machine extension for Windows.
 
 ## Operating system
 
@@ -24,8 +24,8 @@ The following JSON shows the schema for the Azure VM Dependency agent extension
 
 ```json
 {
-    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
-    "contentVersion": "1.0.0.0",
+  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
+  "contentVersion": "1.0.0.0",
   "parameters": {
     "vmName": {
       "type": "string",
@@ -43,13 +43,15 @@ The following JSON shows the schema for the Azure VM Dependency agent extension
       "name": "[concat(parameters('vmName'),'/DAExtension')]",
       "apiVersion": "[variables('vmExtensionsApiVersion')]",
       "location": "[resourceGroup().location]",
-      "dependsOn": [
-      ],
+      "dependsOn": [],
       "properties": {
-        "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
-        "type": "DependencyAgentWindows",
-        "typeHandlerVersion": "9.10",
-        "autoUpgradeMinorVersion": true
+          "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
+          "type": "DependencyAgentWindows",
+          "typeHandlerVersion": "9.10",
+          "autoUpgradeMinorVersion": true,
+          "settings": {
+                "enableAMA": "true"
+		    }
       }
     }
   ],
@@ -66,7 +68,12 @@ The following JSON shows the schema for the Azure VM Dependency agent extension
 | publisher | Microsoft.Azure.Monitoring.DependencyAgent |
 | type | DependencyAgentWindows |
 | typeHandlerVersion | 9.10 |
+| autoUpgradeMinorVersion | true |
+| settings | "enableAMA": "true" |
 
+
+> [!IMPORTANT]
+> Be sure to add `enableAMA` to your template if you're using Azure Monitor Agent; otherwise, Dependency agent attempts to send data to the legacy Log Analytics agent.
 ## Template deployment
 
 You can deploy the Azure VM extensions with Azure Resource Manager templates. You can use the JSON schema detailed in the previous section in an Azure Resource Manager template to run the Azure VM Dependency agent extension during an Azure Resource Manager template deployment.
@@ -86,11 +93,14 @@ The following example assumes the Dependency agent extension is nested inside th
 		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
 	],
 	"properties": {
-		"publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
-        "type": "DependencyAgentWindows",
-        "typeHandlerVersion": "9.10",
-        "autoUpgradeMinorVersion": true
-	}
+      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
+      "type": "DependencyAgentWindows",
+      "typeHandlerVersion": "9.10",
+      "autoUpgradeMinorVersion": true,
+      "settings": {
+            "enableAMA": "true"
+    		    }
+    }
 }
 ```
 
@@ -106,10 +116,13 @@ When you place the extension JSON at the root of the template, the resource name
 		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
 	],
 	"properties": {
-		"publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
-        "type": "DependencyAgentWindows",
-        "typeHandlerVersion": "9.10",
-        "autoUpgradeMinorVersion": true
+      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
+      "type": "DependencyAgentWindows",
+      "typeHandlerVersion": "9.10",
+      "autoUpgradeMinorVersion": true,
+      "settings": {
+            "enableAMA": "true"
+    		    }
 	}
 }
 ```
@@ -136,7 +149,7 @@ To enable automatic extension upgrade for an extension, you must ensure the prop
 
 When automatic extension upgrade is enabled on a VM or VM scale set, the extension is upgraded automatically whenever the extension publisher releases a new version for that extension. The upgrade is applied safely following availability-first principles as described [here](../automatic-extension-upgrade.md#how-does-automatic-extension-upgrade-work).
 
-The `enableAutomaticUpgrade` attribute's functionality is different from that of the `autoUpgradeMinorVersion`. The  `autoUpgradeMinorVersion` attributes does not automatically trigger a minor version update when the extension publisher releases a new version. The `autoUpgradeMinorVersion` attribute indicates whether the extension should use a newer minor version if one is available at deployment time. Once deployed, however, the extension will not upgrade minor versions unless redeployed, even with this property set to true.
+The `enableAutomaticUpgrade` attribute's functionality is different from that of the `autoUpgradeMinorVersion`. The  `autoUpgradeMinorVersion` attribute doesn't automatically trigger a minor version update when the extension publisher releases a new version. The `autoUpgradeMinorVersion` attribute indicates whether the extension should use a newer minor version if one is available at deployment time. Once deployed, however, the extension won't upgrade minor versions unless redeployed, even with this property set to true.
 
 To keep your extension version updated, we recommend using `enableAutomaticUpgrade` with your extension deployment.
 
