Activer VM Insights pour une machine virtuelle hybride

Cet article explique comment activer VM Insights pour une machine virtuelle en dehors d’Azure, y compris des environnements locaux et autres clouds.

Important

La méthode recommandée pour activer des machines virtuelles hybrides consiste tout d’abord à activer Azure Arc pour serveurs afin que les machines virtuelles puissent être activées pour VM Insights à l’aide de processus similaires aux machines virtuelles Azure. Cet article explique comment intégrer des machines virtuelles hybrides si vous choisissez de ne pas utiliser Azure Arc.

Prérequis

Vue d’ensemble

Les machines virtuelles en dehors d’Azure nécessitent les mêmes agent Log Analytics et Dependency Agent que ceux utilisés pour les machines virtuelles Azure. Étant donné que vous ne pouvez pas utiliser d’extensions de machine virtuelle pour installer les agents, vous devez les installer manuellement dans le système d’exploitation invité ou les installer par le biais d’une autre méthode.

Pour plus d’informations sur le déploiement de l’agent Log Analytics, consultez Connecter des ordinateurs Windows à Azure Monitor ou Connecter des ordinateurs Linux à Azure Monitor. Des détails pour l’agent Dependency Agent sont fournis dans cet article.

Configuration requise du pare-feu

La configuration requise du pare-feu pour l’agent Log Analytics est fournie dans Présentation de l’agent Log Analytics. L’agent Map Dependency de VM Insights ne transmet pas de données par lui-même et ne requiert pas de modifications des pare-feu ou des ports. Log Analytics Agent transmet toujours les données Map au service Azure Monitor, directement ou par le biais de la passerelle Operations Management Suite, si vos stratégies de sécurité n’autorisent pas les ordinateurs du réseau à se connecter à Internet.

Agent de dépendances

Notes

Les informations suivantes décrites dans cette section s’appliquent également à la solution Service Map.

Vous pouvez télécharger le Dependency Agent à partir des emplacements suivants :

Fichier Système d''exploitation Version SHA-256
InstallDependencyAgent-Windows.exe Windows 9.10.7.12710 CA29CC328F991D7301FD0360F4F56DF78275545BB8CDA853679899CA885E96F0
InstallDependencyAgent-Linux64.bin Linux 9.10.7.12710 98380DBEB2E2A5848F2202BC22422C68B20B62090C1BFC1DECAB37ED5451ED8C

Installer l’agent de dépendances sous Windows

Vous pouvez installer Dependency Agent manuellement sur les ordinateurs Windows en exécutant InstallDependencyAgent-Windows.exe. Si vous exécutez ce fichier exécutable sans aucune option, il démarre un assistant de configuration que vous pouvez suivre pour une installation interactive de l’agent. Pour installer ou désinstaller l’agent, vous devez disposer de privilèges Administrateur sur le système d’exploitation invité.

Le tableau suivant répertorie les paramètres pris en charge par le programme de configuration pour l’agent à partir de la ligne de commande.

Paramètre Description
/? Retourne la liste des options de ligne de commande.
/S Effectue une installation silencieuse sans interaction utilisateur.

Par exemple, pour exécuter le programme d’installation avec le paramètre /?, saisissez InstallDependencyAgent-Windows.exe /? .

Par défaut, les fichiers Dependency Agent pour Windows sont installés dans le répertoire C:\Program Files\Microsoft Dependency Agent. Si le démarrage de l’agent de dépendances échoue une fois l’installation terminée, recherchez des informations détaillées sur l’erreur dans les journaux d’activité. Le répertoire des journaux d’activité est %Programfiles%\Microsoft Dependency Agent\logs.

Script PowerShell

Pour télécharger et installer l’agent, utilisez l’exemple de script PowerShell suivant :

Invoke-WebRequest "https://aka.ms/dependencyagentwindows" -OutFile InstallDependencyAgent-Windows.exe

.\InstallDependencyAgent-Windows.exe /S

Installer l’agent de dépendances sous Linux

Dependency Agent est installé sur les ordinateurs Linux avec InstallDependencyAgent-Linux64.bin, script shell comportant un fichier binaire à extraction automatique. Vous pouvez exécuter le fichier à l’aide de sh ou ajouter des autorisations d’exécution au fichier lui-même.

Notes

L’accès racine est requis pour installer ou configurer l’agent.

Paramètre Description
-help Récupérez la liste des options de ligne de commande.
-S Effectuez une installation silencieuse sans invite utilisateur.
--check Vérifiez les autorisations et le système d’exploitation, sans installer l’agent.

Par exemple, pour exécuter le programme d’installation avec le paramètre -help, saisissez InstallDependencyAgent-Linux64.bin -help. Installez Dependency Agent pour Linux en tant que racine en exécutant la commande sh InstallDependencyAgent-Linux64.bin.

Si le démarrage de l’agent de dépendances échoue, recherchez des informations détaillées sur l’erreur dans les journaux d’activité. Sur les agents Linux, le répertoire des journaux est /var/opt/microsoft/dependency-agent/log.

Les fichiers de l’agent de dépendances sont placés dans les répertoires suivants :

Fichiers Emplacement
Fichiers principaux /opt/microsoft/dependency-agent
Fichiers journaux /var/opt/microsoft/dependency-agent/log
Fichiers de configuration /etc/opt/microsoft/dependency-agent/config
Fichiers exécutables de service /opt/microsoft/dependency-agent/bin/microsoft-dependency-agent
/opt/microsoft/dependency-agent/bin/microsoft-dependency-agent-manager
Fichiers de stockage binaires /var/opt/microsoft/dependency-agent/storage

Script shell

Utilisez l’exemple de script d’interpréteur de commandes suivant pour télécharger et installer l’agent :

wget --content-disposition https://aka.ms/dependencyagentlinux -O InstallDependencyAgent-Linux64.bin
sudo sh InstallDependencyAgent-Linux64.bin -s

DSC (Desired State Configuration)

Pour déployer l’agent de dépendances avec la configuration de l'état souhaité, vous pouvez utiliser le module xPSDesiredStateConfiguration avec l’exemple de code suivant :

configuration VMInsights {

    Import-DscResource -ModuleName xPSDesiredStateConfiguration

    $DAPackageLocalPath = "C:\InstallDependencyAgent-Windows.exe"

    Node localhost
    {
        # Download and install the Dependency agent
        xRemoteFile DAPackage
        {
            Uri = "https://aka.ms/dependencyagentwindows"
            DestinationPath = $DAPackageLocalPath
        }

        xPackage DA
        {
            Ensure="Present"
            Name = "Dependency Agent"
            Path = $DAPackageLocalPath
            Arguments = '/S'
            ProductId = ""
            InstalledCheckRegKey = "HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\DependencyAgent"
            InstalledCheckRegValueName = "DisplayName"
            InstalledCheckRegValueData = "Dependency Agent"
            DependsOn = "[xRemoteFile]DAPackage"
        }
    }
}

Dépannage

La machine virtuelle n’apparaît pas sur la carte

Si votre installation de l’agent de dépendances a réussi, mais que vous ne voyez pas votre ordinateur sur la carte, diagnostiquez le problème en procédant comme suit.

  1. L’agent de dépendances est-il correctement installé ? Vous pouvez vous en assurer en vérifiant si le service est installé et en cours d’exécution.

    Windows : recherchez le service nommé « Microsoft Dependency Agent ».

    Linux : recherchez « microsoft-dependency-agent » dans les processus en cours d’exécution.

  2. Utilisez-vous le niveau tarifaire Gratuit de Log Analytics ? Le plan Gratuit autorise jusqu’à 5 ordinateurs uniques. Les ordinateurs suivants ne s’affichent pas sur la carte, même si les cinq précédents n’envoient plus de données.

  3. L’ordinateur envoie-t-il des données de journal et de performances aux journaux Azure Monitor ? Exécutez la requête suivante sur votre ordinateur :

    Usage | where Computer == "computer-name" | summarize sum(Quantity), any(QuantityUnit) by DataType
    

    Retourne-t-elle un ou plusieurs résultats ? Les données sont-elles récentes ? Dans ce cas, votre agent Log Analytics fonctionne correctement et communique avec le service. Si ce n’est pas le cas, vérifiez l’agent sur votre serveur : Résolution des problèmes de l’agent Log Analytics pour Windows ou Résolution des problèmes de l’agent Log Analytics pour Linux.

L’ordinateur s’affiche sur la carte, mais n’a aucun processus

Si vous voyez votre serveur sur la carte, mais qu’il ne comporte aucune donnée de processus ou de connexion, cela indique que l’agent de dépendances est installé et en cours d’exécution, mais que le pilote en mode noyau ne s’est pas chargé.

Vérifiez le fichier C:\Program Files\Microsoft Dependency Agent\logs\wrapper.log (Windows) ou le fichier /var/opt/microsoft/dependency-agent/log/service.log (Linux). Les dernières lignes du fichier doivent indiquer la raison pour laquelle le noyau ne s’est pas chargé. Par exemple, le noyau n’est peut-être pas pris en charge sous Linux si vous l’avez mis à jour.

Étapes suivantes

Une fois la surveillance activée pour vos machines virtuelles, ces informations sont disponibles pour analyse avec VM Insights.