A extensão de máquina virtual do Agente do Inspetor de Rede é um requisito para alguns dos recursos do Inspetor de Rede do Azure que capturam o tráfego de rede para diagnosticar e monitorar máquinas virtuais (VMs) do Azure. Para obter mais informações, consulte O que é o Observador de Rede do Azure?
Neste artigo, aprende como instalar e desinstalar o Observador de Rede Agent para Windows e Linux. A instalação do agente não interrompe nem requer uma reinicialização da máquina virtual. Se a máquina virtual for implementada 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 com um sistema operativo suportado. Para mais informações, veja Sistemas operativos suportados.
Conectividade TCP de saída para 169.254.169.254 através de port 80 e 168.63.129.16 através de port 8037. O agente usa esses endereços IP para se comunicar com a plataforma Azure.
Conectividade com a Internet: o Observador de Rede Agent requer conectividade com a Internet para que alguns recursos funcionem corretamente. Por exemplo, requer conectividade com sua conta de armazenamento para carregar capturas de pacotes.
Uma máquina virtual do Azure (VM) com um sistema operativo suportado. Para mais informações, veja Sistemas operativos suportados.
Conectividade TCP de saída para 169.254.169.254 através de port 80 e 168.63.129.16 através de port 8037. O agente usa esses endereços IP para se comunicar com a plataforma Azure.
Conectividade com a Internet: o Observador de Rede Agent requer conectividade com a Internet para que alguns recursos funcionem corretamente. Por exemplo, requer conectividade com sua conta de armazenamento para carregar capturas de pacotes.
Azure Cloud Shell ou Azure PowerShell.
As etapas neste 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 de dentro do portal do Azure.
Você também pode instalar o Azure PowerShell localmente para executar os cmdlets. Se executares o PowerShell localmente, inicia sessão em Azure usando o cmdlet Connect-AzAccount.
Uma máquina virtual do Azure (VM) com um sistema operativo suportado. Para mais informações, veja Sistemas operativos suportados.
Conectividade TCP de saída para 169.254.169.254 através de port 80 e 168.63.129.16 através de port 8037. O agente usa esses endereços IP para se comunicar com a plataforma Azure.
Conectividade com a Internet: o Observador de Rede Agent requer conectividade com a Internet para que alguns recursos funcionem corretamente. Por exemplo, 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 de dentro do portal do Azure.
Também podes instalar CLI do Azure localmente para executar os comandos. Se executares CLI do Azure localmente, inicia sessão em Azure usando o comando az login.
Uma máquina virtual (VM) do Azure a executar um sistema operativo suportado. Para mais informações, veja Sistemas operativos suportados.
Conectividade TCP de saída para 169.254.169.254 através de port 80 e 168.63.129.16 através de port 8037. O agente usa esses endereços IP para se comunicar com a plataforma Azure.
Conectividade com a Internet: o Observador de Rede Agent requer conectividade com a Internet para que alguns recursos funcionem corretamente. Por exemplo, requer conectividade com sua conta de armazenamento para carregar capturas de pacotes.
Azure PowerShell ou CLI do Azure instalado localmente para implantar o modelo.
Sistemas operativos suportados
A extensão Observador de Rede Agent para Windows pode ser instalada em:
- Lançamentos do Windows Server 2012, 2012 R2, 2016, 2019, 2022 e 2025.
- Versões do Windows 10 e 11.
Note
Atualmente, o Nano Server não é suportado.
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 |
| Servidor SUSE Linux Enterprise (SLES) |
12 e 15 (SP2, SP3 e SP4) |
| Ubuntu |
16+ |
1 O CentOS Linux chegou ao fim de vida (EOL) em 30 de junho de 2024. Para mais informações, consulte a orientação CentOS End Of Life.
2O suporte de ciclo de vida estendido (ELS) para Oracle Linux versão 6.X terminou em 1º de julho de 2024.
3O suporte de ciclo de vida estendido (ELS) para o Red Hat Enterprise Linux 6.X terminou em 30 de junho de 2024.
Note
A monitorização do Internet Control Message Protocol (ICMP) não é atualmente suportada no Observador de Rede Agent no Oracle Linux devido a limitações conhecidas ao nível do kernel específicas da distribuição.
Esquema de extensão
O JSON a seguir mostra o esquema para a extensão Observador de Rede Agent. A extensão não requer nem suporta nenhuma configuração fornecida pelo usuário e depende de sua 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
A partir da página da máquina virtual no portal do Azure, pode ver 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ê pode usar a caixa de pesquisa para filtrá-la.
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 de VM do Observador de Rede Agent
Na página da máquina virtual no portal do Azure, você pode instalar a extensão de VM do Observador de Rede Agent seguindo estas etapas:
Em Configurações, selecione Extensões + aplicativos.
Selecione + Adicionar e procure Observador de Rede Agent e instale-o. Se a extensão já estiver instalada, você poderá vê-la na lista de extensões.
Na caixa de pesquisa de Instalar uma Extensão, introduza Observador de Rede Agent, selecione a extensão correspondente para o seu sistema operativo na lista e depois selecione Próximo.
Selecione Rever + criar e, em seguida, selecione Criar.
Utilize o cmdlet Set-AzVMExtension para instalar a extensão de VM do Agente de Observação 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'
Quando a instalação for concluída com êxito, você verá a seguinte saída:
RequestId IsSuccessStatusCode StatusCode ReasonPhrase
--------- ------------------- ---------- ------------
True OK
Utilize o comando az vm extension set para instalar a extensão Observador de Rede Agent VM 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 (modelo ARM) para instalar a extensão VM Observador de Rede Agent numa 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 Observador de Rede Agent
Na página da máquina virtual no portal do Azure, você pode desinstalar a extensão de VM do Observador de Rede Agent 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 de VM do Agente do Inspetor de Rede nomeada de forma diferente de AzureNetworkWatcherExtension.
Utilize o cmdlet Remove-AzVMExtension para remover a extensão VM do Agent Observador de Rede da máquina virtual:
# Uninstall Network Watcher Agent VM extension.
Remove-AzVMExtension -Name 'AzureNetworkWatcherExtension' -ResourceGroupName 'myResourceGroup' -VMName 'myVM'
Utilize o comando az vm extension delete para remover a extensão VM do Observador de Rede Agent da máquina virtual.
# Uninstall Network Watcher Agent VM extension.
az vm extension delete --name 'AzureNetworkWatcherExtension' --resource-group 'myResourceGroup' --vm-name 'myVM'
Perguntas mais frequentes (FAQ)
Para obter respostas às perguntas mais frequentes sobre o Observador de Rede Agent, consulte Perguntas frequentes sobre o Observador de Rede Agent.
Conteúdo relacionado
