Installer et gérer l’agent Azure Monitor

Cet article décrit les différentes méthodes permettant d’installer, de désinstaller, de mettre à jour et de configurer l’agent Azure Monitor sur des machines virtuelles Azure, des groupes identiques et des serveurs avec Azure Arc.

Important

L’agent Azure Monitor nécessite au moins une règle de collecte de données (DCR) pour commencer à collecter des données après son installation sur la machine cliente. Selon la méthode d’installation que vous utilisez, une DCR peut ou non être créée automatiquement. Si ce n’est pas le cas, vous devez configurer la collecte de données en suivant l’aide dans Collecter des données avec l’agent Azure Monitor.

Prérequis

Consultez les articles suivants pour connaître les prérequis et autres spécifications de l’agent Azure Monitor :

• Systèmes d’exploitation et environnements pris en charge par l’agent Azure Monitor
• Conditions requises pour l’agent Azure Monitor
• Configuration réseau de l’agent Azure Monitor

Important

L’installation, la mise à niveau ou la désinstallation de l’agent Azure Monitor ne nécessitent pas de redémarrage de la machine.

Options d'installation

Le tableau suivant répertorie les différentes options d’installation de l’agent Azure Monitor sur des machines virtuelles Azure et des serveurs avec Azure Arc. L'agent Azure Arc doit être installé sur les machines qui ne se trouvent pas dans Azure avant de pouvoir installer l’agent Azure Monitor.

Méthode d’installation	Description
Extension de machine virtuelle	Utilisez l’une des méthodes ci-dessous pour utiliser l’infrastructure d’extension Azure et installer l’agent. Cette méthode ne crée pas de DCR. Vous devez donc en créer au moins une et l’associer à l’agent avant que la collecte de données ne commence.
Créer une DCR	Lorsque vous créez une DCR dans le portail Azure, l’agent Azure Monitor est installé sur les machines ajoutées en tant que ressources de la DCR. L’agent commence à collecter les données définies dans la DCR immédiatement.
VM Insights	Lorsque vous activez les aperçus de machine virtuelle sur une machine, l'agent Azure Monitor est installé et une DCR est créée qui collecte un ensemble prédéfini de données. Vous ne devez pas modifier cette DCR, mais vous pouvez créer des DCR supplémentaires pour collecter d’autres données.
Container Insights	Lorsque vous activez Container Insights sur un cluster Kubernetes, une version conteneurisée de l'agent Azure Monitor est installée dans le cluster et une DCR est créée qui commence à collecter immédiatement des données. Vous pouvez modifier cette DCR en utilisant l’aide dans Configurer la collecte de données et l’optimisation des coûts dans Container Insights à l’aide d’une règle de collecte de données.
Programme d’installation client	Installe l’agent à l’aide d’un programme d’installation MSI Windows pour les clients Windows 10 et Windows 11.
Azure Policy	Utilisez Azure Policy pour installer automatiquement l’agent sur des machines virtuelles Azure et des serveurs avec Azure Arc, et les associer automatiquement aux DCR requises.

Remarque

Pour envoyer des données entre locataires, vous devez d’abord activer Azure Lighthouse. Le clonage d’une machine avec l’agent Azure Monitor installé n’est pas pris en charge. La bonne pratique dans ce cas est l’utilisation d’Azure Policy ou d’un outil Infrastructure en tant que code pour déployer AMA à grande échelle.

Installer l’extension de l’agent

Cette section fournit des détails sur l’installation de l’agent Azure Monitor à l’aide de l’extension de machine virtuelle.

Portail

Utilisez l’aide dans Collecter des données avec l’agent Azure Monitor pour installer l’agent à l’aide du portail Azure et créer une DCR pour collecter des données.

PowerShell

Vous pouvez installer l’agent Azure Monitor sur des machines virtuelles Azure et sur des serveurs avec Azure Arc à l’aide de la commande PowerShell permettant d’ajouter une extension de machine virtuelle.

Machines virtuelles Azure

Utilisez les commandes PowerShell suivantes pour installer l’agent Azure Monitor sur des machines virtuelles Azure. Choisissez la commande appropriée en fonction de la méthode d’authentification choisie.

• Windows

  ## User-assigned managed identity
  Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
  
  ## System-assigned managed identity
  Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
  

• Linux

  ## User-assigned managed identity
  Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
  
  ## System-assigned managed identity
  Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
  

Groupe identique de machines virtuelles Azure

Utilisez l’applet de commande PowerShell Add-AzVmssExtension pour installer l’agent Azure Monitor sur des groupes de machines virtuelles identiques Azure.

Serveurs avec Azure Arc

Utilisez les commandes PowerShell suivantes pour installer l’agent Azure Monitor sur des serveurs avec Azure Arc.

• Windows

  New-AzConnectedMachineExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-location> -EnableAutomaticUpgrade
  

• Linux

  New-AzConnectedMachineExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-location> -EnableAutomaticUpgrade
  

Azure CLI

Vous pouvez installer l’agent Azure Monitor sur des machines virtuelles Azure et sur des serveurs avec Azure Arc à l’aide de la commande Azure CLI permettant d’ajouter une extension de machine virtuelle.

Machines virtuelles Azure

Utilisez les commandes CLI suivantes pour installer l’agent Azure Monitor sur des machines virtuelles Azure. Choisissez la commande appropriée en fonction de la méthode d’authentification choisie.

Identité managée affectée par l’utilisateur

• Windows

  az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
  

• Linux

  az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
  

Identité managée affectée par le système

• Windows

  az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true
  

• Linux

  az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true
  

Groupe identique de machines virtuelles Azure

Utilisez l’applet de commande CLI az vmss extension set pour installer l’agent Azure Monitor sur des groupes de machines virtuelles identiques Azure.

Serveurs avec Azure Arc

Utilisez les commandes CLI suivantes pour installer l’agent Azure Monitor sur des serveurs avec Azure Arc.

• Windows

  az connectedmachine extension create --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --location <arc-server-location> --enable-auto-upgrade true
  

• Linux

  az connectedmachine extension create --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --location <arc-server-location> --enable-auto-upgrade true
  

modèle Azure Resource Manager

Vous pouvez utiliser des modèles Resource Manager pour installer l’agent Azure Monitor sur des machines virtuelles Azure et sur des serveurs avec Azure Arc, ainsi que pour créer une association avec des règles de collecte de données. Vous devez créer une règle de collecte des données avant de créer l’association.

Obtenez des exemples de modèles pour l’installation de l’agent et la création de l’association à partir des ressources suivantes :

• Modèle d’installation de l’agent Azure Monitor (Azure et Azure Arc)
• Modèle de création d’une association avec une règle de collecte de données

Installez les modèles à l’aide de n’importe quelle méthode de déploiement pour les modèles Resource Manager comme les commandes suivantes.

• PowerShell

  New-AzResourceGroupDeployment -ResourceGroupName "<resource-group-name>" -TemplateFile "<template-filename.json>" -TemplateParameterFile "<parameter-filename.json>"
  

• Azure CLI

  az deployment group create --resource-group "<resource-group-name>" --template-file "<path-to-template>" --parameters "@<parameter-filename.json>"
  

Désinstaller l’interface

Portail

Pour désinstaller l’agent Azure Monitor à l’aide du portail Azure, accédez à votre machine virtuelle, groupe identique ou serveur avec Azure Arc. Sélectionnez l’onglet Extensions, puis sélectionnez AzureMonitorWindowsAgent ou AzureMonitorLinuxAgent. Dans la boîte de dialogue qui s’ouvre, sélectionnez Désinstaller.

PowerShell

Désinstallation des machines virtuelles Azure

Utilisez les commandes PowerShell suivantes pour désinstaller l’agent Azure Monitor de machines virtuelles Azure.

• Windows

  Remove-AzVMExtension -Name AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> 
  

• Linux

  Remove-AzVMExtension -Name AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> 
  

Désinstaller sur un groupe de machines virtuelles identiques Azure

Utilisez l’applet de commande PowerShell Remove-AzVmssExtension pour désinstaller l’agent Azure Monitor sur des groupes de machines virtuelles identiques Azure.

Désinstallation des serveurs avec Azure Arc

Utilisez les commandes PowerShell suivantes pour désinstaller l’agent Azure Monitor de serveurs avec Azure Arc.

• Windows

  Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorWindowsAgent
  

• Linux

  Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorLinuxAgent
  

Azure CLI

Désinstallation des machines virtuelles Azure

Utilisez les commandes CLI suivantes pour désinstaller l’agent Azure Monitor de machines virtuelles Azure.

• Windows

  az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorWindowsAgent
  

• Linux

  az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorLinuxAgent
  

Désinstaller sur un groupe de machines virtuelles identiques Azure

Utilisez l’applet de commande CLI az vmss extension delete pour désinstaller l’agent Azure Monitor sur des groupes de machines virtuelles identiques Azure.

Désinstallation des serveurs avec Azure Arc

Utilisez les commandes CLI suivantes pour désinstaller l’agent Azure Monitor de serveurs avec Azure Arc.

• Windows

  az connectedmachine extension delete --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name>
  

• Linux

  az connectedmachine extension delete --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name>
  

modèle Azure Resource Manager

N/A

Update

Notes

La recommandation est d’activer Mise à niveau automatique des extensions, qui peut prendre jusqu’à 5 semaines après la publication d’une nouvelle version d’extension pour mettre à jour les extensions installées vers la version publiée (la plus récente) dans toutes les régions. Les mises à niveau étant émises par lots, vous pouvez voir des machines virtuelles, groupes identiques ou serveurs avec Arc mis à niveau avant d’autres. Si vous devez mettre à niveau une extension immédiatement, vous pouvez utiliser les instructions manuelles ci-dessous.

Portail

Pour effectuer une mise à jour unique de l’agent, vous devez d’abord désinstaller la version de l’agent existante. Installez ensuite la nouvelle version comme décrit.

Nous vous recommandons d’activer la mise à jour automatique de l’agent en activant la fonctionnalité Mise à niveau automatique des extensions. Accédez à votre machine virtuelle ou groupe identique, sélectionnez l’onglet Extensions, puis sélectionnez AzureMonitorWindowsAgent ou AzureMonitorLinuxAgent. Dans la boîte de dialogue qui s’ouvre, sélectionnez Activer la mise à niveau automatique.

PowerShell

Mise à jour sur les machines virtuelles Azure

Pour effectuer une mise à jour unique de l’agent, vous devez d’abord désinstaller la version de l’agent existante, puis installer la nouvelle version, comme décrit.

Nous vous recommandons d’activer la mise à jour automatique de l’agent en activant la fonctionnalité Mise à niveau automatique des extensions à l’aide des commandes PowerShell suivantes.

• Windows

  Set-AzVMExtension -ExtensionName AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorWindowsAgent -TypeHandlerVersion <version-number> -Location <location> -EnableAutomaticUpgrade $true
  

• Linux

  Set-AzVMExtension -ExtensionName AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorLinuxAgent -TypeHandlerVersion <version-number> -Location <location> -EnableAutomaticUpgrade $true
  

Mise à jour sur des serveurs avec Azure Arc

Pour effectuer une mise à niveau unique de l’agent, utilisez les commandes PowerShell suivantes.

• Windows

  $target = @{"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent" = @{"targetVersion"=<target-version-number>}}
  Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target
  

• Linux

  $target = @{"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent" = @{"targetVersion"=<target-version-number>}}
  Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target
  

Nous vous recommandons d’activer la mise à jour automatique de l’agent en activant la fonctionnalité Mise à niveau automatique des extensions à l’aide des commandes PowerShell suivantes.

• Windows

  Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorWindowsAgent -EnableAutomaticUpgrade
  

• Linux

  Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorLinuxAgent -EnableAutomaticUpgrade
  

Azure CLI

Mise à jour sur les machines virtuelles Azure

Pour effectuer une mise à jour unique de l’agent, vous devez d’abord désinstaller la version de l’agent existante, puis installer la nouvelle version, comme décrit.

Nous vous recommandons d’activer la mise à jour automatique de l’agent en activant la fonctionnalité Mise à niveau automatique des extensions à l’aide des commandes CLI suivantes.

• Windows

  az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true
  

• Linux

  az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true
  

Mise à jour sur des serveurs avec Azure Arc

Pour effectuer une mise à niveau unique de l’agent, utilisez les commandes CLI suivantes.

• Windows

  az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>
  

• Linux

  az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>
  

Nous vous recommandons d’activer la mise à jour automatique de l’agent en activant la fonctionnalité Mise à niveau automatique des extensions à l’aide des commandes PowerShell suivantes.

• Windows

  az connectedmachine extension update --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true
  

• Linux

  az connectedmachine extension update --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true
  

modèle Azure Resource Manager

S/O

Configurer

Les Règles de collecte de données (DCRs) servent d’outil de gestion de l’agent Azure Monitor (AMA) sur votre machine. La DCR AgentSettings peut être utilisée pour configurer des paramètres AMA tels que DisQuotaInMb, en veillant à ce que votre agent soit adapté à vos besoins de surveillance spécifiques.

Remarque

Considérations importantes à prendre en compte lors de l’utilisation de la DCR AgentSettings :

• La DCR AgentSettings ne peut être configurée que par le biais d’un déploiement de modèle.
• AgentSettings est toujours sa propre DCR et ne peut pas être ajoutée à une DCR existante.
• Pour des fonctionnalités appropriées, la machine et la DCR AgentSettings doivent se trouver dans la même région.

Paramètres pris en charge

La DCR AgentSettings prend actuellement en charge la configuration des paramètres suivants :

Paramètre	Description	Valeurs valides
DiscQuotaInMb	Définit la quantité d’espace disque utilisé par les fichiers journaux et le cache de l’agent Azure Monitor.	1 000 - 5 000 (en Mo)
TimeReceivedForForwardedEvents	Modifie la colonne WEF dans la table WEF Sentinel pour utiliser les données TimeReceived au lieu de TimeGenerated	0 ou 1

Configuration de la DCR AgentSettings

Portail

Non prise en charge.

PowerShell

N/A

Azure CLI

N/A

modèle Azure Resource Manager

1. Préparer l’environnement :

   Installer AMA sur votre machine virtuelle.

2. Créer une DCR par le biais d’un déploiement de modèle :

   L’exemple suivant passe la quantité maximale d’espace disque utilisée par le cache AMA à 5 Go.

   {
   "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
   "contentVersion": "1.0.0.0",
   "parameters": {},
   "resources": [
       {
       "type": "Microsoft.Insights/dataCollectionRules",
       "name": "dcr-contoso-01",
       "apiVersion": "2023-03-11",
       "properties": 
           {
           "description": "A simple agent settings",
           "agentSettings": 
               {
               "logs": [
                   {
                   "name": "MaxDiskQuotaInMB",
                   "value": "5000"
                   }
               ]
               }
           },
       "kind": "AgentSettings",
       "location": "eastus"
       }
   ]
   }
   

   Remarque

   Vous pouvez utiliser l’API Get DataCollectionRule pour obtenir la charge utile de la DCR que vous avez créée avec ce modèle.

3. Associer une DCR à votre machine :

   Vous pouvez effectuer cela avec un modèle ou à l’aide de Créer une API avec les détails suivants :

   • AssociationName : agentSettings
   • ResourceUri : ID ARM complet de la machine virtuelle
   • api-version : 2023-03-11 (l’ancienne version de l’API est également correcte)
   • Corps :

         {
         "properties": {
             "dataCollectionRuleId": “Full ARM ID for agent setting DCR”
             }
         }
     

4. Activez les paramètres :

   Redémarrez AMA pour appliquer les modifications.

Étapes suivantes

Créez une règle de collecte de données pour collecter des données à partir de l’agent et les envoyer à Azure Monitor.