Extensión de máquina virtual de Azure Monitor Dependency para Windows

Artículo
03/08/2024

La característica Service Map de Azure Monitor para VM obtiene sus datos de Microsoft Dependency Agent. La extensión de máquina virtual VM Dependency agent de Azure para Windows instala Dependency agent en máquinas virtuales de Azure. En este documento se especifican las plataformas compatibles, las configuraciones y las opciones de implementación de la extensión de máquina virtual de Dependency Agent de Azure VM para Windows.

Sistema operativo

La extensión de Dependency Agent de máquina virtual de Azure para Windows se puede ejecutar en los sistemas operativos admitidos que se enumeran en la tabla siguiente. Se supone que todos los sistemas operativos de la tabla siguiente son x64. No se admite x86 para ningún sistema operativo.

Sistema operativo	Dependency Agent de máquina virtual de Azure
Windows Server 2022	✓
Windows Server 2022 Core	✓
Windows Server 2019	✓
Windows Server 2019 Core	✓
Windows Server 2016	✓
Windows Server 2016 Core	✓
Windows Server 2012 R2	✓
Windows Server 2012	✓
Windows 11 Cliente y Pro	✓¹, ²
Windows 11 Enterprise (incluida la sesión múltiple)	✓
Windows 10 1803 (RS4) y versiones posteriores	✓¹
Windows 10 Enterprise (incluida la sesión múltiple) y Pro (Solo para escenarios de servidor)	✓
Windows 8 Enterprise y Pro (Solo para escenarios de servidor)
Windows 7 SP1 (Solo para escenarios de servidor)
Azure Stack HCI
Windows IoT Enterprise	✓

¹ Uso del instalador de cliente del agente de Azure Monitor.
² También se admite en máquinas basadas en Arm64.

Esquema de extensión

El siguiente JSON muestra el esquema de la extensión de Dependency Agent de Azure VM en una máquina virtual Windows de Azure.

{
  "$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 Azure VM. Supported Windows Server versions:  2008 R2 and above (x64)."
      }
    }
  },
  "variables": {
    "vmExtensionsApiVersion": "2017-03-30"
  },
  "resources": [
    {
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "name": "[concat(parameters('vmName'),'/DAExtension')]",
      "apiVersion": "[variables('vmExtensionsApiVersion')]",
      "location": "[resourceGroup().location]",
      "dependsOn": [],
      "properties": {
          "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
          "type": "DependencyAgentWindows",
          "typeHandlerVersion": "9.10",
          "autoUpgradeMinorVersion": true,
          "settings": {
                "enableAMA": "true"
		    }
      }
    }
  ],
    "outputs": {
    }
}

Valores de propiedad

Nombre	Valor/ejemplo
apiVersion	2015-01-01
publisher	Microsoft.Azure.Monitoring.DependencyAgent
type	DependencyAgentWindows
typeHandlerVersion	9.10
autoUpgradeMinorVersion	true
configuración	"enableAMA": "true"

Importante

Asegúrese de agregar enableAMA a la plantilla si usa el agente de Azure Monitor; de lo contrario, Dependency Agent intenta enviar datos al agente de Log Analytics heredado.

Implementación de plantilla

Puede implementar las extensiones de Azure VM con plantillas de Azure Resource Manager. Puede usar el esquema JSON detallado en la sección anterior en una plantilla de Azure Resource Manager para ejecutar la extensión de Dependency Agent de Azure VM durante la implementación de dicha plantilla.

El JSON de una extensión de máquina virtual se puede anidar dentro del recurso de máquina virtual. O bien, puede colocarlo en la raíz o en el nivel superior de una plantilla JSON de Resource Manager. La colocación de la plantilla JSON afecta al valor del nombre y tipo del recurso. Para obtener más información, consulte el artículo sobre cómo establecer el nombre y el tipo de recursos secundarios.

En el siguiente ejemplo se da por supuesto que la extensión de Dependency Agent está anidada dentro del recurso de máquina virtual. Cuando se anidan los recursos de extensión, el JSON se coloca en el objeto "resources": [] de la máquina virtual.

{
	"type": "extensions",
	"name": "DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
      "type": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
    }
}

Al colocar el JSON de la extensión en la raíz de la plantilla, el nombre de recurso incluye una referencia a la máquina virtual principal. El tipo refleja la configuración anidada.

{
	"type": "Microsoft.Compute/virtualMachines/extensions",
	"name": "<parentVmResource>/DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
      "type": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
	}
}

Implementación de PowerShell

Puede usar el comando Set-AzVMExtension para implementar la extensión de máquina virtual de Dependency Agent en una máquina virtual existente. Antes de ejecutar el comando, las configuraciones públicas y privadas deben estar almacenadas en una tabla hash de PowerShell.


Set-AzVMExtension -ExtensionName "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Publisher "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ExtensionType "DependencyAgentWindows" `
    -TypeHandlerVersion 9.10 `
    -Location WestUS

Actualización automática de extensiones

Ahora hay disponible una nueva característica para actualizar automáticamente las versiones secundarias de la extensión Dependency.

Para habilitar la actualización automática de extensiones para una extensión, debe asegurarse de que la propiedad enableAutomaticUpgrade esté establecida en true y de que se haya agregado a la plantilla de extensiones. Esta propiedad debe habilitarse individualmente en cada VM o conjunto de escalado de VM. Use uno de los métodos descritos en la sección habilitación para habilitar la característica para la VM o el conjunto de escalado de VM.

Cuando la actualización automática de extensiones está habilitada en una VM o en un conjunto de escalado de VM, la extensión se actualiza automáticamente cada vez que el editor de la extensión publica una nueva versión de esta. La actualización se aplica de forma segura siguiendo los principios de orden de disponibilidad, como se describe aquí.

La funcionalidad del atributo enableAutomaticUpgrade es diferente de la de autoUpgradeMinorVersion. El atributo autoUpgradeMinorVersion no desencadenan automáticamente una actualización de una versión secundaria cuando el editor de la extensión publica una nueva versión. El atributo autoUpgradeMinorVersion indica si la extensión debe usar una versión secundaria más reciente si hay una disponible en el momento de la implementación. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true.

Para mantener actualizada la versión de la extensión, se recomienda usar enableAutomaticUpgrade con la implementación de la extensión.

Importante

Si agrega enableAutomaticUpgrade a la plantilla, asegúrese de usar la versión de API 2019-12-01 o superior.

Solución de problemas y asistencia

Solución de problemas

Los datos sobre el estado de las implementaciones de extensiones pueden recuperarse desde Azure Portal y mediante el módulo Azure PowerShell. Para ver el estado de implementación de las extensiones de una VM determinada, ejecute el comando siguiente con el módulo Azure PowerShell:

Get-AzVMExtension -ResourceGroupName myResourceGroup -VMName myVM -Name myExtensionName

El resultado de la ejecución de las extensiones se registra en los archivos que se encuentran en el siguiente directorio:

C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitoring.DependencyAgent\

Soporte técnico

Si necesita más ayuda en algún punto de este artículo, puede ponerse en contacto con los expertos de Azure en los foros de Microsoft Q&A y Stack Overflow. O bien, puede registrar un incidente de soporte técnico de Azure. Vaya al sitio de soporte técnico de Azure y seleccione Obtener soporte. Para obtener más información sobre cómo usar el soporte técnico de Azure, lea las preguntas más frecuentes del soporte técnico de Microsoft Azure.