Instructions de résolution des problèmes liés à l’agent Azure Monitor sur un serveur Windows avec Arc

Article
10/15/2024

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

Nom	Acronyme	Description
Agent Azure Monitor	AMA	Nouvel agent Azure Monitor
Règles de collecte des données	DCR	Règles permettant de configurer la collecte de données par l’agent, c.-à-d. quels éléments collecter, où les envoyer, etc.
Azure Monitor Configuration Service	AMCS	Service régional hébergé dans Azure qui contrôle la collecte de données pour cet agent et d’autres parties d’Azure Monitor. L’agent appelle ce service pour récupérer (fetch) les règles DCR.
Point de terminaison de journaux	--	Point de terminaison pour l’envoi de données à des espaces de travail Log Analytics
Point de terminaison de métriques	--	Point de terminaison pour l’envoi de données à des bases de données Métriques Azure Monitor
Instance Metadata Service et Hybrid Instance Metadata Service	IMDS et HIMDS	Services hébergés dans Azure qui fournissent des informations sur les machines virtuelles en cours d’exécution, les groupes identiques (via IMDS) et les serveurs avec Arc (via HIMDS)
Espace de travail Log Analytics	LAW	Destination dans Azure Monitor où vous pouvez envoyer les journaux collectés par l’agent
Métriques personnalisées	--	Destination dans Azure Monitor où vous pouvez envoyer les métriques d’invité collectées par l’agent

É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 serveur Windows avec Arc :

Examinez attentivement les prérequis ici.
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 serveur avec Arc > ouvrez Paramètres : Extensions dans le volet de gauche > « AzureMonitorWindowsAgent » doit apparaître avec l’état « Réussi ».
2. Si ce n’est pas le cas, vérifiez si l’agent Arc (Connected Machine Agent) est en mesure de se connecter à Azure et que le service d’extension est en cours d’exécution.
```
azcmagent show
```
  La sortie ci-dessous doit apparaître :
```
Resource Name                           : <server name>
[...]
Dependent Service Status
  Agent Service (himds)                 : running
  GC Service (gcarcservice)             : running
  Extension Service (extensionservice)  : running
```
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:\ProgramData\GuestConfig\extension_logs\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent sur votre ordinateur.
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:\Resources\Directory\AMADataStore\Configuration sur votre ordinateur.
Vérifiez que la règle DCR existe et qu’elle est associée au serveur avec Arc :
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 serveur avec Arc, vérifiez l’existence du fichier C:\Resources\Directory\AMADataStore\mcs\mcsconfig.latest.xml. Si ce fichier n’existe pas, le serveur avec Arc peut ne pas être associé à une règle DCR.
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 le serveur avec Arc listé ici.
4. Si ce n’est pas le cas, cliquez sur Ajouter et sélectionnez votre serveur avec Arc dans le sélecteur de ressources. Recommencez sur toutes les règles DCR.
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:\Resources\Directory\AMADataStore\mcs\configchunks.

Problèmes de collecte des compteurs de performances

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.
Vérifiez que le fichier C:\Resources\Directory\AMADataStore\mcs\mcsconfig.lkg.xml existe.

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

Examinez attentivement les prérequis ici.
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" 
    } 
}
```
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 ».
Vérifiez que le fichier C:\Resources\Directory\AMADataStore\mcs\AuthToken-MSI.json est présent.
Vérifiez que le fichier C:\Resources\Directory\AMADataStore\mcs\CUSTOMMETRIC_<subscription>_<region>_MonitoringAccount_Configuration.json est présent.
Collectez les journaux en exécutant la commande suivante : C:\Packages\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\<version-number>\Monitoring\Agent\table2csv.exe C:\Resources\Directory\AMADataStore\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

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.
Vérifiez que le fichier C:\Resources\Directory\AMADataStore\mcs\mcsconfig.lkg.xml existe.

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>

Partager via