Instructions de résolution des problèmes liés à l’agent Azure Monitor sur des machines virtuelles Windows et des groupes identiques

Vue d’ensemble de l’agent Azure Monitor

Avant de continuer, vous devez vous familiariser avec l’agent Azure Monitor et les règles de collecte de données.

Terminologie

Étapes de dépannage de base (installation, agent non en cours d’exécution, problèmes de configuration)

Suivez les étapes ci-dessous pour résoudre les problèmes liés à la dernière version de l’agent Azure Monitor s’exécutant sur votre machine virtuelle Windows :

1. Examinez attentivement les prérequis ici.

2. Vérifiez que l’extension qui installe les fichiers binaires de l’agent sur votre ordinateur est correctement installée et provisionnée :

   1. Ouvrez le portail Azure > sélectionnez votre machine virtuelle > ouvrez Paramètres : Extensions + applications dans le volet de gauche > « AzureMonitorWindowsAgent » doit apparaître avec l’état « Provisionnement réussi ».
   2. Si ce n’est pas le cas, vérifiez si la machine peut atteindre Azure et recherchez l’extension à installer en utilisant la commande ci-dessous :

      az vm extension image list-versions --location <machine-region> --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor
      

   3. Attendez 10 à 15 minutes, car l’extension peut être dans un état de transition. Si elle n’apparaît toujours pas, désinstallez et réinstallez l’extension, puis répétez la vérification pour voir si l’extension s’affiche.
   4. Si ce n’est pas le cas, recherchez la présence d’erreurs dans les journaux d’extension situés à l’emplacement C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent sur votre ordinateur.

3. Vérifiez que l’agent est en cours d’exécution :

   1. Vérifiez si l’agent émet des journaux de pulsations dans l’espace de travail Log Analytics en utilisant la requête ci-dessous. Ignorez cette étape si « Métriques personnalisées » est la seule destination dans la règle DCR :

      Heartbeat | where Category == "Azure Monitor Agent" and Computer == "<computer-name>" | take 10
      

   2. Si ce n’est pas le cas, ouvrez le Gestionnaire des tâches et vérifiez si le processus « MonAgentCore.exe » est en cours d’exécution. Si c’est le cas, attendez 5 minutes pour que la pulsation apparaisse.
   3. Si elle n’apparaît pas, recherchez la présence d’erreurs dans les principaux journaux d’agent à l’emplacement C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Configuration sur votre ordinateur.

4. Vérifiez que la règle DCR existe et qu’elle est associée à la machine virtuelle :

   1. Si vous utilisez l’espace de travail Log Analytics comme destination, vérifiez que la règle DCR existe dans la même région physique que l’espace de travail Log Analytics.
   2. Sur votre machine virtuelle, vérifiez l’existence du fichier C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.latest.xml. Si ce fichier n’existe pas :
      • La machine virtuelle peut ne pas être associée à une règle DCR. Consultez l’étape 3.
      • L’identité managée n’est peut-être pas activée sur la machine virtuelle. Consultez cette rubrique pour savoir comment l’activer.
      • Le service IMDS ne fonctionne pas/ n’est pas accessible depuis la machine virtuelle. Vérifiez si vous pouvez accéder à IMDS à partir de l’ordinateur.
      • AMA ne peut pas accéder à IMDS. Vérifiez si vous voyez des erreurs IMDS dans le fichier C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Tables\MAEventTable.tsf.
   3. Ouvrez le portail Azure > sélectionnez votre règle de collecte de données > ouvrez Configuration : Ressources dans le volet de gauche > vous devriez voir la machine virtuelle listée ici.
   4. Si ce n’est pas le cas, cliquez sur Ajouter et sélectionnez votre machine virtuelle dans le sélecteur de ressources. Recommencez sur toutes les règles DCR.

5. Vérifiez que l’agent a pu télécharger la ou les règles DCR associées à partir du service AMCS :

   1. Vérifiez si vous voyez la dernière règle DCR téléchargée à l’emplacement C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\configchunks.

Problèmes de collecte des compteurs de performances

1. Vérifiez que le fichier JSON de votre règle DCR contient une section pour « performanceCounters ». Si ce n’est pas le cas, corrigez votre règle DCR. Découvrez comment créer une règle DCR ou un exemple de règle DCR.
2. Vérifiez que le fichier C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.lkg.xml existe.
3. Ouvrez le fichier et vérifiez s’il contient des nœuds CounterSet, comme indiqué dans l’exemple ci-dessous :

   <CounterSet storeType="Local" duration="PT1M" 
       eventName="c9302257006473204344_16355538690556228697" 
       sampleRateInSeconds="15" format="Factored">
       <Counter>\Processor(_Total)\% Processor Time</Counter>
       <Counter>\Memory\Committed Bytes</Counter>
       <Counter>\LogicalDisk(_Total)\Free Megabytes</Counter>
       <Counter>\PhysicalDisk(_Total)\Avg. Disk Queue Length</Counter>
   </CounterSet>
   

Problèmes liés à l’utilisation de « Métriques personnalisées » comme destination

1. Examinez attentivement les prérequis ici.
2. Vérifiez que la règle DCR associée est correctement créée pour collecter des compteurs de performances et les envoyer aux métriques Azure Monitor. Vous devez voir cette section dans votre règle DCR :

   "destinations": {  
   "azureMonitorMetrics": {  
       "name":"myAmMetricsDest" 
       } 
   }
   

3. Exécutez la commande PowerShell :

   Get-WmiObject Win32_Process -Filter "name = 'MetricsExtension.Native.exe'" | select Name,ExecutablePath,CommandLine | Format-List
   

   Vérifiez que le paramètre CommandLine dans la sortie contient l’argument « -TokenSource MSI ».
4. Vérifiez que le fichier C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\AuthToken-MSI.json est présent.
5. Vérifiez que le fichier C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\CUSTOMMETRIC_<subscription>_<region>_MonitoringAccount_Configuration.json est présent.
6. Collectez les journaux en exécutant la commande suivante : C:\Packages\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\<version-number>\Monitoring\Agent\table2csv.exe C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Tables\MaMetricsExtensionEtw.tsf
   1. La commande génère le fichier « MaMetricsExtensionEtw.csv ».
   2. Ouvrez-le, recherchez les erreurs de niveau 2 et essayez de les corriger.

Problèmes lors de la collecte des journaux des événements Windows

1. Vérifiez que le fichier JSON de votre règle DCR contient une section pour « windowsEventLogs ». Si ce n’est pas le cas, corrigez votre règle DCR. Découvrez comment créer une règle DCR ou un exemple de règle DCR.
2. Vérifiez que le fichier C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.lkg.xml existe.
3. Ouvrez le fichier et vérifiez s’il contient des nœuds Subscription, comme indiqué dans l’exemple ci-dessous :

   <Subscription eventName="c9302257006473204344_14882095577508259570" 
   query="System!*[System[(Level = 1 or Level = 2 or Level = 3)]]">
       <Column name="ProviderGuid" type="mt:wstr" defaultAssignment="00000000-0000-0000-0000-000000000000">
         <Value>/Event/System/Provider/@Guid</Value>
       </Column>
       ...
   
       </Column>
   </Subscription>