Hantera tillägget Network Watcher Agent för virtuell dator

Tillägget Network Watcher Agent för virtuella datorer är ett krav för några av Azure Network Watcher-funktionerna som samlar in nätverkstrafik för att diagnostisera och övervaka virtuella Azure-datorer (VM). Mer information finns i Vad är Azure Network Watcher?

I den här artikeln lär du dig hur du installerar, uppdaterar och avinstallerar Network Watcher Agent för Windows och Linux. Installationen av agenten stör inte eller kräver en omstart av den virtuella datorn. Om den virtuella maskinen distribueras av en Azure-tjänst, kontrollera dokumentationen för tjänsten för att avgöra om tjänsten tillåter installation av tillägg i den virtuella maskinen.

Note

Network Watcher Agent-tillägget stöds inte på AKS-kluster.

Förutsättningar

  • En Azure-virtuell maskin (VM) som kör ett stödd operativsystem. För mer information, se Stödda operativsystem.

  • Utgående TCP-anslutning till 169.254.169.254 över port 80 och 168.63.129.16 över port 8037. Agenten använder dessa IP-adresser för att kommunicera med Azure-plattformen.

  • Internetuppkoppling: Network Watcher Agent kräver internetuppkoppling för att vissa funktioner ska fungera korrekt. Det kräver till exempel anslutning till ditt lagringskonto för att ladda upp paketinsamlingar.

Operativsystem som stöds

Du kan installera Network Watcher Agent-tillägget för Windows på följande operativsystem:

  • Windows Server 2012-, 2012 R2-, 2016-, 2019-, 2022- och 2025-versioner.
  • Windows 10- och 11-versioner.

Note

Nano Server stöds för närvarande inte.

Du kan installera Network Watcher Agent-tillägget för Linux på följande Linux-distributioner:

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

1 CentOS Linux nådde slutet av sin livscykel (EOL) den 30 juni 2024. Mer information finns i CentOS End Of Life-vägledningen.

2Stödet för utökad livscykel (ELS) för Oracle Linux version 6.X upphörde den 1 juli 2024.

3ELS-stöd (Extended Life Cycle) för Red Hat Enterprise Linux 6.X upphörde den 30 juni 2024.

Note

Internet Control Message Protocol (ICMP)-övervakning stöds för närvarande inte i Network Watcher Agent på Oracle Linux på grund av kända kärnbegränsningar specifika för distributionen.

Tilläggsschema

Följande JSON visar schemat för Network Watcher Agent-tillägget. Tillägget kräver eller stöder inga användaranpassade inställningar och förlitar sig på sin standardkonfiguration.

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

Visa en lista över installerade tillägg

Från sidan för virtuella maskiner i Azure-portalen kan du se de installerade tilläggen genom att följa dessa steg:

  1. Under Inställningar väljer du Tillägg + program.

  2. På fliken Tillägg kan du se alla installerade tillägg på den virtuella datorn. Om listan är lång, använd sökrutan för att filtrera listan.

    Skärmbild som visar hur du visar installerade tillägg på en virtuell dator i Azure Portal.

    Skärmbild som visar hur du visar installerade tillägg på en virtuell dator i Azure Portal.

Installera vm-tillägget för Network Watcher Agent

Från sidan för den virtuella datorn i Azure Portal kan du installera tillägget Network Watcher Agent VM genom att följa dessa steg:

  1. Under Inställningar väljer du Tillägg + program.

  2. Välj + Lägg till, sök efter Network Watcher Agent och installera det. Om tillägget redan är installerat kan du se det i listan över tillägg.

    Skärmbild som visar den virtuella datorns tilläggssida i Azure Portal.

  3. I sökrutan för Installera ett tillägg, skriv in Network Watcher Agent, välj motsvarande tillägg för ditt operativsystem från listan och välj sedan Nästa.

    Skärmbild som visar hur du installerar Network Watcher Agent för Windows i Azure Portal.

    Skärmbild som visar hur du installerar Network Watcher Agent för Linux i Azure Portal.

  4. Välj Granska och skapa och klicka sedan på Skapa.

Uppdatera Network Watcher Agent VM-tillägget

Kontrollera tilläggsversionen

Du kan kontrollera tilläggsversionen med hjälp av Azure Portal, Azure CLI eller PowerShell.

  1. Gå till Extensions + applikationer i din VM i Azure-portalen.

  2. I listan över tillägg, kontrollera kolumnen Version för AzureNetworkWatcherExtension. Om en nyare version finns tillgänglig visas kolumnen Senaste versionen(Uppdatering tillgänglig).

    Skärmdump som visar Network Watcher-tillägget.

Note

Den senaste versionen av Network Watcher-tillägget är 1.4.4011.1.

Aktivera automatisk uppgradering

Automatisk uppgradering låter Azure-plattformen uppdatera tillägget till den senaste versionen utan manuell inblandning. Använd följande steg för att kontrollera om automatisk uppgradering är aktiverad, och för att aktivera den om den inte är det.

  1. Under inställningar för din VM i Azure-portalen, välj Tillägg + applikationer.

  2. Välj AzureNetworkWatcherExtension från listan över tillägg och kontrollera kolumnen Automatisk uppgraderingsstatus .

  3. Om det visas inaktiverat, välj Aktivera automatisk uppgradering i verktygsfältet.

    Skärmdump som visar Network Watcher-tillägget.

  4. Välj Ja för att bekräfta.

    Skärmdump som visar bekräftelsedialogen för att aktivera automatisk uppgradering i Network Watcher-tillägget.

Note

Efter att du aktiverat automatisk uppgradering uppdaterar Azure tillägget automatiskt utan att behöva starta om den virtuella maskinen. Denna process kan ta upp till 30 dagar efter att en ny version släppts.

Uppdatera manuellt

  1. Under inställningar för din VM i Azure-portalen, välj Tillägg + applikationer.

  2. Välj AzureNetworkWatcherExtension från listan över tillägg och välj sedan Uppdatera från verktygsfältet.

    Skärmdump som visar Network Watcher-tillägget.

  3. Välj Ja för att bekräfta.

    Skärmdump som visar bekräftelsedialogen för att uppdatera Network Watcher-tillägget till den senaste versionen.

  4. När uppdateringen är klar visar kolumnerna Version och Senaste Version samma versionsnummer.

    Skärmdump som visar Network Watcher-tillägget efter att den uppdaterats till senaste versionen.

Om uppdateringen inte tillämpar den senaste versionen, ta bort tillägget och installera det igen:

  1. Välj AzureNetworkWatcherExtension i listan över tillägg och välj sedan Avinstallera.
  2. Välj + Add, sök efter Network Watcher Agent och installera den igen. Plattformen installerar automatiskt den senaste tillgängliga versionen. För mer information, se Install Network Watcher Agent VM-tillägget.

Uppdatera i stor skala med ett PowerShell-skript

Om du har stora distributioner, använd ett PowerShell-skript för att uppdatera flera virtuella maskiner i en prenumeration samtidigt. Följande skript uppdaterar Network Watcher-tillägget på alla föråldrade VM:er i en prenumeration:

<#
    .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"
}

Avinstallera VM-tillägget för Network Watcher Agent

Från sidan för den virtuella datorn i Azure Portal kan du avinstallera tillägget Network Watcher Agent VM genom att följa dessa steg:

  1. Under Inställningar väljer du Tillägg + program.

  2. Välj AzureNetworkWatcherExtension i listan över tillägg och välj sedan Avinstallera.

    Skärmbild som visar hur du avinstallerar Network Watcher Agent för Windows i Azure Portal.

    Skärmbild som visar hur du avinstallerar Network Watcher Agent för Linux i Azure Portal.

    Note

    Du kan se VM-tillägget Network Watcher Agent med ett annat namn än AzureNetworkWatcherExtension.

Vanliga frågor

För att få svar på de vanligaste frågorna om Network Watcher Agent, se Network Watcher Agent FAQ.

Relaterat innehåll

  • Uppdaterades senast