Beheer de Network Watcher Agent virtuele machine-extensie

De Virtual Machine-extensie Network Watcher Agent is een vereiste voor sommige Azure Network Watcher-functies die netwerkverkeer vastleggen om virtuele Azure-machines (VM's) te diagnosticeren en te bewaken. Zie Wat is Azure Network Watcher voor meer informatie?

In dit artikel leer je hoe je Network Watcher Agent voor Windows en Linux installeert, bijwerkt en verwijdert. De installatie van de agent wordt niet onderbroken en vereist geen herstart van de virtuele machine. Als de virtuele machine wordt uitgerold door een Azure-service, controleer dan de documentatie van de dienst om te bepalen of de service het installeren van extensies in de virtuele machine toestaat.

Note

Network Watcher Agent-extensie wordt niet ondersteund op AKS-clusters.

Prerequisites

  • Een Azure virtuele machine (VM) die een ondersteund besturingssysteem draait. Voor meer informatie, zie Ondersteunde besturingssystemen.

  • Uitgaande TCP-connectiviteit naar 169.254.169.254 via port 80 en 168.63.129.16 via port 8037. De agent gebruikt deze IP-adressen om te communiceren met het Azure-platform.

  • Internetverbinding: Network Watcher Agent vereist internetverbinding om sommige functies goed te laten werken. Er is bijvoorbeeld verbinding met uw opslagaccount nodig om pakketopnamen te uploaden.

Ondersteunde besturingssystemen

Je kunt de Network Watcher Agent-extensie voor Windows installeren op de volgende besturingssystemen:

  • Windows Server 2012, 2012 R2, 2016, 2019, 2022 en 2025 releases.
  • Windows 10- en 11-versies.

Note

Op dit moment wordt Nano Server niet ondersteund.

Je kunt de Network Watcher Agent-extensie voor Linux installeren op de volgende Linux-distributies:

Distribution Versie
AlmaLinux 9.2
Azure Linux 2.0
CentOS 1 6.10 en 7
Debian 7 en 8
openSUSE Leap 42.3+
Oracle Linux 6.10 2, 7, 8 en 9+
Red Hat Enterprise Linux (RHEL) 6.10 3, 7, 8 en 9.2
Rocky Linux 9.1
SUSE Linux Enterprise Server (SLES) 12 en 15 (SP2, SP3 en SP4)
Ubuntu 16+

1 CentOS Linux bereikte zijn einde van levensduur (EOL) op 30 juni 2024. Voor meer informatie, zie de CentOS End Of Life guidance.

2De ondersteuning voor de verlengde levenscyclus (ELS) voor Oracle Linux versie 6.X is op 1 juli 2024 beëindigd.

3De ondersteuning voor de verlengde levenscyclus (ELS) voor Red Hat Enterprise Linux 6.X is op 30 juni 2024 beëindigd.

Note

Internet Control Message Protocol (ICMP) monitoring wordt momenteel niet ondersteund in de Network Watcher Agent op Oracle Linux vanwege bekende kernel-niveau beperkingen die specifiek zijn voor de distributie.

Extensieschema

In de volgende JSON ziet u het schema voor de Network Watcher Agent-extensie. De extensie vereist of ondersteunt geen door de gebruiker geleverde instellingen en vertrouwt op de standaardconfiguratie.

{
    "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"
    }
}

Geïnstalleerde extensies weergeven

Vanaf de virtuele machinepagina in het Azure-portaal kun je de geïnstalleerde extensies bekijken door deze stappen te volgen:

  1. Selecteer onder Instellingen de optie Extensies en toepassingen.

  2. Op het tabblad Extensies kunt u alle geïnstalleerde extensies op de virtuele machine zien. Als de lijst lang is, gebruik dan het zoekvak om de lijst te filteren.

    Schermafbeelding die laat zien hoe u geïnstalleerde extensies op een VM in de Azure Portal kunt bekijken.

    Schermafbeelding die laat zien hoe u geïnstalleerde extensies op een VM in de Azure Portal kunt bekijken.

Installeer de VM-extensie van Network Watcher Agent

Op de pagina virtuele machine in Azure Portal kunt u de VM-extensie Network Watcher Agent installeren door de volgende stappen uit te voeren:

  1. Selecteer onder Instellingen de optie Extensies en toepassingen.

  2. Selecteer + Toevoegen, zoek naar Network Watcher Agent en installeer het. Als de extensie al is geïnstalleerd, kunt u deze zien in de lijst met extensies.

    Schermafbeelding waarmee de pagina met extensies van de VM in de Azure Portal wordt weergegeven.

  3. In het zoekvak van Install an Extension voer je Network Watcher Agent in, selecteer je de bijbehorende extensie voor je besturingssysteem uit de lijst en selecteer je vervolgens Volgende.

    Schermopname die laat zien hoe u Network Watcher Agent voor Windows installeert in Azure Portal.

    Schermafbeelding die laat zien hoe u Network Watcher Agent voor Linux installeert in de Azure Portal.

  4. Selecteer Beoordelen en maken en selecteer vervolgens Maken.

Update de VM-extensie van Network Watcher Agent

Controleer uw extensieversie

U kunt uw extensieversie controleren met behulp van Azure Portal, De Azure CLI of PowerShell.

  1. Ga naar Extensions + applicaties van je VM in het Azure-portaal.

  2. Controleer in de lijst met extensies de kolom Versie voor AzureNetworkWatcherExtension. Als er een nieuwere versie beschikbaar is, toont de kolom Nieuwste Versie(Update beschikbaar).

    Schermafbeelding waarop de Network Watcher-extensie wordt weergegeven.

Note

De nieuwste versie van de Network Watcher-extensie is 1.4.4011.1.

Schakel automatische upgrade in

Automatische upgrade stelt het Azure-platform in staat de extensie zonder handmatige interventie naar de nieuwste versie te updaten. Gebruik de volgende stappen om te controleren of automatische upgrade is ingeschakeld, en om het in te schakelen als dat niet zo is.

  1. Selecteer onder Instellingen van je VM in het Azure-portaal Extensies + applicaties.

  2. Selecteer AzureNetworkWatcherExtension uit de lijst met extensies en vink de kolom Automatische upgradestatus aan.

  3. Als het Uitgeschakeld aangeeft, selecteer dan automatische upgrade inschakelen in de werkbalk.

    Schermopname van de Network Watcher-extensie.

  4. Selecteer Ja om te bevestigen.

    Screenshot die het bevestigingsvenster toont voor het inschakelen van automatische upgrade op de Network Watcher-extensie.

Note

Nadat je automatische upgrade hebt ingeschakeld, werkt Azure de extensie automatisch bij zonder dat je de virtuele machine hoeft te herstarten. Dit proces kan tot 30 dagen duren nadat een nieuwe versie is uitgebracht.

Handmatig bijwerken

  1. Selecteer onder Instellingen van je VM in het Azure-portaal Extensies + applicaties.

  2. Selecteer AzureNetworkWatcherExtension uit de lijst met extensies en selecteer vervolgens Update in de werkbalk.

    Schermafbeelding van de Network Watcher-extensie.

  3. Selecteer Ja om te bevestigen.

    Screenshot die het bevestigingsvenster toont voor het updaten van de Network Watcher-extensie naar de nieuwste versie.

  4. Wanneer de update is voltooid, tonen de kolommen Versie en Nieuwste Versie hetzelfde versienummer.

    Screenshot die de Network Watcher-extensie toont nadat deze is bijgewerkt naar de nieuwste versie.

Als de update niet de nieuwste versie toepast, verwijder dan de extensie en installeer hem opnieuw:

  1. Selecteer AzureNetworkWatcherExtension in de lijst met extensies en selecteer vervolgens Verwijderen.
  2. Selecteer + Toevoegen, zoek naar Network Watcher Agent en installeer het opnieuw. Het platform installeert automatisch de meest meest recente beschikbare versie. Voor meer informatie, zie de VM-extensie Install Network Watcher Agent VM.

Werk op schaal bij met een PowerShell-script

Als je grote deployments hebt, gebruik dan een PowerShell-script om meerdere VM's in een abonnement tegelijk bij te werken. Het volgende script werkt de Network Watcher-extensie bij op alle verouderde VM's in een abonnement:

<#
    .SYNOPSIS
    This script scans all VMs in the provided subscription and upgrades any out-of-date AzureNetworkWatcherExtensions to the latest available version.
    .DESCRIPTION
    This script is a no-op if AzureNetworkWatcherExtensions are already up to date.
    Requires Azure PowerShell 4.2 or higher to be installed.
    .EXAMPLE
    .\UpdateVMAgentsInSub.ps1 -SubID aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e -NoUpdate
#>

[CmdletBinding()]
param(
    [Parameter(Mandatory=$true)]
    [string] $SubID,
    [Parameter(Mandatory=$false)]
    [Switch] $NoUpdate = $false
)
function Get-LatestExtensionVersion($location, $extensionType)
{
    $latestImage = Get-AzVMExtensionImage -Location $location -PublisherName "Microsoft.Azure.NetworkWatcher" -Type $extensionType |
        Sort-Object -Property { [Version]$_.Version } -Descending |
        Select-Object -First 1
    return $latestImage.Version
}
Write-Host "Scanning all VMs in the subscription: $($SubID)"
Set-AzContext -SubscriptionId $SubID
$vms = Get-AzVM
$foundVMs = $false
Write-Host "Starting VM search, this may take a while"
foreach ($vmName in $vms)
{
    # Get Detailed VM info
    $vm = Get-AzVM -ResourceGroupName $vmName.ResourceGroupName -Name $vmName.name -Status
    $isitWindows = $vm.OsName -like "*Windows*"
    $type = if ($isitWindows) { "NetworkWatcherAgentWindows" } else { "NetworkWatcherAgentLinux" }
    $latestVersion = Get-LatestExtensionVersion -location $vmName.Location -extensionType $type

    foreach ($extension in $vm.Extensions)
    {
        if ($extension.Name -eq "AzureNetworkWatcherExtension")
        {
            if ([Version]$extension.TypeHandlerVersion -lt [Version]$latestVersion)
            {
                $foundVMs = $true
                if (-not ($NoUpdate))
                {
                    Write-Host "Found VM that needs to be updated: subscriptions/$($SubID)/resourceGroups/$($vm.ResourceGroupName)/providers/Microsoft.Compute/virtualMachines/$($vm.Name) -> Updating to $latestVersion " -NoNewline
                    Remove-AzVMExtension -ResourceGroupName $vm.ResourceGroupName -VMName $vm.Name -Name "AzureNetworkWatcherExtension" -Force
                    Write-Host "... " -NoNewline
                    Set-AzVMExtension -ResourceGroupName $vm.ResourceGroupName -Location $vmName.Location -VMName $vm.Name -Name "AzureNetworkWatcherExtension" -Publisher "Microsoft.Azure.NetworkWatcher" -Type $type -TypeHandlerVersion $latestVersion
                    Write-Host "Done"
                }
                else
                {
                    Write-Host "Found $(if ($isitWindows) {"Windows"} else {"Linux"}) VM that needs to be updated to $($latestVersion): subscriptions/$($SubID)/resourceGroups/$($vm.ResourceGroupName)/providers/Microsoft.Compute/virtualMachines/$($vm.Name)"
                }
            }
        }
    }
}

if ($foundVMs)
{
    Write-Host "Finished $(if ($NoUpdate) {"searching"} else {"updating"}) out of date AzureNetworkWatcherExtension on VMs"
}
else
{
    Write-Host "All AzureNetworkWatcherExtensions up to date"
}

De VM-extensie van Network Watcher Agent verwijderen

Vanaf de pagina van de virtuele machine in de Azure Portal kunt u de VM-extensie van Network Watcher Agent verwijderen door de volgende stappen uit te voeren:

  1. Selecteer onder Instellingen de optie Extensies en toepassingen.

  2. Selecteer AzureNetworkWatcherExtension in de lijst met extensies en selecteer vervolgens Verwijderen.

    Schermopname die laat zien hoe u Network Watcher Agent voor Windows verwijdert in Azure Portal.

    Schermafbeelding die laat zien hoe u Network Watcher Agent voor Linux verwijdert in de Azure Portal.

    Note

    Mogelijk ziet u de VM-extensie Network Watcher Agent anders genoemd dan AzureNetworkWatcherExtension.

Veelgestelde vragen (FAQ)

Voor antwoorden op de meest gestelde vragen over Network Watcher Agent, zie Network Watcher Agent FAQ.

Verwante onderwerpen

  • Laatst bijgewerkt om