Partager via


Dependency Agent

Attention

Cet article fait référence à CentOS, une distribution Linux ayant atteint l’état EOL (fin du service). Veuillez considérer votre utilisation et votre planification en conséquence. Pour plus d’informations, consultez les conseils d’aide relatifs à la fin de vie de CentOS.

Dependency Agent collecte les données sur les processus exécutés sur la machine virtuelle et les dépendances de processus externes. Les mises à jour incluent des correctifs de bogues ou la prise en charge de nouvelles fonctions. Cet article décrit les exigences de Dependency Agent et explique comment le mettre à niveau manuellement ou via l’automatisation.

Remarque

Dependency Agent envoie des données de pulsation à la table InsightsMetrics pour laquelle vous subissez des frais d’ingestion de données. Ce comportement est différent de l’agent Azure Monitor qui envoie les données d’intégrité de l’agent à la table Pulsation ; cette dernière est exemptée de frais de collecte de données.

Exigences de Dependency Agent

Installation ou mise à niveau de l’agent de dépendance

Vous pouvez mettre à niveau l’agent Dependency Agent pour Windows et Linux manuellement ou automatiquement en fonction du scénario de déploiement et de l’environnement dans lequel la machine s’exécute, en suivant ces méthodes :

Environnement Méthode d’installation Méthode de mise à niveau
Azure VM Extension de machine virtuelle d’agent Dependency Agent pour Windows et Linux L’agent est automatiquement mis à niveau par défaut, sauf si vous avez configuré votre modèle Azure Resource Manager pour le désactiver en définissant la valeur de la propriété autoUpgradeMinorVersion sur false. La mise à niveau pour la version mineure où la mise à niveau automatique est désactivée, et une mise à niveau majeure suivent la même méthode - désinstallez et réinstallez l’extension.
Images de machines virtuelles Azure personnalisées Installation manuelle de Dependency Agent pour Windows ou Linux La mise à jour des machines virtuelles vers la dernière version de l’agent doit être effectuée à partir de la ligne de commande avec exécution du package d’installation de Windows ou de Linux auto-extractible et du package de script d’installation.
Machines virtuelles non Azure Installation manuelle de Dependency Agent pour Windows ou Linux La mise à jour des machines virtuelles vers la dernière version de l’agent doit être effectuée à partir de la ligne de commande avec exécution du package d’installation de Windows ou de Linux auto-extractible et du package de script d’installation.

Remarque

Dependency Agent est installé automatiquement lorsque VM Insights est activé pour les données de traitement et de connexion via le portail Azure, PowerShell, Déploiement de modèle ARM ou Azure Policy.

Si VM Insights est activé exclusivement pour les données de performances, Dependency Agent n’est pas installé.

Installation ou mise à niveau manuelle de l’agent de dépendance sous Windows

Mettez à jour l’agent sur une machine virtuelle Windows à partir de l’invite de commandes, avec un script ou une autre solution d’automatisation, ou à l’aide de l’assistant d’installation InstallDependencyAgent-Windows.exe.

Prérequis

Utilisation de l’Assistant d’installation

  1. Connectez-vous à la machine avec un compte disposant des droits d’administration.

  2. Exécutez InstallDependencyAgent-Windows.exe pour démarrer l’Assistant d’installation.

  3. Pour désinstaller la version de Dependency Agent, puis installer la dernière version, suivez les instructions de l’Assistant Installation de Dependency Agent.

Depuis la ligne de commande

  1. Connectez-vous à l’ordinateur à l’aide d’un compte avec des droits d’administration.

  2. Exécutez la commande suivante :

    InstallDependencyAgent-Windows.exe /S /RebootMode=manual
    

    Le paramètre /RebootMode=manual empêche la mise à niveau de redémarrer automatiquement la machine si certains processus utilisent des fichiers de la version précédente et ont un verrou sur eux.

  3. Pour confirmer que la mise à niveau a réussi, consultez la section install.log pour plus d’informations sur la configuration. Le répertoire des journaux d’activité est %Programfiles%\Microsoft Dependency Agent\logs.

Installation ou mise à niveau manuelle de l’agent de dépendances sous Linux

La mise à niveau à partir des versions précédentes de Dependency Agent sous Linux est prise en charge et exécutée selon la même commande qu’une nouvelle installation.

Prérequis

curl -L -o DependencyAgent-Linux64.bin https://aka.ms/dependencyagentlinux

Remarque

Curl ne définit pas automatiquement les autorisations d’exécution. Vous devez les définir manuellement à l’aide de chmod :

chmod +x DependencyAgent-Linux64.bin

Depuis la ligne de commande

  1. Connectez-vous à l’ordinateur avec un compte d’utilisateur disposant de privilèges sudo pour exécuter des commandes en tant que racine.

  2. Exécutez la commande suivante :

    sudo <path>/InstallDependencyAgent-Linux64.bin
    

Si le démarrage de Dependency Agent é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.

Désinstaller Dependency Agent

Remarque

Si Dependency Agent a été installé manuellement, il ne s’affiche pas dans le portail Azure et doit être désinstallé manuellement. Il s’affiche uniquement s’il a été installé via le portail Azure, PowerShell, Déploiement de modèle ARM ou Azure Policy.

  1. Dans le menu Machines Virtuelles du portail Azure, sélectionnez votre machine virtuelle.

  2. Sélectionnez Extensions + applications>DependencyAgentWindows ou DependencyAgentLinux>Désinstaller.

    Capture d’écran montrant l’écran Extensions et applications pour une machine virtuelle.

Désinstaller manuellement Dependency Agent sur Windows

Méthode 1 : dans Windows, accédez à Ajouter et supprimer des programmes, recherchez Microsoft Dependency Agent, cliquez sur les points de suspension pour ouvrir le menu contextuel, puis sélectionnez Désinstaller.

Méthode 2 : utilisez le désinstalleur situé dans le dossier Microsoft Dependency Agent, par exemple, C:\Program Files\Microsoft Dependency Agent"\Uninstall_v.w.x.y.exe (où v.w.x.y est le numéro de version).

Désinstaller manuellement Dependency Agent sur Linux

  1. Connectez-vous à l’ordinateur avec un compte d’utilisateur disposant de privilèges sudo pour exécuter des commandes en tant que racine.

  2. Exécutez la commande suivante :

    sudo /opt/microsoft/dependency-agent/uninstall -s
    

Prise en charge de Linux par Dependency Agent

Sachant que Dependency Agent fonctionne au niveau du noyau, la prise en charge dépend aussi de la version du noyau. À partir de la version 9.10.* de Dependency Agent, l’agent prend en charge les noyaux *. Le tableau suivant répertorie les versions majeures et mineures du système d’exploitation Linux ainsi que les versions de noyau prises en charge pour Dependency Agent.

Remarque

Avec Dependency Agent 9.10.15 et versions ultérieures, l’installation n’est pas bloquée pour les versions de noyau non prises en charge, mais l’agent s’exécute en mode dégradé. Dans ce mode, les données de connexion et de port stockées dans les tables VMConnection et VMBoundport ne sont pas collectées. La table VMProcess peut contenir des données, mais elles seront minimales.

Distribution Version du SE Version du noyau
Red Hat Linux 8 8,6 4.18.0-372.*el8.x86_64, 4.18.0-372.*el8_6.x86_64
8.5 4.18.0-348.*el8_5.x86_644.18.0-348.*el8.x86_64
8,4 4.18.0-305.*el8.x86_64, 4.18.0-305.*el8_4.x86_64
8.3 4.18.0-240.*el8_3.x86_64
8,2 4.18.0-193.*el8_2.x86_64
8.1 4.18.0-147.*el8_1.x86_64
8.0 4.18.0-80.*el8.x86_64
4.18.0-80.*el8_0.x86_64
Red Hat Linux 7 7.9 3.10.0-1160
7.8 3.10.0-1136
7,7 3.10.0-1062
7.6 3.10.0-957
7.5 3.10.0-862
7.4 3.10.0-693
Red Hat Linux 6 6.10 2.6.32-754
6.9 2.6.32-696
CentOS Linux 8 8,6 4.18.0-372.*el8.x86_64, 4.18.0-372.*el8_6.x86_64
8.5 4.18.0-348.*el8_5.x86_644.18.0-348.*el8.x86_64
8,4 4.18.0-305.*el8.x86_64, 4.18.0-305.*el8_4.x86_64
8.3 4.18.0-240.*el8_3.x86_64
8,2 4.18.0-193.*el8_2.x86_64
8.1 4.18.0-147.*el8_1.x86_64
8.0 4.18.0-80.*el8.x86_64
4.18.0-80.*el8_0.x86_64
CentOS Linux 7 7.9 3.10.0-1160
7.8 3.10.0-1136
7,7 3.10.0-1062
CentOS Linux 6 6.10 2.6.32-754.3.5
2.6.32-696.30.1
6.9 2.6.32-696.30.1
2.6.32-696.18.7
Serveur Ubuntu 20.04 5.8
5.4*
18,04 5.3.0-1020
5.0 (inclut un noyau optimisé pour Azure)
4.18*
4.15*
16.04.3 4.15.*
16.04 4.13.*
4.11.*
4.10.*
4.8.*
4.4.*
14.04 3.13.*-generic
4.4.*-generic
SUSE Linux 12 Enterprise Server 12 SP5 4.12.14-122.*-default, 4.12.14-16.*-azure
12 SP4 4.12.* (inclut un noyau optimisé pour Azure)
12 SP3 4.4.*
12 SP2 4.4.*
SUSE Linux 15 Enterprise Server 15 SP1 4.12.14-197.*-default, 4.12.14-8.*-azure
15 4.12.14-150.*-default
Debian 9 4,9

Notes

L’agent de dépendance n’est pas pris en charge pour les machines virtuelles Azure avec des processeurs ARM Ampere Altra.

Étapes suivantes

Si vous souhaitez arrêter l’analyse de vos machines virtuelles pendant un certain temps ou supprimer entièrement VM Insights, consultez Désactiver l’analyse de vos machines virtuelles dans VM Insights.