Todos os produtos
Search
Central de documentação

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

Última atualização: Jun 27, 2026

Para interromper o monitoramento das suas aplicações Go com o Application Real-Time Monitoring Service (ARMS), remova o agente do ARMS. O método de desinstalação varia conforme a forma de implantação do agente.

Método de implantação

Método de desinstalação

Cluster ACK (todas as aplicações)

Desinstalar de um cluster ACK

Cluster ACK (aplicação única)

Desinstalar de uma única aplicação em um cluster ACK

Instalação manual (instgo)

Remover um agente instalado manualmente

Desinstalar de um cluster ACK

Desinstalar o componente ack-onepilot remove o agente do ARMS de todas as aplicações no cluster.

Aviso

O componente ack-onepilot é compartilhado pelo ARMS e pelo Microservices Engine (MSE). Antes de desinstalá-lo, verifique se o MSE não está em uso. Desinstalar o ack-onepilot enquanto o MSE está ativo torna o MSE indisponível.

Usar o console do ACK

  1. Faça login no console do Container Service for Kubernetes (ACK). Na página Clusters, clique em Applications.

  2. No painel de navegação à esquerda, escolha Operations > Add-ons. Pesquise ack-onepilot no canto superior direito.

  3. No cartão ack-onepilot, clique em Uninstall.

  4. Na caixa de diálogo de confirmação, clique em OK.

  5. Reinicie os pods da aplicação para aplicar a alteração.

Usar a CLI

  1. Execute o seguinte comando Helm para desinstalar o ack-onepilot:

    helm3 uninstall --namespace ack-onepilot ack-onepilot
  2. Reinicie os pods da aplicação para aplicar a alteração.

Verificar a desinstalação

Após a desinstalação, confirme que os pods do ack-onepilot não estão mais em execução:

kubectl get pods -n ack-onepilot

Se o namespace estiver vazio ou o comando retornar No resources found, a desinstalação foi bem-sucedida.

Desinstalar de uma única aplicação em um cluster ACK

Para remover o agente do ARMS de uma aplicação específica sem afetar outras aplicações no cluster:

  1. Faça login no console do ACK. Na página Clusters, localize o cluster desejado e clique em Applications na coluna Actions.

  2. Na página Deployments, encontre a aplicação alvo. Na coluna Actions, escolha More > View in YAML.

  3. Na caixa de diálogo Edit YAML, exclua os labels adicionados durante a instalação do agente do ARMS e clique em Update.

  4. Reinicie o pod da aplicação para aplicar a alteração.

Verificar a desinstalação

Verifique se os rótulos relacionados ao ARMS foram removidos do pod:

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

Confirme que nenhum rótulo específico do ARMS aparece na saída.

Remover um agente instalado manualmente

Caso tenha instalado o agente do ARMS usando o instgo (instrumentação em tempo de compilação), remova-o recompilando sua aplicação com a toolchain padrão do Go. O instgo restaura automaticamente a base de código após a conclusão da compilação, portanto, nenhuma alteração manual no código é necessária.

  1. (Opcional) Recompile sua aplicação com go build em vez de instgo:

    go build -o <your-app-binary>
  2. Implante o binário recompilado no ambiente de produção, substituindo a versão instrumentada anteriormente.

Limpar arquivos residuais da instrumentação em tempo de compilação

Durante a instrumentação em tempo de compilação, o instgo modifica temporariamente os arquivos source e os restaura após o término da compilação. A limpeza manual só é necessária se:

  • A compilação foi interrompida ou encerrada à força.

  • O instgo encerrou inesperadamente devido a um panic.

Execute o comando clean para restaurar os arquivos source:

Linux and macOS

./instgo clean

Windows

.\instgo.exe clean

Excluir o instgo e seu cache

Para remover completamente o instgo do sistema:

  1. Exclua o diretório de cache do agente. Se você especificou um diretório de cache personalizado com a flag --cacheDir durante a compilação, exclua esse diretório. Caso contrário, exclua o diretório de cache padrão.

    Linux and 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. Exclua o binário do instgo.

O que é removido

Item

Localização

Removido por

Cache do agente

/opt/.opt/aliyun-go-agent (Linux/macOS) ou C:\ProgramData\.opt\aliyun-go-agent (Windows)

Exclusão de cache (etapa 1)

Binário do instgo

Diretório de trabalho

Exclusão manual (etapa 2)

Modificações em arquivos source

Base de código

Restauração automática (ou instgo clean)