La extensión de máquina virtual del agente de Network Watcher es un requisito para algunas de las características de Azure Network Watcher que capturan el tráfico de red para diagnosticar y supervisar máquinas virtuales (VM) de Azure. Para más información, consulte ¿Qué es Azure Network Watcher?
En este artículo, aprenderá a instalar y desinstalar el agente de Network Watcher para Linux. La instalación del agente no interrumpe la máquina virtual ni requiere reiniciarla. Si la máquina virtual se ha implementado mediante un servicio de Azure, consulte la documentación del servicio para decidir si permite o no la instalación de extensiones en la máquina virtual.
Nota:
No se admite la extensión del agente de Network Watcher en clústeres de AKS.
Requisitos previos
Una máquina virtual (VM) Linux de Azure. Para obtener más información, consulte Distribuciones y versiones de Linux compatibles.
Conectividad TCP saliente a 169.254.169.254 por port 80 y 168.63.129.16 a través de port 8037. El agente usa estas direcciones IP para comunicarse con la plataforma Azure.
Conectividad a Internet: el agente de Network Watcher requiere conectividad a Internet para que algunas características funcionen correctamente. Por ejemplo, requiere conectividad con la cuenta de almacenamiento para cargar capturas de paquetes.
Una máquina virtual (VM) Linux de Azure. Para obtener más información, consulte Distribuciones y versiones de Linux compatibles.
Conectividad TCP saliente a 169.254.169.254 por port 80 y 168.63.129.16 a través de port 8037. El agente usa estas direcciones IP para comunicarse con la plataforma Azure.
Conectividad a Internet: el agente de Network Watcher requiere conectividad a Internet para que algunas características funcionen correctamente. Por ejemplo, requiere conectividad con la cuenta de almacenamiento para cargar capturas de paquetes.
Azure Cloud Shell o Azure PowerShell.
Los pasos de este artículo ejecutarán los cmdlets de Azure PowerShell de forma interactiva en Azure Cloud Shell. Para ejecutar los comandos en Cloud Shell, seleccione Abrir Cloud Shell en la esquina superior derecha de un bloque de código. Seleccione Copiar para copiar el código y péguelo, a continuación, en Cloud Shell para ejecutarlo. También podrá ejecutar Cloud Shell desde Azure Portal.
También podrá instalar Azure PowerShell localmente para ejecutar los cmdlet. Si ejecuta PowerShell localmente, inicie sesión en Azure con el cmdlet Connect-AzAccount.
Una máquina virtual (VM) Linux de Azure. Para obtener más información, consulte Distribuciones y versiones de Linux compatibles.
Conectividad TCP saliente a 169.254.169.254 por port 80 y 168.63.129.16 a través de port 8037. El agente usa estas direcciones IP para comunicarse con la plataforma Azure.
Conectividad a Internet: el agente de Network Watcher requiere conectividad a Internet para que algunas características funcionen correctamente. Por ejemplo, requiere conectividad con la cuenta de almacenamiento para cargar capturas de paquetes.
Azure Cloud Shell o la CLI de Azure.
Los pasos de este artículo ejecutarán los comandos de la CLI de Azure de forma interactiva en Azure Cloud Shell. Para ejecutar los comandos en Cloud Shell, seleccione Abrir Cloud Shell en la esquina superior derecha de un bloque de código. Seleccione Copiar para copiar el código y péguelo en Cloud Shell para ejecutarlo. También podrá ejecutar Cloud Shell desde Azure Portal.
También puede instalar la CLI de Azure localmente para ejecutar los comandos. Si ejecuta la CLI de Azure localmente, inicie sesión en Azure con el comando az login.
Una máquina virtual (VM) Linux de Azure. Para obtener más información, consulte Distribuciones y versiones de Linux compatibles.
Conectividad TCP saliente a 169.254.169.254 por port 80 y 168.63.129.16 a través de port 8037. El agente usa estas direcciones IP para comunicarse con la plataforma Azure.
Conectividad a Internet: el agente de Network Watcher requiere conectividad a Internet para que algunas características funcionen correctamente. Por ejemplo, requiere conectividad con la cuenta de almacenamiento para cargar capturas de paquetes.
Azure PowerShell o la CLI de Azure instalados localmente para implementar la plantilla.
Sistemas operativos admitidos
La extensión network Watcher Agent para Linux se puede instalar en las siguientes distribuciones de Linux:
| Distribución |
Versión |
| AlmaLinux |
9.2 |
| Azure Linux |
2.0 |
| CentOS 1 |
6.10 y 7 |
| Debian |
7 y 8 |
| openSUSE Leap |
42.3+ |
| Oracle Linux |
6.10 2, 7 y 8+ |
| Red Hat Enterprise Linux (RHEL) |
6.10 3, 7, 8 y 9.2 |
| Rocky Linux |
9.1 |
| SUSE Linux Enterprise Server (SLES) |
12 y 15 (SP2, SP3 y SP4) |
| Ubuntu |
Más de 16 |
1 CentOS Linux alcanzó su fin de ciclo de vida (EOL) el 30 de junio de 2024. Para más información, consulte la Guía de fin de ciclo de vida de CentOS.
2Compatibilidad con el ciclo de vida extendido (ELS) para Oracle Linux versión 6.X finalizó el 1 de julio de 2024.
3Compatibilidad con el ciclo de vida extendido (ELS) para Red Hat Enterprise Linux 6.X finalizó el 30 de junio de 2024.
Esquema de extensión
El siguiente JSON muestra el esquema para la extensión del agente de Network Watcher. La extensión no requiere ni admite ninguna configuración proporcionada por el usuario. La extensión se basa en su configuración predeterminada.
{
"name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
"type": "Microsoft.Compute/virtualMachines/extensions",
"apiVersion": "2023-03-01",
"___location": "[resourceGroup().___location]",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', parameters('vmName'))]"
],
"properties": {
"autoUpgradeMinorVersion": true,
"publisher": "Microsoft.Azure.NetworkWatcher",
"type": "NetworkWatcherAgentLinux",
"typeHandlerVersion": "1.4"
}
}
Enumeración de las extensiones instaladas
En la página de la máquina virtual de Azure Portal, puede ver la extensión instalada siguiendo estos pasos:
En Configuración, seleccione Extensiones + aplicaciones.
En la pestaña Extensiones, puede ver todas las extensiones instaladas en la máquina virtual. Si la lista es larga, puede usar el cuadro de búsqueda para filtrar la lista.
Use el cmdlet Get-AzVMExtension para enumerar todas las extensiones instaladas en la máquina virtual:
# List the installed extensions on the virtual machine.
Get-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' | format-table Name, Publisher, ExtensionType, AutoUpgradeMinorVersion, EnableAutomaticUpgrade
La salida del cmdlet enumera las extensiones instaladas:
Name Publisher ExtensionType AutoUpgradeMinorVersion EnableAutomaticUpgrade
---- --------- ------------- ----------------------- ----------------------
AzureNetworkWatcherExtension Microsoft.Azure.NetworkWatcher NetworkWatcherAgentLinux True True
Use el comando az vm extension list para enumerar todas las extensiones instaladas en la máquina virtual:
# List the installed extensions on the virtual machine.
az vm extension list --resource-group 'myResourceGroup' --vm-name 'myVM' --out table
La salida del comando enumera todas las extensiones instaladas:
Name ProvisioningState Publisher Version AutoUpgradeMinorVersion
---------------------------- ------------------- ------------------------------ --------- -------------------------
AzureNetworkWatcherExtension Succeeded Microsoft.Azure.NetworkWatcher 1.4 True
Instalación de la extensión de máquina virtual del agente de Network Watcher
En la página de la máquina virtual de Azure Portal, puede instalar la extensión de máquina virtual del agente de Network Watcher siguiendo estos pasos:
En Configuración, seleccione Extensiones + aplicaciones.
Seleccione + Agregar, busque Agente de Network Watcher e instálelo. Si la extensión ya está instalada, puede verla en la lista de extensiones.
En el cuadro de búsqueda de Instalar una extensión, escriba Network Watcher Agent for Linux. Seleccione la extensión de la lista y seleccione Siguiente.
Seleccione Revisar y crear y luego Crear.
Use el cmdlet Set-AzVMExtension para instalar la extensión de máquina virtual del agente de Network Watcher en la máquina virtual:
# Install Network Watcher Agent for Linux on the virtual machine.
Set-AzVMExtension -Name 'AzureNetworkWatcherExtension' -Publisher 'Microsoft.Azure.NetworkWatcher' -ExtensionType 'NetworkWatcherAgentLinux' -EnableAutomaticUpgrade 1 -TypeHandlerVersion '1.4' -ResourceGroupName 'myResourceGroup' -VMName 'myVM'
Una vez completada correctamente la instalación, verá la siguiente salida:
RequestId IsSuccessStatusCode StatusCode ReasonPhrase
--------- ------------------- ---------- ------------
True OK
Use el comando az vm extension set para instalar la extensión de máquina virtual del agente de Network Watcher en la máquina virtual:
# Install Network Watcher Agent for Windows on the virtual machine.
az vm extension set --name 'NetworkWatcherAgentLinux' --extension-instance-name 'AzureNetworkWatcherExtension' --publisher 'Microsoft.Azure.NetworkWatcher' --enable-auto-upgrade 'true' --version '1.4' --resource-group 'myResourceGroup' --vm-name 'myVM'
Use la siguiente plantilla de Azure Resource Manager (plantilla de ARM) para instalar la extensión de máquina virtual del agente de Network Watcher en una máquina virtual Linux:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"type": "string"
}
},
"variables": {},
"resources": [
{
"name": "[parameters('vmName')]",
"type": "Microsoft.Compute/virtualMachines",
"apiVersion": "2023-03-01",
"___location": "[resourceGroup().___location]",
"properties": {
}
},
{
"name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
"type": "Microsoft.Compute/virtualMachines/extensions",
"apiVersion": "2023-03-01",
"___location": "[resourceGroup().___location]",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', parameters('vmName'))]"
],
"properties": {
"autoUpgradeMinorVersion": true,
"publisher": "Microsoft.Azure.NetworkWatcher",
"type": "NetworkWatcherAgentLinux",
"typeHandlerVersion": "1.4"
}
}
],
"outputs": {}
}
Puede usar Azure PowerShell o la CLI de Azure para implementar la plantilla de Resource Manager:
# Deploy the JSON template file using Azure PowerShell.
New-AzResourceGroupDeployment -ResourceGroupName 'myResourceGroup' -TemplateFile 'agent.json'
# Deploy the JSON template file using the Azure CLI.
az deployment group create --resource-group 'myResourceGroup' --template-file 'agent.json'
Desinstalación de la extensión de máquina virtual del agente de Network Watcher
En la página de la máquina virtual de Azure Portal, puede desinstalar la extensión de máquina virtual del agente de Network Watcher siguiendo estos pasos:
En Configuración, seleccione Extensiones + aplicaciones.
Seleccione AzureNetworkWatcherExtension en la lista de extensiones y, a continuación, seleccione Desinstalar.
Nota:
Es posible que vea la extensión de máquina virtual del agente de Network Watcher con un nombre distinto de AzureNetworkWatcherExtension.
Use el cmdlet Remove-AzVMExtension para quitar la extensión de máquina virtual del agente de Network Watcher de la máquina virtual:
# Uninstall Network Watcher Agent VM extension.
Remove-AzureVMExtension -Name 'AzureNetworkWatcherExtension' -ResourceGroupName 'myResourceGroup' -VMName 'myVM'
Use el comando az vm extension delete para quitar la extensión de máquina virtual del agente de Network Watcher de la máquina virtual:
# Uninstall Network Watcher Agent VM extension.
az vm extension delete --name 'AzureNetworkWatcherExtension' --resource-group 'myResourceGroup' --vm-name 'myVM'
Preguntas más frecuentes
Para obtener respuestas a las preguntas más frecuentes sobre el agente de Network Watcher, consulte Preguntas más frecuentes sobre el agente de Network Watcher.
Contenido relacionado
