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

Article
01/23/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 machine virtuelle Windows :

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 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.
5. Si rien de ce qui précède n’est utile, créez un ticket en indiquant « Impossible d’installer ou de provisionner l’extension AMA » dans Résumé et « J’ai besoin d’aide concernant l’agent Windows Azure Monitor » dans Type de problème.
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. Si rien de ce qui précède n’est utile, créez un ticket en indiquant « L’extension AMA est provisionnée, mais ne s’exécute pas » dans Résumé et « J’ai besoin d’aide concernant l’agent Windows Azure Monitor » dans Type de problème.
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. Dans le cas contraire, créez un ticket en indiquant « service IMDS non en cours d’exécution » dans Résumé et « J’ai besoin d’aide pour configurer la collecte de données à partir d’une machine virtuelle » dans Type de problème.
  - 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. Si c’est le cas, créez un ticket en indiquant « AMA ne peut pas accéder à IMDS » dans Résumé et « J’ai besoin d’aide pour configurer la collecte de données à partir d’une machine virtuelle » dans Type de problème.
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. Si rien de ce qui précède n’est utile, créez un ticket en indiquant « Règle DCR introuvable ou non associée » dans Résumé et « J’ai besoin d’aide pour configurer la collecte de données à partir d’une machine virtuelle » dans Type de problème.
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.
2. Si ce n’est pas le cas, créez un ticket en indiquant « AMA ne peut pas télécharger la configuration DCR » dans Résumé et « J’ai besoin d’aide avec l’agent Windows Azure Monitor » dans Type de problème.

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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.lkg.xml existe. S’il n’existe pas, créez un ticket en indiquant « AMA ne s’est pas exécuté suffisamment longtemps » dans Résumé et « J’ai besoin d’aide avec l’agent Windows Azure Monitor » dans Type de problème.

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>

S’il n’y a pas de nœuds CounterSet, la règle DCR n’a pas été analysée correctement. Créez un ticket en indiquant « AMA ne peut pas analyser la configuration DCR » dans Résumé et « J’ai besoin d’aide avec l’agent Windows Azure Monitor » dans Type de problème.

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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\AuthToken-MSI.json est présent.
Vérifiez que le fichier C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\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:\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.
Si rien de ce qui précède n’est utile, créez un ticket en indiquant « AMA ne peut pas collecter les métriques personnalisées » dans Résumé et « J’ai besoin d’aide concernant l’agent Windows Azure Monitor » dans Type de problème.

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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.lkg.xml existe. S’il n’existe pas, créez un ticket en indiquant « AMA ne s’est pas exécuté suffisamment longtemps » dans Résumé et « J’ai besoin d’aide avec l’agent Windows Azure Monitor » dans Type de problème.
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>
```
S’il n’y a pas de nœuds Subscription, la règle DCR n’a pas été analysée correctement. Créez un ticket en indiquant « AMA ne peut pas analyser la configuration DCR » dans Résumé et « J’ai besoin d’aide avec l’agent Windows Azure Monitor » dans Type de problème.

Créer un ticket

Ouvrez une règle de collecte de données puis, dans le menu de gauche, sélectionnez Nouvelle demande de support. Vous pouvez également ouvrir le volet Aide et support et sélectionner Créer une demande de support.
Sélectionnez :
- Type de problème : Technique.
- Abonnement : Sélectionnez l’abonnement où résident vos machines.
- Type de service : Règles de collecte de données et Agent Azure Monitor.
- Votre problème est-il lié à une ressource ? : Oui. Sélectionnez votre machine à l’aide du sélecteur de ressource.
Entrez un Récapitulatif et le Type de problème comme indiqué dans les étapes de résolution des problèmes. Plus les informations sont précises, plus le problème est résolu rapidement.
Sélectionnez Suivant et passez en revue les solutions recommandées pour voir si elles vous sont utiles.
Si ce n’est pas le cas, sélectionnez Suivant et renseignez l’ensemble de détails suivant.
Sélectionnez Suivant, passez en revue les détails finaux, puis sélectionnez Créer.