Gérer et tenir à jour l’agent Log Analytics pour Windows et Linux

  • Article

Après le déploiement initial de l’agent Log Analytics Windows ou Linux dans Azure Monitor, il peut être nécessaire de le reconfigurer, de le mettre à niveau ou de le supprimer de la machine s’il a atteint la phase de mise hors service de son cycle de vie. Vous pouvez facilement effectuer ces tâches de maintenance de routine manuellement ou automatiquement ce qui réduit les erreurs opérationnelles et les coûts.

Important

L’agent Log Analytics hérité sera déconseillé d’ici août 2024. Passé cette date, Microsoft ne fournira plus de support pour l’agent Log Analytics. Migrez vers l’agent Azure Monitor avant août 2024 pour continuer à ingérer des données.

Mettre à niveau l’agent

Procédez à une mise à niveau manuelle ou automatique vers la dernière version de l’agent Log Analytics pour Windows et Linux, en fonction de votre scénario de déploiement et de l’environnement dans lequel la machine virtuelle s’exécute.

Environnement Méthode d’installation Méthode de mise à niveau
Azure VM Extension de machine virtuelle d’agent Log Analytics pour Windows/Linux L’agent est automatiquement mis à niveau après le changement de modèle de machine virtuelle, sauf si vous avez configuré votre modèle Azure Resource Manager de façon à l’ignorer en définissant la valeur de la propriété autoUpgradeMinorVersion sur false. Cependant, une fois déployée, l’extension ne mettra pas à jour les versions mineures à moins d’être redéployée, même si cette propriété est définie sur true. Seul l’agent Linux prend en charge la mise à jour automatique après un déploiement à l’aide de la propriété enableAutomaticUpgrade (voir Activer la mise à jour automatique pour l’agent Linux). La mise à niveau de la version principale est toujours manuelle (voir Propriété VirtualMachineExtensionInner.AutoUpgradeMinorVersion).
Images de machines virtuelles Azure personnalisées Installation manuelle de l’agent Log Analytics pour Windows ou Linux La mise à jour des machines virtuelles vers la dernière version de l’agent doit être effectuée à partir de la ligne de commande en exécutant le package d’installation Windows ou le pack de scripts shell à extraction automatique et installables Linux.
Machines virtuelles non Azure Installation manuelle de l’agent Log Analytics pour Windows ou Linux La mise à jour des machines virtuelles vers la dernière version de l’agent doit être effectuée à partir de la ligne de commande en exécutant le package d’installation Windows ou le pack de scripts shell à extraction automatique et installables Linux.

Mettre à niveau l’agent Windows

Sur une machine virtuelle Windows, pour mettre à jour l’agent vers la dernière version non installée à l’aide de l’extension de machine virtuelle Log Analytics, vous pouvez l’exécuter à partir de l’invite de commandes, d’un script ou d’une autre solution d’automatisation, ou bien utiliser l’Assistant d’installation MMASetup-<platform>.msi.

Pour télécharger la dernière version de l’agent Windows à partir de votre espace de travail Log Analytics :

  1. Connectez-vous au portail Azure.

  2. Dans le portail Azure, sélectionnez Tous les services. Dans la liste des ressources, entrez Log Analytics. Au fur et à mesure de la saisie, la liste est filtrée. Sélectionnez Espaces de travail Log Analytics.

  3. Dans votre liste d’espaces de travail Log Analytics, sélectionnez l’espace de travail.

  4. Dans votre espace de travail Log Analytics, sélectionnez la vignette Agents, puis Serveurs Windows.

  5. Sur l’écran Serveurs Windows, sélectionnez l’option Télécharger l’agent Windows correspondant à la version appropriée selon l’architecture du processeur du système d’exploitation Windows.

Notes

Pendant la mise à niveau de l’agent Log Analytics pour Windows, il est impossible de configurer ou de reconfigurer l’espace de travail auquel il doit faire référence. Pour configurer l’agent, suivez une des méthodes prises en charge répertoriées sous Ajouter ou supprimer un espace de travail.

Effectuer une mise à niveau à l’aide de l’Assistant d’installation

  1. Connectez-vous à la machine avec un compte disposant des droits d’administration.

  2. Exécutez MMASetup-<platform>.exe pour démarrer l’Assistant d’installation.

  3. Sur la première page de l’Assistant d’installation, cliquez sur Suivant.

  4. Dans la boîte de dialogue Installation de Microsoft Monitoring Agent, sélectionnez J’accepte pour accepter le contrat de licence.

  5. Dans la boîte de dialogue Installation de Microsoft Monitoring Agent, sélectionnez Mettre à niveau. La page d'état affiche la progression de la mise à niveau.

  6. Lorsque la page Configuration de Microsoft Monitoring Agent terminée s’affiche, sélectionnez Terminer.

Effectuer une mise à niveau à l’aide de la ligne de commande

  1. Connectez-vous à la machine avec un compte disposant des droits d’administration.

  2. Pour extraire les fichiers d’installation de l’agent, exécutez MMASetup-<platform>.exe /c à partir d’une invite de commandes avec élévation de privilèges, puis indiquez l’emplacement où vous souhaitez extraire les fichiers. L’autre possibilité consiste à spécifier le chemin d’accès à l’aide des arguments MMASetup-<platform>.exe /c /t:<Full Path>.

  3. Exécutez la commande suivante, où D:\ correspond à l’emplacement du fichier journal de mise à niveau :

    setup.exe /qn /l*v D:\logs\AgentUpgrade.log AcceptEndUserLicenseAgreement=1

Mettre à niveau l’agent Linux

Il est possible d’effectuer la mise à niveau à partir de versions antérieures (>1.0.0-47). Effectuer l’installation avec la commande --upgrade met à niveau tous les composants de l’agent vers la dernière version.

Pour procéder à la mise à niveau de l’agent, exécutez la commande suivante :

sudo sh ./omsagent-*.universal.x64.sh --upgrade

Activer la mise à jour automatique pour l’agent Linux

Nous vous recommandons d’activer la mise à niveau automatique des extensions à l’aide de ces commandes pour mettre à jour l’agent automatiquement.

Set-AzVMExtension \
  -ResourceGroupName myResourceGroup \
  -VMName myVM \
  -ExtensionName OmsAgentForLinux \
  -ExtensionType OmsAgentForLinux \
  -Publisher Microsoft.EnterpriseCloud.Monitoring \
  -TypeHandlerVersion latestVersion \
  -ProtectedSettingString '{"workspaceKey":"myWorkspaceKey"}' \
  -SettingString '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}' \
  -EnableAutomaticUpgrade $true

Ajouter ou supprimer un espace de travail

Ajoutez ou supprimez un espace de travail à l’aide de l’agent Windows ou de l’agent Linux.

Agent Windows

Les étapes décrites dans cette section sont nécessaires non seulement lorsque vous souhaitez reconfigurer l’agent Windows pour qu’il utilise un autre espace de travail ou pour supprimer un espace de travail de sa configuration, mais également lorsque vous souhaitez configurer l’agent pour qu’il utilise plusieurs espaces de travail. (Cette pratique est communément appelée « hébergement multiple »). La configuration de l’agent Windows pour qu’il utilise plusieurs espaces de travail ne peut être effectuée qu’après l’installation initiale de l’agent et à l’aide des méthodes décrites dans cette section.

Mettre à jour les paramètres dans le Panneau de configuration

  1. Connectez-vous à la machine avec un compte disposant des droits d’administration.

  2. Ouvrez le Panneau de configuration.

  3. Sélectionnez Microsoft Monitoring Agent, puis l’onglet Azure Log Analytics.

  4. Si vous supprimez un espace de travail, sélectionnez-le, puis sélectionnez Supprimer. Répétez cette étape pour le ou les autres espaces de travail auxquels l’agent ne doit plus communiquer d’informations.

  5. Si vous ajoutez un espace de travail, sélectionnez Ajouter. Dans la boîte de dialogue Ajouter un espace de travail Log Analytics, collez l’ID et la clé (clé primaire) de l’espace de travail. Si l’ordinateur doit rendre compte à un espace de travail Log Analytics dans le cloud Azure Government, sélectionnez Azure US Government dans la liste déroulante Cloud Azure.

  6. Sélectionnez OK pour enregistrer vos modifications.

Supprimer un espace de travail à l’aide de PowerShell

$workspaceId = "<Your workspace Id>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.RemoveCloudWorkspace($workspaceId)
$mma.ReloadConfiguration()

Ajouter un espace de travail dans Azure commercial à l’aide de PowerShell

$workspaceId = "<Your workspace Id>"
$workspaceKey = "<Your workspace Key>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.AddCloudWorkspace($workspaceId, $workspaceKey)
$mma.ReloadConfiguration()

Ajouter un espace de travail dans Azure pour US Government à l’aide de PowerShell

$workspaceId = "<Your workspace Id>"
$workspaceKey = "<Your workspace Key>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.AddCloudWorkspace($workspaceId, $workspaceKey, 1)
$mma.ReloadConfiguration()

Notes

Si vous avez utilisé la ligne de commande ou un script pour installer ou configurer l’agent, EnableAzureOperationalInsights a été remplacé par AddCloudWorkspace et RemoveCloudWorkspace.

Agent Linux

Les étapes suivantes montrent comment reconfigurer l’agent Linux si vous décidez de l’enregistrer avec un autre espace de travail ou si vous souhaitez supprimer un espace de travail à partir de sa configuration.

  1. Pour vérifier que l’agent est inscrit dans un espace de travail, exécutez la commande suivante :

    /opt/microsoft/omsagent/bin/omsadmin.sh -l

    Cela renvoie un état similaire à l’exemple suivant :

    Primary Workspace: <workspaceId> Status: Onboarded(OMSAgent Running)

    Il est important que l’état indique également que l’agent est en cours d’exécution. Sinon, les étapes suivantes ne permettront pas de reconfigurer correctement l’agent.

  2. Si l’agent est déjà inscrit auprès d’un espace de travail, supprimez ce dernier en exécutant la commande suivante. Sinon, passez à l’étape suivante.

    /opt/microsoft/omsagent/bin/omsadmin.sh -X

  3. Pour inscrire un autre espace de travail, exécutez la commande suivante :

    /opt/microsoft/omsagent/bin/omsadmin.sh -w <workspace id> -s <shared key> [-d <top level domain>]

  4. Pour vérifier que vos modifications sont effectives, exécutez la commande suivante :

    /opt/microsoft/omsagent/bin/omsadmin.sh -l

    Cela renvoie un état similaire à l’exemple suivant :

    Primary Workspace: <workspaceId> Status: Onboarded(OMSAgent Running)

Il n’est pas nécessaire de redémarrer le service de l’agent pour que les modifications prennent effet.

Mettre à jour les paramètres de proxy

L’agent Log Analytics (MMA) n’utilise pas les paramètres proxy du système. Par conséquent, vous devez transmettre les paramètres de proxy lors de l’installation de MMA. Ces paramètres sont stockés sous la configuration de MMA (Registre) sur la machine virtuelle. Pour permettre à l’agent de communiquer avec le service via un serveur proxy ou une passerelle Log Analytics après le déploiement, utilisez l’une des méthodes suivantes.

Agent Windows

Utilisez un agent Windows.

Mettre à jour les paramètres dans le Panneau de configuration

  1. Connectez-vous à la machine avec un compte disposant des droits d’administration.

  2. Ouvrez le Panneau de configuration.

  3. Sélectionnez Microsoft Monitoring Agent, puis l’onglet Paramètres du proxy

  4. Sélectionnez Utiliser un serveur proxy, et indiquez l’URL et le numéro de port du serveur proxy ou de la passerelle. Si le serveur proxy ou la passerelle Log Analytics requiert une authentification, entrez le nom d’utilisateur et le mot de passe appropriés afin de vous authentifier, puis sélectionnez OK.

Mettre à jour les paramètres à l’aide de PowerShell

Copiez l’exemple de code PowerShell suivant, mettez-le à jour avec les informations propres à votre environnement et enregistrez-le avec une extension de fichier PS1. Exécutez le script sur chaque machine qui se connecte directement à l’espace de travail Log Analytics dans Azure Monitor.

param($ProxyDomainName="https://proxy.contoso.com:30443", $cred=(Get-Credential))

# First we get the Health Service configuration object. We need to determine if we
#have the right update rollup with the API we need. If not, no need to run the rest of the script.
$healthServiceSettings = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'

$proxyMethod = $healthServiceSettings | Get-Member -Name 'SetProxyInfo'

if (!$proxyMethod)
{
    Write-Output 'Health Service proxy API not present, will not update settings.'
    return
}

Write-Output "Clearing proxy settings."
$healthServiceSettings.SetProxyInfo('', '', '')

$ProxyUserName = $cred.username

Write-Output "Setting proxy to $ProxyDomainName with proxy username $ProxyUserName."
$healthServiceSettings.SetProxyInfo($ProxyDomainName, $ProxyUserName, $cred.GetNetworkCredential().password)

Agent Linux

Effectuez les opérations suivantes si vos ordinateurs Linux doivent communiquer via un serveur proxy ou une passerelle Log Analytics. La valeur de configuration du proxy présente la syntaxe suivante : [protocol://][user:password@]proxyhost[:port]. La propriété proxyhost accepte un nom de domaine complet ou l’adresse IP du serveur proxy.

  1. Modifiez le fichier /etc/opt/microsoft/omsagent/proxy.conf en exécutant les commandes suivantes, et modifiez les valeurs en vous basant sur vos paramètres spécifiques :

    proxyconf="https://proxyuser:proxypassword@proxyserver01:30443"
sudo echo $proxyconf >>/etc/opt/microsoft/omsagent/proxy.conf
sudo chown omsagent:omiusers /etc/opt/microsoft/omsagent/proxy.conf

  2. Redémarrez l’agent en exécutant la commande suivante :

    sudo /opt/microsoft/omsagent/bin/service_control restart [<workspace id>]

    Si vous voyez cURL failed to perform on this base url dans le journal, vous pouvez essayer de supprimer '\n' dans proxy.conf EOF pour résoudre l’échec :

    od -c /etc/opt/microsoft/omsagent/proxy.conf
cat /etc/opt/microsoft/omsagent/proxy.conf | tr -d '\n' > /etc/opt/microsoft/omsagent/proxy2.conf
rm /etc/opt/microsoft/omsagent/proxy.conf
mv /etc/opt/microsoft/omsagent/proxy2.conf /etc/opt/microsoft/omsagent/proxy.conf
sudo chown omsagent:omiusers /etc/opt/microsoft/omsagent/proxy.conf
sudo /opt/microsoft/omsagent/bin/service_control restart [<workspace id>]

Désinstaller l’agent

Utilisez une des procédures suivantes pour désinstaller l’agent Windows ou Linux à l’aide de la ligne de commande ou de l’Assistant d’installation.

Agent Windows

Utilisez l’agent Windows.

Désinstaller à partir du Panneau de configuration

  1. Connectez-vous à la machine avec un compte disposant des droits d’administration.

  2. Dans le Panneau de configuration, sélectionnez Programmes et fonctionnalités.

  3. Dans Programmes et fonctionnalités, sélectionnez Microsoft Monitoring Agent>Désinstaller>Oui.

Notes

Pour exécuter l’Assistant d’installation de l’agent, vous pouvez aussi double-cliquer sur le fichier MMASetup-\<platform\>.exe, disponible en téléchargement à partir d’un espace de travail du portail Azure.

Désinstaller à partir de la ligne de commande

Le fichier téléchargé de l’agent est un package d’installation autonome créé avec IExpress. Le programme d’installation de l’agent et les fichiers de prise en charge sont contenus dans le package et doivent être extraits pour effectuer une désinstallation correcte à l’aide de la ligne de commande illustrée dans l’exemple suivant.

  1. Connectez-vous à la machine avec un compte disposant des droits d’administration.

  2. Pour extraire les fichiers d’installation de l’agent, à partir d’une invite de commandes avec élévation de privilèges, exécutez extract MMASetup-<platform>.exe et indiquez l’emplacement où extraire les fichiers. L’autre possibilité consiste à spécifier le chemin d’accès à l’aide des arguments extract MMASetup-<platform>.exe /c:<Path> /t:<Path>. Pour plus d’informations sur les commutateurs de ligne de commande pris en charge par IExpress, consultez Commutateurs de ligne de commande pour IExpress puis mettez à jour l’exemple en fonction de vos besoins.

  3. À l’invite, entrez %WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb.

Agent Linux

Pour supprimer l’agent, exécutez la commande suivante sur l’ordinateur Linux. L’argument --purge supprime complètement l’agent et sa configuration.

wget https://raw.githubusercontent.com/Microsoft/OMS-Agent-for-Linux/master/installer/scripts/onboard_agent.sh && sh onboard_agent.sh --purge

Configurer l’agent pour qu’il communique avec un groupe d’administration Operations Manager

Utilisez l’agent Windows.

Agent Windows

Procédez comme suit pour que l’agent Log Analytics pour Windows communique avec un groupe d’administration System Center Operations Manager.

Notes

Dans le cadre de la transition en cours entre Microsoft Operations Management Suite et Azure Monitor, l’agent Operations Management Suite pour Windows ou Linux sera appelé l’agent Log Analytics pour Windows et l’agent Log Analytics pour Linux.

  1. Connectez-vous à la machine avec un compte disposant des droits d’administration.

  2. Ouvrez le Panneau de configuration.

  3. Sélectionnez Microsoft Monitoring Agent, puis l’onglet Operations Manager.

  4. Si vos serveurs Operations Manager sont intégrés à Active Directory, sélectionnez Met à jour automatiquement les attributions du groupe d’administration à partir d’AD DS.

  5. Sélectionnez Ajouter pour ouvrir la boîte de dialogue Ajouter un groupe d’administration.

  6. Dans le champ Nom du groupe d’administration, entrez le nom de votre groupe d’administration.

  7. Dans le champ Serveur d’administration principal, entrez le nom d’ordinateur du serveur d’administration principal.

  8. Dans le champ Port du serveur d’administration, entrez le numéro du port TCP.

  9. Sous Compte d’action de l’agent, choisissez le compte système local ou un compte de domaine local.

  10. Sélectionnez OK pour fermer la boîte de dialogue Ajouter un groupe d’administration. Puis sélectionnez OK pour fermer la boîte de dialogue Propriétés de Microsoft Monitoring Agent.

Agent Linux

Procédez comme suit pour que l’agent Log Analytics pour Linux communique avec un groupe d’administration System Center Operations Manager.

Notes

Dans le cadre de la transition en cours entre Microsoft Operations Management Suite et Azure Monitor, l’agent Operations Management Suite pour Windows ou Linux sera appelé l’agent Log Analytics pour Windows et l’agent Log Analytics pour Linux.

  1. Modifiez le fichier /etc/opt/omi/conf/omiserver.conf.

  2. Vérifiez que la ligne commençant par httpsport= spécifie le port 1270. Par exemple, httpsport=1270.

  3. Redémarrez le serveur OMI à l’aide de la commande suivante :

    sudo /opt/omi/bin/service_control restart

Forum aux questions

Cette section fournit des réponses aux questions fréquentes.

Comment interrompre la communication de l'agent Log Analytics avec Azure Monitor ?

Pour les agents connectés directement à Log Analytics, ouvrez le Panneau de configuration et sélectionnez Microsoft Monitoring Agent. Sous l'onglet Azure Log Analytics (OMS) , supprimez tous les espaces de travail répertoriés. Dans System Center Operations Manager, supprimez l’ordinateur de la liste des ordinateurs gérés par Log Analytics. Operations Manager met à jour la configuration de l’agent pour qu’il ne fasse plus de rapports à Log Analytics.

Étapes suivantes