Tous les produits
Search
Centre de documentation

Cloud Monitor:Installer et désinstaller l'agent Cloud Monitor

Dernière mise à jour :Aug 08, 2026

L'agent Cloud Monitor collecte les métriques de surveillance depuis le système d'exploitation d'un hôte et transmet les données à Cloud Monitor pour analyse. Vous pouvez visualiser l'état de l'hôte sous forme de graphiques et créer des règles d'alerte pour les métriques clés afin d'identifier et de résoudre rapidement les problèmes. Cette rubrique explique comment installer, gérer et désinstaller l'agent Cloud Monitor.

Important

La gestion de l'agent Cloud Monitor requiert un compte administrateur (l'utilisateur root sous Linux ou l'utilisateur Administrator sous Windows). L'utilisation d'un compte administrateur comporte certains risques, tels que des problèmes de stabilité du système ou de sécurité des données. Agissez avec prudence.

Avant de commencer

Version de l'agent

La version C++ 3.X est recommandée.

Les versions Java et Go de l'agent ne sont plus maintenues. La version C++ consomme nettement moins de ressources que les versions Go et Java. Par conséquent, nous vous recommandons d'installer la version C++ de l'agent.

Le tableau ci-dessous compare les chemins des scripts de contrôle entre les anciennes versions et les versions actuelles de l'agent :

Version

Chemin du script de contrôle

Notes

Ancienne (Java/Go)

/usr/local/cloudmonitor/wrapper/bin/cloudmonitor.sh

Obsolète ; le répertoire wrapper n'existe que dans les anciennes versions

Actuelle (C++)

/usr/local/cloudmonitor/cloudmonitorCtl.sh

Recommandée ; aucun répertoire wrapper

Remarque

Le répertoire /usr/local/cloudmonitor/wrapper/ n'existe pas dans la version C++. Si l'exécution d'une commande héritée renvoie une erreur « no such file or directory » (fichier ou répertoire introuvable), cela signifie que la version C++ est installée sur votre hôte. Utilisez le script cloudmonitorCtl.sh pour toutes les opérations.

  • Facturation : L'installation de l'agent Cloud Monitor, la consultation des graphiques de surveillance des hôtes et la création de règles d'alerte sont gratuites.

  • Configuration système requise

    Système d'exploitation

    Architecture matérielle

    Windows 7, Windows Server 2008 R2 et versions ultérieures

    i386, AMD64

    Linux 2.6.23 et versions ultérieures (doit inclure la bibliothèque Glibc)

    i386, AMD64, ARM64

    Pour plus d'informations sur les chemins d'installation pris en charge, la consommation de ressources et les journaux de l'agent C++, consultez la rubrique Présentation de l'agent Cloud Monitor.

Exigences réseau de l'hôte

  • L'hôte doit pouvoir accéder à Internet, soit directement, soit via une passerelle NAT ou un serveur proxy.

  • Configuration de la liste d'autorisation du pare-feu

    Si un pare-feu ou un groupe de sécurité ECS est configuré pour l'hôte, ajoutez les adresses et les ports du serveur Cloud Monitor à la liste d'autorisation.

    Remarque

    Les hôtes tiers utilisent le port 443 pour envoyer les données et effectuer les vérifications de heartbeat via Internet.

    Adresse du serveur

    Méthode de requête

    Port du serveur

    Description

    Service de heartbeat

    nslookup cms-cloudmonitor.aliyun.com ou ping cms-cloudmonitor.aliyun.com

    8080, 3128, 443

    Utilisé pour les vérifications de heartbeat de l'agent.

    Envoi de données

    VPC : nslookup metrichub-<regionid>.aliyun.com

    Internet : nslookup metrichub-cms-<regionid>.aliyuncs.com

    80, 443

    Utilisé pour envoyer les données de surveillance.

    • <regionid> correspond à l'ID de région de l'hôte Alibaba Cloud. Exécutez la commande suivante pour obtenir l'ID de région : curl http://100.100.100.200/latest/meta-data/region-id.

    • L'envoi de données via Internet est disponible uniquement dans les régions Chine (Hangzhou), Chine (Shanghai), Chine (Pékin) et Chine (Shenzhen).

    Service de métadonnées

    Bloc CIDR fixe : 100.100.0.0/16

    0-65535

    Obtient les informations sur l'instance (hôtes Alibaba Cloud uniquement).

Comparaison des méthodes d'installation

Installez l'agent automatiquement ou manuellement en fonction du type d'hôte et de l'environnement réseau.

Méthode d'installation

Cas d'utilisation

Avantages

Installation automatique depuis la console

Instances ECS Alibaba Cloud et hôtes tiers gérés par Cloud Assistant.

Méthode recommandée. Cette approche simple prend en charge les opérations par lot et ne nécessite pas de connexion à l'hôte.

Installation manuelle

Scénarios où l'installation automatique n'est pas disponible, hôtes tiers non gérés, environnements internes ou hors ligne, et déploiements utilisant des scripts d'automatisation tels qu'Ansible.

Grande flexibilité, adaptée à tous les environnements complexes.

Notes sur l'installation

  • L'installation de l'agent Cloud Monitor n'affecte pas les activités commerciales et ne nécessite pas le redémarrage de votre instance ECS. Après l'installation, l'agent démarre automatiquement et commence à collecter les données de surveillance. Si vous craignez un impact, installez l'agent pendant les heures creuses.

  • L'installation automatique ne modifie pas l'état de connexion du compte root (par exemple, noLogin). Même si la connexion directe en tant que root est désactivée sur l'hôte, Cloud Assistant Agent (aliyun-service) peut toujours effectuer l'installation au nom de root.

  • L'agent Cloud Monitor (argusagent) et l'agent de collecte Log Service (loongcollector) sont des composants indépendants sans dépendance l'un envers l'autre. L'installation, la désinstallation ou le redémarrage de l'un n'affecte pas l'autre.

  • Pour les hôtes non ECS, tels que les serveurs d'applications légers, vous devez installer l'agent Cloud Monitor pour afficher les métriques au niveau du système d'exploitation, telles que l'utilisation de la mémoire et du disque, dans la console. Les métriques de surveillance de base, telles que l'utilisation du CPU et le trafic réseau, sont collectées depuis l'hôte et ne nécessitent pas l'agent.

Installation automatique (recommandée)

Cette méthode s'applique aux hôtes Alibaba Cloud et aux instances gérées par Alibaba Cloud.

  1. Accédez à la page Surveillance des hôtes.

  2. Sur la page Host Monitoring, sélectionnez les hôtes sur lesquels vous souhaitez installer ou mettre à niveau l'agent, puis cliquez sur Batch Install/Upgrade Agent dans le coin inférieur gauche. Dans la boîte de dialogue qui s'affiche, cliquez sur OK.

    Remarque
    • Pour les hôtes Alibaba Cloud nouvellement achetés, activez l'option Automatically Install CloudMonitor Agent on Newly Purchased ECS Instances dans le coin supérieur droit. Une fois activée, l'agent Cloud Monitor est automatiquement installé sur les nouveaux hôtes ECS. Sinon, vous devez installer l'agent manuellement.

    • L'installation ou la mise à niveau prend environ 5 minutes. Lorsque le Agent Status d'un hôte cible passe de Installing à Running, l'opération est terminée.

Installation manuelle

Remarque

Effectuez une installation manuelle si l'installation automatique échoue ou si vous procédez à l'installation dans un environnement spécifique. Si une version ancienne ou corrompue de l'agent est déjà présente sur l'hôte, désinstallez-la au préalable.

  1. Accédez à la page Surveillance des hôtes.

  2. Sur la page Host Monitoring, cliquez sur Opérations sur l'hôte et l'agent au-dessus de la liste des hôtes, puis sélectionnez Installation manuelle dans le menu déroulant.

  3. Dans la boîte de dialogue Manual Installation, suivez les étapes ci-dessous pour terminer l'installation.

Hôtes Alibaba Cloud

Linux

  1. Dans le champ Region, sélectionnez la région où se trouve l'hôte Alibaba Cloud.

  2. Dans la zone Installation Command, cliquez sur l'icône image.png à côté de la commande pour la copier. Sélectionnez Linux ou Windows comme système d'exploitation pour obtenir la commande d'installation correspondante dans la zone Commande d'installation.

  3. Connectez-vous à l'hôte en tant qu'utilisateur root.

  4. Collez et exécutez la commande d'installation.

  5. Exécutez la commande suivante pour vérifier le statut de l'agent :

    ps aux | grep argusagent | grep -v grep

    Si la sortie ressemble à ce qui suit, l'agent fonctionne correctement.

    root      2284  0.0  0.0  22516  1488 ?        Ss   Sep14   0:00 /usr/local/cloudmonitor/bin/argusagent -d
    root      2286  0.2  0.3 939652 14300 ?        Sl   Sep14   3:15 /usr/local/cloudmonitor/bin/argusagent

Windows

  1. Dans le champ Region, sélectionnez la région où se trouve l'hôte Alibaba Cloud.

  2. Téléchargez le package de l'agent 32 bits ou 64 bits en fonction du système d'exploitation de l'hôte.

  3. Connectez-vous à l'hôte en tant qu'utilisateur Administrator.

  4. Créez le répertoire C:\Program Files\Alibaba\cloudmonitor. Téléchargez le package du plugin sur l'hôte et décompressez-le dans le répertoire C:\Program Files\Alibaba\cloudmonitor.

  5. Pour ouvrir l'Command Prompt, appuyez sur Win+R pour ouvrir la boîte de dialogue Run, saisissez cmd, puis cliquez sur OK.

  6. Exécutez les commandes suivantes pour installer l'agent Cloud Monitor :

    1. cd C:\Program Files\Alibaba\cloudmonitor\bin

    2. argusagent_service.exe install

  7. Exécutez la commande net start argusagent pour démarrer l'agent Cloud Monitor.

  8. Vérifiez le statut de l'agent.

    1. Pour ouvrir la fenêtre Service, appuyez sur Win+R pour ouvrir la boîte de dialogue Run, saisissez services.msc, puis cliquez sur OK.

    2. Vérifiez le statut du service argusagent. Si le statut est Running, l'agent fonctionne correctement.

Hôtes tiers

Linux

  1. Dans le champ Region, sélectionnez une région pour recevoir les données de surveillance.

  2. Dans la boîte de dialogue Installation manuelle, configurez les paramètres requis pour générer la commande d'installation. Dans la zone Installation Command, cliquez sur l'icône de copie image.png pour copier la commande.

  3. Connectez-vous à l'hôte en tant qu'utilisateur root.

  4. Collez et exécutez la commande d'installation.

  5. Exécutez la commande suivante pour vérifier le statut de l'agent :

    ps aux | grep argusagent | grep -v grep

    Si la sortie ressemble à ce qui suit, l'agent fonctionne correctement.

    root      2284  0.0  0.0  22516  1488 ?        Ss   Sep14   0:00 /usr/local/cloudmonitor/bin/argusagent -d
    root      2286  0.2  0.3 939652 14300 ?        Sl   Sep14   3:15 /usr/local/cloudmonitor/bin/argusagent

Windows

  1. Dans le champ Region, sélectionnez une région pour recevoir les données de surveillance.

  2. Téléchargez le package de l'agent (32 bits ou 64 bits, selon le système d'exploitation de l'hôte) et le fichier de configuration accesskey.properties.

  3. Connectez-vous à l'hôte en tant qu'utilisateur Administrator.

  4. Créez le répertoire C:\Program Files\Alibaba\cloudmonitor. Téléchargez le package du plugin sur l'hôte et extrayez-le dans le répertoire C:\Program Files\Alibaba\cloudmonitor.

  5. Téléchargez le fichier de configuration sur l'hôte et placez-le dans le répertoire C:\Program Files\Alibaba\cloudmonitor\local_data\conf.

  6. Exécutez les commandes suivantes pour installer l'agent Cloud Monitor :

    1. cd C:\Program Files\Alibaba\cloudmonitor\bin

    2. argusagent_service.exe install

  7. Exécutez la commande net start argusagent pour démarrer l'agent Cloud Monitor.

  8. Vérifiez le statut de l'agent.

    1. Pour ouvrir la fenêtre Service, appuyez sur Win+R pour ouvrir la boîte de dialogue Run, saisissez services.msc, puis cliquez sur OK.

    2. Vérifiez le statut du service argusagent. Si le statut est Running, l'agent fonctionne correctement.

Problème courant

Si un hôte tiers doté de l'agent Cloud Monitor ne peut pas accéder à Internet, l'agent ne peut pas envoyer les données de surveillance. Pour résoudre ce problème, configurez un serveur proxy en modifiant le fichier de configuration agent.properties correspondant à votre système d'exploitation.

  • Chemin Linux : /usr/local/cloudmonitor/local_data/conf/agent.properties

  • Chemin Windows : C:\Program Files\Alibaba\cloudmonitor\local_data\conf\agent.properties

Pour les étapes détaillées, consultez la rubrique Comment utiliser un serveur proxy Nginx pour envoyer les données de surveillance depuis un hôte tiers ?.

Dépannage

Si l'installation ou le démarrage de l'agent Cloud Monitor échoue, reportez-vous aux solutions suivantes.

Scénario 1 : Cliquer plusieurs fois sur Installer ou Démarrer dans la console n'a aucun effet

Connectez-vous à l'hôte et exécutez la commande suivante pour démarrer Cloud Assistant (aliyun-service). Réessayez ensuite l'opération dans la console.

systemctl start aliyun-service

Scénario 2 : Échec de l'installation sur un serveur d'applications léger

Effectuez les vérifications suivantes dans l'ordre :

  1. Vérifiez la connectivité du service de métadonnées. Exécutez la commande suivante :

    curl http://100.100.100.200/latest/meta-data/region-id

    Si un ID de région est retourné, la connectivité est normale.

  2. Vérifiez la connectivité de l'URL de téléchargement de l'agent. Remplacez <region> par votre ID de région réel et exécutez :

    ping cms-agent-<region>.oss-<region>.aliyuncs.com
  3. Vérifiez si le processus de l'agent est en cours d'exécution :

    ps -ef | grep cms
  4. Si toutes les vérifications sont concluantes mais que l'installation échoue toujours, utilisez la méthode d'installation manuelle. Pour les étapes détaillées, consultez la section Installation manuelle de cette rubrique.

Scénario 3 : Le statut de l'agent indique Réinstallation/Mise à niveau ou l'opération échoue

Vérifiez si Cloud Assistant Agent (aliyun-service) est en cours d'exécution. Si ce n'est pas le cas, redémarrez-le ou réparez-le, puis réessayez l'installation de l'agent Cloud Monitor. Si le problème persiste, réinstallez manuellement l'agent Cloud Monitor.

Scénario 4 : Échec de la connexion de l'agent (général)

  1. Désinstallez l'agent Cloud Monitor, puis réinstallez-le.

  2. Si le problème persiste, essayez d'installer une version spécifique (par exemple, la version 1.0.6) pour déterminer si le problème est lié à la version.

Migration depuis un agent hérité

Si votre hôte exécute un ancien agent Java ou Go — identifiable par la présence du répertoire /usr/local/cloudmonitor/wrapper/ — suivez les étapes ci-dessous pour migrer vers la version C++, qui offre une consommation de ressources réduite et des mises à jour continues des fonctionnalités.

Étapes (Linux)

  1. Arrêtez l'agent hérité :

    bash /usr/local/cloudmonitor/wrapper/bin/cloudmonitor.sh stop
  2. Désinstallez l'agent hérité :

    bash /usr/local/cloudmonitor/wrapper/bin/cloudmonitor.sh remove
    rm -rf /usr/local/cloudmonitor
  3. Installez la version C++ en suivant la section Installation manuelle de ce document.

  4. Démarrez l'agent C++ :

    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh start
  5. Vérifiez que l'agent est en cours d'exécution :

    ps aux | grep argusagent | grep -v grep

Opérations courantes

Démarrer l'agent

  • Linux

    Exécutez la commande suivante pour démarrer l'agent Cloud Monitor :

    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh start
  • Windows

    Exécutez la commande suivante pour démarrer l'agent Cloud Monitor :

    net start argusagent

Vérifier le statut de l'agent

  • Linux

    Exécutez la commande suivante pour vérifier le statut de l'agent :

    ps aux | grep argusagent | grep -v grep

    Si la sortie ressemble à ce qui suit, l'agent fonctionne correctement.

    root      2284  0.0  0.0  22516  1488 ?        Ss   Sep14   0:00 /usr/local/cloudmonitor/bin/argusagent -d
    root      2286  0.2  0.3 939652 14300 ?        Sl   Sep14   3:15 /usr/local/cloudmonitor/bin/argusagent
  • Windows

    1. Pour ouvrir la fenêtre Service, appuyez sur Win+R pour ouvrir la boîte de dialogue Run, saisissez services.msc, puis cliquez sur OK.

    2. Vérifiez le statut du service argusagent.

      Si le statut est En cours d'exécution, l'agent fonctionne correctement.

Arrêter l'agent

  • Linux

    Exécutez la commande suivante pour arrêter l'agent Cloud Monitor :

    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh stop
  • Windows

    Exécutez la commande suivante pour arrêter l'agent Cloud Monitor :

    net stop argusagent

Désinstaller l'agent

Après la désinstallation de la version C++ de l'agent Cloud Monitor, vous ne pouvez plus surveiller l'hôte en temps réel, mais les données de surveillance historiques restent disponibles.

  • Linux

    # 1. Stop the Cloud Monitor agent.
    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh stop
    # 2. Uninstall the Cloud Monitor agent.
    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh uninstall
    # 3. Delete the cloudmonitor directory.
    rm -rf /usr/local/cloudmonitor
  • Windows

    # 1. Stop the Cloud Monitor agent.
    net stop argusagent
    # 2. Uninstall the Cloud Monitor agent.
    "C:\Program Files\Alibaba\cloudmonitor\bin\argusagent_service.exe" uninstall
    # 3. Delete the cloudmonitor directory.
    cd "C:\Program Files\Alibaba"
    rd /s /q cloudmonitor
    Remarque

    Si le chemin d'installation contient des espaces (par exemple, C:\Program Files\Alibaba\cloudmonitor), vous devez entourer le chemin complet de l'exécutable de guillemets doubles dans la commande de désinstallation, comme indiqué à l'étape 2. Sans les guillemets, Windows ne parvient pas à localiser l'exécutable et renvoie l'erreur '...' is not recognized as an internal or external command.

    Si vous rencontrez des erreurs d'autorisation ou des échecs d'exécution de commande, vérifiez que l'utilisateur Windows actuel dispose des privilèges Administrator et que le chemin du fichier est correct.

FAQ

Q : Pourquoi certaines métriques de surveillance (telles que l'utilisation de la mémoire et du disque) ne s'affichent-elles pas ou sont-elles manquantes après l'installation de l'agent Cloud Monitor ?

R :

  1. Il y a un bref délai entre la collecte et l'envoi des données. Attendez quelques minutes, puis actualisez la console.

  2. Vérifiez si le statut de l'agent est En cours d'exécution. Si le statut est Arrêté, accédez à la page Surveillance des hôtes dans la console pour démarrer l'agent, ou connectez-vous à l'hôte et exécutez :

    systemctl start aliyun-service
  3. Notez la différence entre la surveillance de base et la surveillance du système d'exploitation : les métriques de surveillance de base (telles que l'utilisation du CPU et le trafic réseau) sont collectées depuis l'hôte et ne nécessitent pas l'agent. Les métriques au niveau du système d'exploitation, telles que l'utilisation de la mémoire et du disque, nécessitent l'agent Cloud Monitor. Si l'agent n'est pas installé ou ne fonctionne pas correctement, ces métriques ne sont pas disponibles.

  4. Si les alertes ne se déclenchent pas comme prévu (par exemple, aucune alerte lorsque l'utilisation du disque atteint 100 %), vérifiez que l'agent est installé et en cours d'exécution. Les données de surveillance doivent être envoyées avec succès pour que les règles d'alerte prennent effet.

Documentation connexe

FAQ

API