A extensão de máquina virtual do Agente do Observador de Rede é um requisito para alguns dos recursos do Observador de Rede do Azure que capturam o tráfego de rede para diagnosticar e monitorar VMs (máquinas virtuais) do Azure. Para obter mais informações, consulte O que é o Observador de Rede do Azure?
Neste artigo, você aprende como instalar e desinstalar o Observador de Rede Agent para Windows e Linux. A instalação do agente não interrompe nem requer que a máquina virtual seja reiniciada. Se a máquina virtual for implantada por um serviço Azure, verifique a documentação do serviço para determinar se o serviço permite a instalação de extensões na máquina virtual.
Note
A extensão Observador de Rede Agent não é suportada em clusters AKS.
Pré-requisitos
Uma máquina virtual (VM) do Azure rodando um sistema operacional suportado. Para mais informações, veja Sistemas operacionais suportados.
Conectividade TCP de saída para 169.254.169.254 por port 80 e para 168.63.129.16 por port 8037. O agente usa esses endereços IP para se comunicar com a plataforma Azure.
Conectividade com a Internet: o Agente do Observador de Rede requer conectividade com a Internet para que alguns recursos funcionem corretamente. Por exemplo, ele requer conectividade com sua conta de armazenamento para carregar capturas de pacotes.
Uma máquina virtual (VM) do Azure rodando um sistema operacional suportado. Para mais informações, veja Sistemas operacionais suportados.
Conectividade TCP de saída para 169.254.169.254 por port 80 e para 168.63.129.16 por port 8037. O agente usa esses endereços IP para se comunicar com a plataforma Azure.
Conectividade com a Internet: o Agente do Observador de Rede requer conectividade com a Internet para que alguns recursos funcionem corretamente. Por exemplo, ele requer conectividade com sua conta de armazenamento para carregar capturas de pacotes.
Azure Cloud Shell ou Azure PowerShell.
As etapas deste artigo executam os cmdlets do Azure PowerShell interativamente no Azure Cloud Shell. Para executar os comandos no Cloud Shell, selecione Open Cloud Shell no canto superior direito de um bloco de código. Selecione Copiar para copiar o código e cole-o no Cloud Shell para executá-lo. Você também pode executar o Cloud Shell no portal do Azure.
Você também pode instalar o Azure PowerShell localmente para executar os cmdlets. Se você executar o PowerShell localmente, faça login no Azure usando o cmdlet Connect-AzAccount.
Uma máquina virtual (VM) do Azure rodando um sistema operacional suportado. Para mais informações, veja Sistemas operacionais suportados.
Conectividade TCP de saída para 169.254.169.254 por port 80 e para 168.63.129.16 por port 8037. O agente usa esses endereços IP para se comunicar com a plataforma Azure.
Conectividade com a Internet: o Agente do Observador de Rede requer conectividade com a Internet para que alguns recursos funcionem corretamente. Por exemplo, ele requer conectividade com sua conta de armazenamento para carregar capturas de pacotes.
Azure Cloud Shell ou CLI do Azure.
As etapas neste artigo executam os comandos da CLI do Azure interativamente no Azure Cloud Shell. Para executar os comandos no Cloud Shell, selecione Open Cloud Shell no canto superior direito de um bloco de código. Selecione Copiar para copiar o código e cole-o no Cloud Shell para executá-lo. Você também pode executar o Cloud Shell no portal do Azure.
Você também pode instalar CLI do Azure localmente para executar os comandos. Se você executar a CLI do Azure localmente, entre no Azure usando o comando az login.
Uma máquina virtual (VM) do Azure rodando um sistema operacional suportado. Para mais informações, veja Sistemas operacionais suportados.
Conectividade TCP de saída para 169.254.169.254 por port 80 e para 168.63.129.16 por port 8037. O agente usa esses endereços IP para se comunicar com a plataforma Azure.
Conectividade com a Internet: o Agente do Observador de Rede requer conectividade com a Internet para que alguns recursos funcionem corretamente. Por exemplo, ele requer conectividade com sua conta de armazenamento para carregar capturas de pacotes.
O Azure PowerShell ou a CLI do Azure foram instalados localmente para implantar o modelo.
Sistemas operacionais com suporte
A extensão do Agente do Observador de Rede para Windows pode ser instalada em:
- Versões do Windows Server 2012, 2012 R2, 2016, 2019, 2022 e 2025.
- Lançamentos do Windows 10 e 11.
Note
No momento, não há suporte para o Nano Server.
Você pode instalar a extensão Observador de Rede Agent para Linux nas seguintes distribuições Linux:
| Distribution |
Versão |
| AlmaLinux |
9.2 |
| Azure Linux |
2.0 |
| CentOS 1 |
6.10 e 7 |
| Debian |
7 e 8 |
| openSUSE Leap |
42.3+ |
| Oracle Linux |
6.10 2, 7, 8 e 9+ |
| Red Hat Enterprise Linux (RHEL) |
6.10 3, 7, 8 e 9.2 |
| Rocky Linux |
9.1 |
| SUSE Linux Enterprise Server (SLES) |
12 e 15 (SP2, SP3 e SP4) |
| Ubuntu |
Mais de 16 |
1 O CentOS Linux atingiu seu fim de vida útil (EOL) em 30 de junho de 2024. Para obter mais informações, veja as Diretrizes sobre fim da vida útil do CentOS.
2O Ciclo de vida estendido (ELS) para Oracle Linux versão 6.X foi encerrado em 1º de julho de 2024.
3O Ciclo de vida estendido (ELS) para Red Hat Enterprise Linux versão 6.X foi encerrado em 30 de junho de 2024.
Note
O monitoramento do Internet Control Message Protocol (ICMP) atualmente não é suportado no Observador de Rede Agent no Oracle Linux devido a limitações conhecidas no nível do kernel específicas da distro.
Esquema de extensão
O seguinte JSON mostra o esquema da extensão do Agente Observador de Rede. A extensão não requer e não é compatível com nenhuma configuração fornecida pelo usuário e é baseada em uma configuração padrão.
{
"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": "NetworkWatcherAgentWindows",
"typeHandlerVersion": "1.4"
}
}
{
"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"
}
}
Listar extensões instaladas
Na página da máquina virtual no portal do Azure, você pode visualizar as extensões instaladas seguindo estes passos:
Em Configurações, selecione Extensões + aplicativos.
Na guia Extensões, você pode ver todas as extensões instaladas na máquina virtual. Se a lista for longa, você poderá usar a caixa de pesquisa para filtrar a lista.
Use o cmdlet Get-AzVMExtension para listar todas as extensões instaladas na máquina virtual:
# List the installed extensions on the virtual machine.
Get-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' | format-table Name, Publisher, ExtensionType, AutoUpgradeMinorVersion, EnableAutomaticUpgrade
A saída do cmdlet lista as extensões instaladas:
Name Publisher ExtensionType AutoUpgradeMinorVersion EnableAutomaticUpgrade
---- --------- ------------- ----------------------- ----------------------
AzureNetworkWatcherExtension Microsoft.Azure.NetworkWatcher NetworkWatcherAgentWindows True True
Name Publisher ExtensionType AutoUpgradeMinorVersion EnableAutomaticUpgrade
---- --------- ------------- ----------------------- ----------------------
AzureNetworkWatcherExtension Microsoft.Azure.NetworkWatcher NetworkWatcherAgentLinux True True
Use o comando az vm extension list para listar todas as extensões instaladas na máquina virtual:
# List the installed extensions on the virtual machine.
az vm extension list --resource-group 'myResourceGroup' --vm-name 'myVM' --out table
A saída do comando lista as extensões instaladas:
Name ProvisioningState Publisher Version AutoUpgradeMinorVersion
---------------------------- ------------------- ------------------------------ --------- -------------------------
AzureNetworkWatcherExtension Succeeded Microsoft.Azure.NetworkWatcher 1.4 True
Instalar a extensão da VM do Agente do Observador de Rede
Na página da máquina virtual no portal do Azure, você pode instalar a extensão da VM do Agente do Observador de Rede seguindo estas etapas:
Em Configurações, selecione Extensões + aplicativos.
Selecione + Adicionar e pesquise Agente do Observador de Rede e instale-o. Se a extensão já estiver instalada, você poderá vê-la na lista de extensões.
Na caixa de busca de Instalar uma Extensão, insira Observador de Rede Agent, selecione a extensão correspondente para seu sistema operacional na lista e, em seguida, selecione Próximo.
Selecione Examinar + Criar e, em seguida, selecione Criar.
Use o cmdlet Set-AzVMExtension para instalar a extensão da VM do Agente do Observador de Rede na máquina virtual:
# Install Network Watcher Agent for Windows on the virtual machine.
Set-AzVMExtension -Name 'AzureNetworkWatcherExtension' -Publisher 'Microsoft.Azure.NetworkWatcher' -ExtensionType 'NetworkWatcherAgentWindows' -EnableAutomaticUpgrade 1 -TypeHandlerVersion '1.4' -ResourceGroupName 'myResourceGroup' -VMName 'myVM'
# 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'
Depois que a instalação for concluída com êxito, você verá a seguinte saída:
RequestId IsSuccessStatusCode StatusCode ReasonPhrase
--------- ------------------- ---------- ------------
True OK
Use o comando az vm extension set para instalar a extensão da VM do Agente do Observador de Rede na máquina virtual:
# Install Network Watcher Agent for Windows on the virtual machine.
az vm extension set --name 'NetworkWatcherAgentWindows' --extension-instance-name 'AzureNetworkWatcherExtension' --publisher 'Microsoft.Azure.NetworkWatcher' --enable-auto-upgrade 'true' --version '1.4' --resource-group 'myResourceGroup' --vm-name 'myVM'
# Install Network Watcher Agent for Linux 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 o seguinte modelo Azure Resource Manager (template ARM) para instalar a extensão VM Observador de Rede Agent em uma máquina virtual:
{
"$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": "NetworkWatcherAgentWindows",
"typeHandlerVersion": "1.4"
}
}
],
"outputs": {}
}
{
"$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": {}
}
Você pode usar o Azure PowerShell ou a CLI do Azure para implantar o modelo do 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'
Desinstalar a extensão de VM do Agente Observador de Rede
Na página da máquina virtual no portal do Azure, você pode desinstalar a extensão da VM do Agente do Observador de Rede seguindo estas etapas:
Em Configurações, selecione Extensões + aplicativos.
Selecione AzureNetworkWatcherExtension na lista de extensões e, em seguida, selecione Desinstalar.
Note
Você pode ver a extensão da VM do Agente do Observador de Rede com um nome diferente de AzureNetworkWatcherExtension.
Use o cmdlet Remove-AzVMExtension para remover a extensão da VM do Agente do Observador de Rede da máquina virtual:
# Uninstall Network Watcher Agent VM extension.
Remove-AzVMExtension -Name 'AzureNetworkWatcherExtension' -ResourceGroupName 'myResourceGroup' -VMName 'myVM'
Use o comando az vm extension delete para remover a extensão da VM do Agente do Observador de Rede da máquina virtual:
# Uninstall Network Watcher Agent VM extension.
az vm extension delete --name 'AzureNetworkWatcherExtension' --resource-group 'myResourceGroup' --vm-name 'myVM'
Perguntas frequentes (FAQ)
Para obter respostas para as perguntas mais frequentes sobre o Agente do Observador de Rede, consulte Perguntas frequentes sobre o Agente do Observador de Rede.
Conteúdo relacionado
