Estensione macchina virtuale agente Network Watcher per Windows

Azure Network Watcher è un servizio di monitoraggio delle prestazioni di rete, diagnostica e analisi che consente di monitorare le reti di Azure. L'estensione macchina virtuale Network Watcher Agent è un requisito per alcune delle funzionalità di Network Watcher nelle macchine virtuali di Azure, ad esempio l'acquisizione del traffico di rete su richiesta e altre funzionalità avanzate.

Questo articolo illustra in dettaglio le piattaforme e le opzioni di distribuzione supportate per l'estensione vm dell'agente Network Watcher per Windows. L'installazione dell'agente non interrompe o richiede un riavvio della macchina virtuale. È possibile installare l'estensione nelle macchine virtuali distribuite. Se la macchina virtuale viene distribuita da un servizio di Azure, vedere la documentazione relativa al servizio per determinare se consente l'installazione di estensioni nella macchina virtuale.

Prerequisiti

Sistema operativo

L'estensione Agente Network Watcher per Windows può essere configurata per le versioni di Windows Server 2012, 2012 R2, 2016, 2019 e 2022. Attualmente Nano Server non è supportato.

Connettività Internet

Alcune funzionalità dell'agente Network Watcher richiedono che la macchina virtuale sia connessa a Internet. Senza la possibilità di stabilire connessioni in uscita, l'agente Network Watcher non può caricare acquisizioni di pacchetti nell'account di archiviazione. Per altre informazioni, vedere la documentazione di Network Watcher.

Schema dell'estensione

Lo schema JSON seguente illustra lo schema dell'estensione Network Watcher Agent. L'estensione non richiede o supporta impostazioni fornite dall'utente e si basa sulla configurazione predefinita.

{
    "type": "extensions",
    "name": "Microsoft.Azure.NetworkWatcher",
    "apiVersion": "[variables('apiVersion')]",
    "location": "[resourceGroup().location]",
    "dependsOn": [
        "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
    ],
    "properties": {
        "publisher": "Microsoft.Azure.NetworkWatcher",
        "type": "NetworkWatcherAgentWindows",
        "typeHandlerVersion": "1.4",
        "autoUpgradeMinorVersion": true
    }
}

Valori delle proprietà

Nome Valore/Esempio
apiVersion 2022-11-01
publisher Microsoft.Azure.NetworkWatcher
type NetworkWatcherAgentWindows
typeHandlerVersion 1.4

Distribuzione del modello

È possibile distribuire le estensioni di macchine virtuali di Azure con un modello di Azure Resource Manager usando lo schema JSON precedente.

Distribuzione PowerShell

Usare il comando Set-AzVMExtension per distribuire l'estensione macchina virtuale dell'agente Network Watcher in una macchina virtuale esistente:

Set-AzVMExtension `
  -ResourceGroupName "myResourceGroup1" `
  -Location "WestUS" `
  -VMName "myVM1" `
  -Name "networkWatcherAgent" `
  -Publisher "Microsoft.Azure.NetworkWatcher" `
  -Type "NetworkWatcherAgentWindows" `
  -TypeHandlerVersion "1.4"

Risoluzione dei problemi

I dati sullo stato delle distribuzioni dell'estensione possono essere recuperati nel portale di Azure e da PowerShell. Per visualizzare lo stato di distribuzione delle estensioni per una determinata macchina virtuale, eseguire il comando seguente tramite il modulo di Azure PowerShell:

Get-AzVMExtension -ResourceGroupName myResourceGroup1 -VMName myVM1 -Name networkWatcherAgent

L'output dell'esecuzione dell'estensione viene registrato nei file presenti nella directory seguente:

C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.NetworkWatcher.NetworkWatcherAgentWindows\