Gérer l’extension de machine virtuelle de l’agent Network Watcher

L’extension de machine virtuelle de l’agent Network Watcher est obligatoire pour certaines fonctionnalités d’Azure Network Watcher qui capturent le trafic afin de diagnostiquer et de superviser les machines virtuelles Azure. Pour plus d’informations, consultez Présentation d’Azure Network Watcher.

Dans cet article, vous apprenez comment installer, mettre à jour et désinstaller Network Watcher Agent pour Windows et Linux. L’installation de l’agent n’est pas perturbante et ne nécessite pas le redémarrage de la machine virtuelle. Si la machine virtuelle est déployée par un service Azure, vérifiez la documentation du service pour déterminer s’il permet d’installer des extensions dans la machine virtuelle.

Note

L'extension Network Watcher Agent n'est pas prise en charge sur les clusters AKS.

Prerequisites

  • Une machine virtuelle Azure (VM) fonctionnant sous un système d’exploitation pris en charge. Pour plus d’informations, voir Systèmes d’exploitation pris en charge.

  • Connectivité TCP sortante vers 169.254.169.254 sur port 80 et 168.63.129.16 sur port 8037. L’agent utilise ces adresses IP pour communiquer avec la plateforme Azure.

  • Connectivité Internet : Network Watcher Agent nécessite une connectivité internet pour que certaines fonctionnalités fonctionnent correctement. Par exemple, il nécessite une connectivité à votre compte de stockage pour charger des captures de paquets.

Systèmes d'exploitation pris en charge

Vous pouvez installer l’extension Network Watcher Agent pour Windows sur les systèmes d’exploitation suivants :

  • Versions de Windows Server 2012, 2012 R2, 2016, 2019, 2022 et 2025.
  • Versions de Windows 10 et 11.

Note

Actuellement, Nano Server n’est pas pris en charge.

Vous pouvez installer l’extension Network Watcher Agent pour Linux sur les distributions Linux suivantes :

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

1 CentOS Linux a atteint sa fin de vie (EOL) le 30 juin 2024. Pour plus d’informations, consultez les conseils sur la fin de vie centOS.

2La prise en charge du cycle de vie étendu (ELS) pour Oracle Linux version 6.X a pris fin le 1er juillet 2024.

3La prise en charge du cycle de vie étendu (ELS) pour Red Hat Enterprise Linux 6.X a pris fin le 30 juin 2024.

Note

La surveillance du protocole Internet Control Message Protocol (ICMP) n'est actuellement pas prise en charge dans le Network Watcher Agent sur Oracle Linux en raison de limitations connues au niveau du noyau propres à la distribution.

Schéma d’extensions

Le JSON suivant illustre le schéma de l’extension Agent Network Watcher. L’extension ne nécessite ni ne prend en charge aucun réglage fourni par l’utilisateur, et elle repose sur sa configuration par défaut.

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

Lister les extensions installées

Depuis la page de la machine virtuelle du portail Azure, vous pouvez consulter les extensions installées en suivant ces étapes :

  1. Sous Paramètres, sélectionnez Extensions + applications.

  2. Sous l’onglet Extensions, vous pouvez voir toutes les extensions installées sur la machine virtuelle. Si la liste est longue, utilisez la barre de recherche pour filtrer la liste.

    Capture d’écran montrant comment afficher les extensions installées sur une machine virtuelle dans le Portail Azure.

    Capture d’écran montrant comment afficher les extensions installées sur une machine virtuelle dans le Portail Azure.

Installer l’extension de machine virtuelle de l’agent Network Watcher

À partir de la page de machine virtuelle dans le Portail Azure, vous pouvez installer l’extension de machine virtuelle de l’agent Network Watcher en suivant les étapes suivantes :

  1. Sous Paramètres, sélectionnez Extensions + applications.

  2. Sélectionnez + Ajouter, cherchez Network Watcher Agent, et installez-le. Si l’extension est déjà installée, vous pouvez la voir dans la liste des extensions.

    Capture d’écran montrant la page des extensions de la machine virtuelle dans le Portail Azure.

  3. Dans la barre de recherche Installer une extension, saisissez Network Watcher Agent, sélectionnez l’extension correspondante à votre système d’exploitation dans la liste, puis sélectionnez Suivant.

    Capture d’écran montrant comment installer l’agent Network Watcher pour Windows dans le Portail Azure.

    Capture d’écran illustrant comment installer l’agent Network Watcher pour Linux dans le Portail Azure.

  4. Sélectionnez Vérifier + créer, puis sélectionnez Créer.

Mise à jour de l’extension VM Network Watcher Agent

Vérifier la version de votre extension

Vous pouvez vérifier la version de votre extension à l’aide du portail Azure, d’Azure CLI ou de PowerShell.

  1. Allez dans Extensions + applications de votre VM dans le portail Azure.

  2. Dans la liste des extensions, vérifiez la colonne Version pour AzureNetworkWatcherExtension. Si une version plus récente est disponible, la colonne Dernière version s’affiche (Mise à jour disponible).

    Capture d’écran qui montre l’extension Network Watcher.

Note

La version la plus récente de l’extension Network Watcher est 1.4.4011.1.

Activer la mise à jour automatique

La mise à jour automatique permet à la plateforme Azure de mettre à jour l’extension vers la dernière version sans intervention manuelle. Utilisez les étapes suivantes pour vérifier si la mise à niveau automatique est activée, et pour l’activer si ce n’est pas le cas.

  1. Dans les paramètres de votre VM sur le portail Azure, sélectionnez Extensions + applications.

  2. Sélectionnez AzureNetworkWatcherExtension dans la liste des extensions, et vérifiez la colonne État de mise à niveau automatique .

  3. Si l’affichage est désactivé, sélectionnez Activer la mise à jour automatique depuis la barre d’outils.

    Capture d’écran qui montre l’extension Network Watcher.

  4. Sélectionnez Oui pour confirmer.

    Capture d’écran qui montre la boîte de confirmation pour activer la mise à jour automatique sur l’extension Network Watcher.

Note

Après avoir activé la mise à jour automatique, Azure met à jour l’extension automatiquement sans avoir à redémarrer la machine virtuelle. Ce processus peut prendre jusqu’à 30 jours après la sortie d’une nouvelle version.

Mettre à jour manuellement

  1. Dans les paramètres de votre VM sur le portail Azure, sélectionnez Extensions + applications.

  2. Sélectionnez AzureNetworkWatcherExtension dans la liste des extensions, puis sélectionnez Mettre à jour dans la barre d’outils.

    Capture d’écran qui montre l’extension Network Watcher.

  3. Sélectionnez Oui pour confirmer.

    Capture d’écran qui montre la boîte de confirmation pour la mise à jour de l’extension Network Watcher vers la dernière version.

  4. Lorsque la mise à jour se termine, les colonnes Version et Dernière Version affichent le même numéro de version.

    Capture d'écran qui montre l'extension Network Watcher après sa mise à jour vers la dernière version.

Si la mise à jour ne s’applique pas à la dernière version, supprimez l’extension et réinstallez-la :

  1. Sélectionnez AzureNetworkWatcherExtension dans la liste des extensions, puis sélectionnez Désinstaller.
  2. Sélectionnez + Ajouter, cherchez Network Watcher Agent, puis réinstallez-le. La plateforme installe automatiquement la dernière version disponible. Pour plus d’informations, voir Installer l’extension VM de Network Watcher Agent.

Mise à jour à grande échelle avec un script PowerShell

Si vous avez de gros déploiements, utilisez un script PowerShell pour mettre à jour plusieurs machines virtuelles dans un abonnement en même temps. Le script suivant met à jour l’extension Network Watcher sur toutes les machines virtuelles obsolètes dans un 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"
}

Désinstaller l’extension de machine virtuelle de l’agent Network Watcher

À partir de la page de machine virtuelle dans le Portail Azure, vous pouvez désinstaller l’extension de machine virtuelle de l’agent Network Watcher en suivant les étapes suivantes :

  1. Sous Paramètres, sélectionnez Extensions + applications.

  2. Sélectionnez AzureNetworkWatcherExtension dans la liste des extensions, puis sélectionnez Désinstaller.

    Capture d’écran montrant comment désinstaller l’agent Network Watcher pour Windows dans le Portail Azure.

    Capture d’écran illustrant comment désinstaller l’agent Network Watcher pour Linux dans le Portail Azure.

    Note

    Il est possible que vous voyiez l’extension de machine virtuelle de l’agent Network Watcher nommée différemment d’AzureNetworkWatcherExtension.

Questions fréquemment posées (FAQ)

Pour obtenir des réponses aux questions les plus fréquemment posées sur Network Watcher Agent, consultez la FAQ Network Watcher Agent.

Contenu connexe

  • Last updated on