Tous les produits
Search

Ce produit

    Application Real-Time Monitoring Service:Uninstall the ARMS agent for Go

    Centre de documentation

    Application Real-Time Monitoring Service:Uninstall the ARMS agent for Go

    Dernière mise à jour :Aug 10, 2026

    Pour arrêter la surveillance de vos applications Go avec Application Real-Time Monitoring Service (ARMS), supprimez l'agent ARMS. La méthode de désinstallation dépend du mode de déploiement de l'agent.

    Méthode de déploiement Méthode de désinstallation
    Cluster ACK (toutes les applications) Désinstaller depuis un cluster ACK
    Cluster ACK (application unique) Désinstaller depuis une application unique dans un cluster ACK
    Installation manuelle (instgo) Supprimer un agent installé manuellement

    Désinstaller depuis un cluster ACK

    La désinstallation du composant ack-onepilot retire l'agent ARMS de toutes les applications du cluster.

    Avertissement

    Le composant ack-onepilot est partagé par ARMS et Microservices Engine (MSE). Avant de le désinstaller, assurez-vous que MSE n'est pas utilisé. La désinstallation de ack-onepilot alors que MSE est actif rend MSE indisponible.

    Utiliser la console ACK

    1. Connectez-vous à la console Container Service for Kubernetes (ACK). Sur la page Clusters, cliquez sur le nom du cluster cible.

    2. Dans le volet de navigation de gauche, choisissez Operations > Add-ons. Recherchez ack-onepilot dans le coin supérieur droit.

    3. Sur la carte ack-onepilot, cliquez sur Uninstall.

    4. Dans la boîte de dialogue de confirmation, cliquez sur OK.

    5. Redémarrez les pods de votre application pour appliquer la modification.

    Utiliser la CLI

    1. Exécutez la commande Helm suivante pour désinstaller ack-onepilot :

      helm3 uninstall --namespace ack-onepilot ack-onepilot

    2. Redémarrez les pods de votre application pour appliquer la modification.

    Vérifier la désinstallation

    Après la désinstallation, vérifiez que les pods ack-onepilot ne sont plus en cours d'exécution :

    kubectl get pods -n ack-onepilot

    Si le namespace est vide ou si la commande renvoie No resources found, la désinstallation a réussi.

    Désinstaller depuis une application unique dans un cluster ACK

    Pour retirer l'agent ARMS d'une application spécifique sans affecter les autres applications du cluster :

    1. Connectez-vous à la console ACK. Sur la page Clusters, localisez le cluster cible et cliquez sur Applications dans la colonne Actions.

    2. Sur la page Deployments, recherchez l'application cible. Dans la colonne Actions, choisissez More > View in YAML.

    3. Dans la boîte de dialogue Edit YAML, supprimez les labels ajoutés lors de l'installation de l'agent ARMS, puis cliquez sur Update.

    4. Redémarrez le pod de l'application pour appliquer la modification.

    Vérifier la désinstallation

    Vérifiez que les libellés liés à ARMS ont été supprimés du pod :

    kubectl get pod <pod-name> -n <namespace> --show-labels

    Confirmez qu'aucun libellé spécifique à ARMS n'apparaît dans la sortie.

    Supprimer un agent installé manuellement

    Si vous avez installé l'agent ARMS à l'aide de instgo (instrumentation au moment de la compilation), supprimez-le en recompilant votre application avec la chaîne d'outils Go standard. instgo restaure automatiquement votre base de code une fois la compilation terminée ; aucune modification du code n'est donc nécessaire.

    1. (Facultatif) Recompilez votre application avec go build au lieu de instgo :

      go build -o <your-app-binary>

    2. Déployez le binaire recompilé dans votre environnement de production, en remplaçant la version précédemment instrumentée.

    Nettoyer les fichiers résiduels de l'instrumentation au moment de la compilation

    Lors de l'instrumentation au moment de la compilation, instgo modifie temporairement les fichiers source et les restaure une fois la compilation terminée. Un nettoyage manuel n'est nécessaire que dans les cas suivants :

    • La compilation a été arrêtée ou interrompue de force.

    • instgo s'est arrêté de manière inattendue en raison d'un panic.

    Exécutez la commande clean pour restaurer vos fichiers source :

    Linux et macOS

    ./instgo clean

    Windows

    .\instgo.exe clean

    Supprimer instgo et son cache

    Pour supprimer complètement instgo de votre système :

    1. Supprimez le répertoire de cache de l'agent. Si vous avez spécifié un répertoire de cache personnalisé avec l'option --cacheDir lors de la compilation, supprimez ce répertoire. Sinon, supprimez le répertoire de cache par défaut.

      Linux et macOS

      # Custom cache directory
rm -rf <your-cache-dir>/aliyun-go-agent

# Default cache directory
rm -rf /opt/.opt/aliyun-go-agent

      Windows

      # Custom cache directory
rmdir <your-cache-dir>\aliyun-go-agent -Recurse

# Default cache directory
rmdir C:\ProgramData\.opt\aliyun-go-agent -Recurse

    2. Supprimez le binaire instgo.

    Éléments supprimés

    Élément Emplacement Supprimé par
    Cache de l'agent /opt/.opt/aliyun-go-agent (Linux/macOS) ou C:\ProgramData\.opt\aliyun-go-agent (Windows) Suppression du cache (étape 1)
    Binaire instgo Votre répertoire de travail Suppression manuelle (étape 2)
    Modifications des fichiers source Votre base de code Restauration automatique (ou instgo clean)