Installer l’agent Log Analytics sur des ordinateurs Windows

Article
11/14/2024

Cet article fournit des informations sur l’installation de l’agent Log Analytics sur des ordinateurs Windows à l’aide des méthodes suivantes :

Installation manuelle à l’aide de l’Assistant Installation d’une ligne de commande.
Configuration de l’état souhaité Azure Automation (DSC).

Les méthodes d’installation décrites dans cet article sont généralement utilisées pour des machines virtuelles locales ou dans d’autres clouds. Pour d’autres options efficaces que vous pouvez utiliser pour des machines virtuelles Azure, consultez Options d’installation.

Important

L’agent Log Analytics hérité est déconseillé depuis le 31 août 2024. Microsoft ne fournit plus de support pour l’agent Log Analytics. Si vous utilisez l’agent Log Analytics pour ingérer des données dans Azure Monitor, vous devez migrer maintenant vers l’agent Azure Monitor.

Remarque

L’installation de l’agent Log Analytics ne nécessite généralement pas le redémarrage de l’ordinateur.

Configuration requise

Systèmes d’exploitation pris en charge

Pour obtenir la liste des versions de Windows que l’agent Log Analytics prend en charge, consultez Vue d’ensemble des agents Azure Monitor.

Configuration requise pour la prise en charge de la signature de code SHA-2

Depuis le 17 août 2020, l’agent Windows utilise exclusivement la signature SHA-2. Ce changement a eu un impact sur les clients qui utilisent l’agent Log Analytics sur un système d’exploitation hérité dans le cadre d’un service Azure (Azure Monitor, Azure Automation, Azure Update Management, Azure Change Tracking, Microsoft Defender pour le cloud, Microsoft Sentinel, Windows Defender ATP).

Le client n’a rien à faire à moins que l’agent s’exécute sur une version héritée du système d’exploitation (Windows 7, Windows Server 2008 R2 et Windows Server 2008). Les clients utilisant une version héritée du système d’exploitation étaient tenus d’effectuer les actions suivantes sur leurs ordinateurs avant le 17 août 2020. À défaut, leurs agents cessaient d’envoyer les données à leurs espaces de travail Log Analytics :

Installer le dernier Service Pack pour votre système d’exploitation. Les versions de Service Pack nécessaires sont les suivantes :
- Windows 7 SP1
- Windows Server 2008 SP2
- Windows Server 2008 R2 SP1
Installer les mises à jour Windows de signature SHA-2 pour le système d’exploitation en question, comme décrit dans Obligation de prise en charge de la signature du code SHA-2 2019 pour Windows et WSUS.
Effectuer une mise à jour vers la dernière version de l’agent Windows (version 10.20.18067).
Nous vous recommandons de configurer l’agent pour utiliser TLS 1.2.

Configuration requise pour le réseau

Pour connaître la configuration réseau requise pour l’agent Windows, consultez Présentation de l’agent Log Analytics.

Configurer l’Agent de façon à utiliser TLS 1.2

Le protocole TLS 1.2 garantit la sécurité des données en transit pour la communication entre l’agent Windows et le service Log Analytics. Si vous effectuez l’installation sur un système d’exploitation sans le protocole TLS activé par défaut, vous devez configurer TLS 1.2 en procédant de la manière décrite ci-dessous.

Recherchez la sous-clé de Registre suivante : HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols.
Créez une sous-clé sous Protocoles pour TLS 1.2 : HKLM\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2.
Créez une sous-clé Client sous la sous-clé de version du protocole TLS 1.2 que vous venez de créer. Par exemple, HKLM\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client.
Créez les valeurs DWORD suivantes sous HKLM\System\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client :
- Enabled [Valeur = 1]
- DisabledByDefault [Valeur = 0]

Configurez .NET Framework 4.6 (ou version ultérieure) de façon à prendre en charge le chiffrement sécurisé, car il est désactivé par défaut. Le chiffrement fort utilise des protocoles réseau sécurisés, comme TLS 1.2, et bloque les autres.

Recherchez la sous-clé de Registre suivante : HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319.
Créez la valeur DWORD SchUseStrongCrypto sous cette sous-clé avec la valeur 1.
Recherchez la sous-clé de Registre suivante : HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v4.0.30319.
Créez la valeur DWORD SchUseStrongCrypto sous cette sous-clé avec la valeur 1.
Redémarrez le système pour que les paramètres s’appliquent.

ID et clé d’espace de travail

Quelle que soit la méthode d’installation utilisée, vous aurez besoin de l’ID et de la clé d’espace de travail pour l’espace de travail Log Analytics auquel l’agent se connectera. Sélectionnez l’espace de travail dans le menu Espaces de travail Log Analytics dans le portail Azure. Puis dans la section Paramètres, sélectionnez Agents.

Notes

Vous ne pouvez pas configurer l’agent pour qu’il signale plusieurs espaces de travail lors de la configuration initiale. Ajoutez ou supprimez un espace de travail après l’installation en mettant à jour les paramètres à partir du panneau de configuration ou de PowerShell.

Remarque

Bien que la régénération des clés partagées de l’espace de travail Log Analytics soit possible, son intention n’est pas de restreindre immédiatement l’accès aux agents qui utilisent actuellement ces clés. Les agents utilisent la clé pour générer un certificat qui expire après trois mois. La régénération des clés partagées empêche uniquement les agents de renouveler leurs certificats, et non pas de continuer à utiliser ces certificats tant qu’ils n’expirent pas.

Installer l’agent

Important

Les étapes suivantes installent et configurent l’agent Log Analytics dans le cloud Azure et Azure Government en utilisant l’Assistant Installation de l’agent sur votre ordinateur. Pour apprendre à configurer l’agent de façon à ce qu’il rende également des comptes à un groupe d’administration System Center Operations Manager, voir Déployer l’Agent Operations Manager avec l’Assistant Installation de l’agent.

Revenez sur la page Serveurs Windows de votre espace de travail Log Analytics et sélectionnez l’option Télécharger l’agent Windows correspondant à la version adaptée à l’architecture du processeur du système d’exploitation Windows.
Exécutez le programme d’installation pour installer l’agent sur votre ordinateur.
Sur la page d’accueil, cliquez sur Suivant.
Dans la page Termes du contrat de licence, lisez les conditions de licence, puis cliquez sur J’accepte.
Dans la page Dossier de destination, modifiez ou conservez le dossier d’installation par défaut, puis cliquez sur Suivant.
Sur la page Options d’installation de l’agent, choisissez de connecter l’agent à Azure Log Analytics, puis cliquez sur Suivant.
Dans la page Azure Log Analytics , procédez comme suit :
1. Collez l’ID de l’espace de travail et la Clé d’espace de travail (Clé primaire) que vous avez copiés précédemment. Si l’ordinateur doit rendre compte à un espace de travail Log Analytics dans le cloud Azure Government, dans la liste déroulante Cloud Azure, sélectionnez Azure - Gouvernement des États-Unis.
2. Si l’ordinateur a besoin de communiquer via un serveur proxy avec le service Log Analytics, cliquez sur Avancé, puis indiquez l’URL et le numéro de port du serveur proxy. Si votre serveur proxy requiert une authentification, tapez le nom d’utilisateur et un mot de passe pour vous authentifier auprès du serveur proxy, puis cliquez sur Suivant.
Cliquez sur Suivant après avoir fourni les paramètres de configuration nécessaires.
Dans la page Prêt pour l’installation, passez en revue vos choix, puis cliquez sur Installer.
Dans la page Configuration effectuée, cliquez sur Terminer.

Lorsque vous avez terminé, Microsoft Monitoring Agent apparaît dans le Panneau de configuration. Pour confirmer qu’il rend compte à Log Analytics, passez en revue Vérifier la connectivité de l’agent à Log Analytics.

Le fichier téléchargé pour l’agent est un package d’installation autonome. 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 installation correcte à l’aide de la ligne de commande indiquée dans les exemples suivants.

Notes

Si vous souhaitez mettre à niveau un agent, vous devez utiliser l’API de script Log Analytics. Pour plus d’informations, consultez Gestion et maintenance de l’agent Log Analytics sous Windows et Linux.

Le tableau suivant répertorie les paramètres spécifiques pris en charge par le programme d’installation de l’agent, notamment lors d’un déploiement à l’aide d’Automation DSC.

Options propres à MMA	Notes
NOAPM=1	Paramètre facultatif. Installe l’agent sans analyse des performances des applications .NET.
ADD_OPINSIGHTS_WORKSPACE	1 = Configurer l’agent de façon à ce qu’il se connecte à un espace de travail.
OPINSIGHTS_WORKSPACE_ID	ID (GUID) de l’espace de travail à ajouter.
OPINSIGHTS_WORKSPACE_KEY	Clé d’espace de travail utilisée initialement pour l’authentification auprès de l’espace de travail.
OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE	Spécifie l’environnement cloud où se trouve l’espace de travail. 0 = cloud commercial Azure (par défaut). 1 = Azure Government. 2 = Azure géré par le cloud 21Vianet.
OPINSIGHTS_PROXY_URL	URI pour le proxy à utiliser. Exemple : OPINSIGHTS_PROXY_URL=Adresse_IP:Port ou OPINSIGHTS_PROXY_URL=Nom_domaine_complet:Port
OPINSIGHTS_PROXY_USERNAME	Nom d’utilisateur permettant d’accéder à un proxy authentifié.
OPINSIGHTS_PROXY_PASSWORD	Mot de passe permettant d’accéder à un proxy authentifié.

Pour extraire les fichiers d’installation de l’agent, à partir d’une invite de commandes avec élévation, exécutez les commandes suivantes MMASetup-<platform>.exe /c. Vous êtes invité à entrer le chemin d’accès dans lequel 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>.
Pour installer l’agent en mode silencieux et le configurer pour qu’il rende compte à un espace de travail dans le cloud Azure Commercial, à partir du dossier dans lequel vous avez extrait les fichiers d’installation, entrez :
```
setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=0 OPINSIGHTS_WORKSPACE_ID="<your workspace ID>" OPINSIGHTS_WORKSPACE_KEY="<your workspace key>" AcceptEndUserLicenseAgreement=1
```
Ou, pour configurer l’agent afin qu’il rende compte au cloud du gouvernement des États-Unis, entrez :
```
setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=1 OPINSIGHTS_WORKSPACE_ID="<your workspace ID>" OPINSIGHTS_WORKSPACE_KEY="<your workspace key>" AcceptEndUserLicenseAgreement=1
```
Ou pour configurer l’agent devant répondre à Microsoft Azure géré par le cloud 21Vianet, entrez :
```
setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=2 OPINSIGHTS_WORKSPACE_ID="<your workspace ID>" OPINSIGHTS_WORKSPACE_KEY="<your workspace key>" AcceptEndUserLicenseAgreement=1
```
Notes

Les valeurs de chaîne des paramètres OPINSIGHTS_WORKSPACE_ID et OPINSIGHTS_WORKSPACE_KEY doivent être entourées de guillemets pour indiquer à Windows Installer de les interpréter comme des options valides pour le package.

Vous pouvez utiliser l’exemple de script suivant pour installer l’agent à l’aide d’Azure Automation DSC. Si vous n’avez pas de compte Automation, consultez Prise en main d’Azure Automation pour comprendre les exigences et les étapes de création d’un compte Automation à respecter avant d’utiliser Automation DSC. Si vous n’êtes pas familiarisé avec Automation DSC, consultez Prise en main d’Azure Automation DSC.

L’exemple suivant installe l’agent 64 bits, identifié par la valeur URI. Vous pouvez également utiliser la version 32 bits en remplaçant la valeur de l’URI. Les URI pour les deux versions sont :

Agent Windows 64 bits : https://go.microsoft.com/fwlink/?LinkId=828603
Agent Windows 32 bits : https://go.microsoft.com/fwlink/?LinkId=828604

Remarque

Cet exemple de procédure et de script ne prend pas en charge la mise à niveau de l’agent déjà déployé sur un ordinateur Windows.

Les versions 32 bits et 64 bits du package de l’agent ont des codes de produit différents et les nouvelles versions publiées ont également une valeur unique. Le code de produit est un GUID qui est l’identification principale d’une application ou d’un produit, et est représenté par la propriété ProductCode de Windows Installer. Dans le script MMAgent.ps1, la valeur ProductId doit correspondre au code de produit dans le package du programme d’installation 32 bits ou 64 bits de l’agent.

Pour récupérer le code de produit directement depuis le package d’installation de l’agent, vous pouvez utiliser Orca.exe à partir des composants SDK Windows pour les développeurs Windows Installer (composant du Kit de développement logiciel (SDK) Windows), ou utiliser PowerShell en suivant un exemple de script écrit par un MVP (Microsoft Valuable Professional). Pour les deux approches, vous devez commencer par extraire le fichier MOMagent.msi du package d’installation MMASetup, comme expliqué dans la première étape des instructions d’installation de l’agent à l’aide de la ligne de commande.

Importer le Module DSC xPSDesiredStateConfiguration à partir de https://www.powershellgallery.com/packages/xPSDesiredStateConfiguration dans Azure Automation.
Créez des ressources variables Azure Automation pour OPSINSIGHTS_WS_ID et OPSINSIGHTS_WS_KEY. Affectez votre ID d’espace de travail Log Analytics comme valeur OPSINSIGHTS_WS_ID et affectez la clé primaire de votre espace de travail comme valeur OPSINSIGHTS_WS_KEY.

Copiez le script et enregistrez-le sous le nom MMAgent.ps1.

Configuration MMAgent
{
    $OIPackageLocalPath = "C:\Deploy\MMASetup-AMD64.exe"
    $OPSINSIGHTS_WS_ID = Get-AutomationVariable -Name "OPSINSIGHTS_WS_ID"
    $OPSINSIGHTS_WS_KEY = Get-AutomationVariable -Name "OPSINSIGHTS_WS_KEY"

    Import-DscResource -ModuleName xPSDesiredStateConfiguration
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node OMSnode {
        Service OIService
        {
            Name = "HealthService"
            State = "Running"
            DependsOn = "[Package]OI"
        }

        xRemoteFile OIPackage {
            Uri = "https://go.microsoft.com/fwlink/?LinkId=828603"
            DestinationPath = $OIPackageLocalPath
        }

        Package OI {
            Ensure = "Present"
            Path  = $OIPackageLocalPath
            Name = "Microsoft Monitoring Agent"
            ProductId = "8A7F2C51-4C7D-4BFD-9014-91D11F24AAE2"
            Arguments = '/C:"setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_ID=' + $OPSINSIGHTS_WS_ID + ' OPINSIGHTS_WORKSPACE_KEY=' + $OPSINSIGHTS_WS_KEY + ' AcceptEndUserLicenseAgreement=1"'
            DependsOn = "[xRemoteFile]OIPackage"
        }
    }
}

Mettez à jour la valeur ProductId du script avec le code de produit extrait de la dernière version du package d’installation de l’agent en utilisant les méthodes recommandées précédemment.
Importez le script de configuration MMAgent.ps1 dans votre compte Automation.
Affectez un nœud ou ordinateur Windows à la configuration. En moins de 15 minutes, le nœud vérifie sa configuration et l’agent est poussé vers le nœud.

Vérifier la connectivité de l’agent à Azure Monitor

Une fois l’installation de l’agent terminée, vous pouvez vérifier qu’il est correctement connecté et opérationnel de deux façons.

Depuis Système et sécurité dans le Panneau de configuration, recherchez l’élément Agent Microsoft Monitoring. Sélectionnez-le sous l’onglet Azure Log Analytics. L’agent doit alors afficher un message indiquant que Microsoft Monitoring Agent s’est correctement connecté au service Microsoft Operations Management Suite.

Vous pouvez également effectuer une requête de journal dans le portail Azure :

Dans le portail Azure, recherchez et sélectionnez Monitor.
Dans le menu, sélectionnez Journaux.

Dans le volet Journaux, dans le champ de requête, entrez :

Heartbeat 
| where Category == "Direct Agent" 
| where TimeGenerated > ago(30m)

Dans les résultats de recherche retournés, vous devriez voir des enregistrements de pulsation pour l’ordinateur, indiquant qu’il est connecté et qu’il rend compte au service.

Informations sur le cache

Les données de l’agent de Log Analytics sont mises en cache sur l’ordinateur local à l’emplacement C:\Program Files\Microsoft Monitoring Agent\Agent\Health service State avant leur envoi à Azure Monitor. L’agent tente de charger toutes les 20 secondes. En cas d’échec, il met un temps de plus en plus long pour réussir. Il attend 30 secondes avant la deuxième tentative, 60 secondes avant la suivante, puis 120 secondes, et ainsi de suite jusqu’à un maximum de 8,5 heures entre les nouvelles tentatives avant que la reconnexion aboutisse. Ce temps d’attente est rendu légèrement aléatoire pour éviter que tous les agents tentent de se connecter simultanément. Les données les plus anciennes sont abandonnées lorsque la taille maximale de la mémoire tampon est atteinte.

La taille de cache par défaut est de 50 Mo, mais vous pouvez configurer une taille comprise entre 5 Mo et 1,5 Go. Elle est stockée dans la clé de registre HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HealthService\Parameters\Persistence Cache Maximum. La valeur représente le nombre de pages, avec 8 Ko par page.

Étapes suivantes

Consultez Gestion et maintenance de l’agent Log Analytics pour Windows et Linux pour en savoir plus sur la manière de reconfigurer, mettre à niveau ou supprimer l’agent de la machine virtuelle.
Consultez Résolution des problèmes de l’agent Windows si vous rencontrez des problèmes lors de l’installation ou de la gestion de l’agent.

Partager via

Installer l’agent Log Analytics sur des ordinateurs Windows

Configuration requise

Systèmes d’exploitation pris en charge

Configuration requise pour la prise en charge de la signature de code SHA-2

Configuration requise pour le réseau

Configurer l’Agent de façon à utiliser TLS 1.2

ID et clé d’espace de travail

Installer l’agent

Vérifier la connectivité de l’agent à Azure Monitor

Informations sur le cache

Étapes suivantes

Commentaires

Ressources supplémentaires