O agente do Cloud Monitor coleta métricas de monitoramento do sistema operacional do host e envia os dados ao Cloud Monitor para análise. Visualize o status do host em gráficos e crie regras de alerta para métricas essenciais a fim de identificar e resolver problemas com agilidade. Este tópico descreve como instalar, gerenciar e desinstalar o agente do Cloud Monitor.
Gerencie o agente do Cloud Monitor apenas com uma conta de administrador (usuário root no Linux ou usuário Administrator no Windows). O uso de contas administrativas pode trazer riscos, como problemas de estabilidade do sistema ou segurança de dados. Proceda com cautela.
Antes de começar
Versão do agente
Recomendamos a versão C++ 3.X.
As versões Java e Go do agente não recebem mais manutenção. A versão C++ consome significativamente menos recursos que as versões Go e Java. Por isso, recomendamos a instalação da versão C++ do agente.
A tabela a seguir compara os caminhos dos scripts de controle das versões legadas e atuais do agente:
|
Versão |
Caminho do script de controle |
Observações |
|
Legada (Java/Go) |
|
Obsoleta; o diretório |
|
Atual (C++) |
|
Recomendada; não possui o diretório |
O diretório /usr/local/cloudmonitor/wrapper/ não existe na versão C++. Se a execução de um comando legado retornar o erro "no such file or directory", seu host tem a versão C++ instalada. Utilize cloudmonitorCtl.sh para todas as operações.
Faturamento: A instalação do agente do Cloud Monitor, a visualização de gráficos de monitoramento de hosts e a criação de regras de alerta são gratuitas.
-
Requisitos do sistema
Sistema operacional
Arquitetura de hardware
Windows 7, Windows Server 2008 R2 e posteriores
i386, AMD64
Linux 2.6.23 e posterior (deve incluir a biblioteca Glibc)
i386, AMD64, ARM64
O agente do Cloud Monitor é compatível com qualquer distribuição Linux que atenda às seguintes condições: versão do kernel 2.6.23 ou superior e inclusão da biblioteca Glibc. As distribuições compatíveis incluem (mas não se limitam a) CentOS, Ubuntu, Debian, Alibaba Cloud Linux, Anolis OS, Rocky Linux, AlmaLinux e Kylin OS.
Métricas básicas de monitoramento (como uso de CPU e tráfego de rede) são coletadas diretamente do host e não exigem o agente; portanto, a distribuição Linux não as afeta. Métricas no nível do SO, como uso de memória e disco, exigem a instalação do agente do Cloud Monitor para coleta.
Para caminhos de instalação suportados, consumo de recursos e logs do agente C++, consulte Cloud Monitor agent overview.
Requisitos de rede do host
O host precisa ter acesso à internet, seja diretamente ou por meio de um NAT Gateway ou servidor proxy.
-
Configuração da lista de permissões do firewall
Se houver um firewall ou grupo de segurança do ECS configurado no host, adicione os endereços e portas do servidor do Cloud Monitor à lista de permissões.
NotaHosts de terceiros usam a porta 443 para relatar dados e realizar verificações de heartbeat pela internet.
Endereço do servidor
Método de consulta
Porta do servidor
Descrição
Serviço de heartbeat
nslookup cms-cloudmonitor.aliyun.comouping cms-cloudmonitor.aliyun.com8080, 3128, 443
Usado para verificações de heartbeat do agente.
Relatório de dados
VPC:
nslookup metrichub-<regionid>.aliyun.comInternet:
nslookup metrichub-cms-<regionid>.aliyuncs.com80, 443
Usado para relatar dados de monitoramento.
-
<regionid>é o ID da região do host Alibaba Cloud. Execute o comando a seguir para obter o ID da região:curl http://100.100.100.200/latest/meta-data/region-id. -
O relatório de dados via internet está disponível apenas nas regiões China (Hangzhou), China (Shanghai), China (Beijing) e China (Shenzhen).
Serviço de metadados
Bloco CIDR fixo: 100.100.0.0/16
0-65535
Obtém informações da instância (apenas hosts Alibaba Cloud).
-
Corrigir falhas na resolução de DNS
Esta seção aplica-se apenas a hosts Linux.
Se nslookup cms-cloudmonitor.aliyun.com retornar Name or service not known ou no servers could be reached, o host não consegue resolver o domínio do serviço de heartbeat do Cloud Monitor e o agente fica offline. Corrija o problema seguindo estas etapas:
-
Edite
/etc/resolv.confe adicione os seguintes servidores DNS internos da Alibaba Cloud:nameserver 100.100.2.136 nameserver 100.100.2.138 -
Reinicie o agente do Cloud Monitor:
cd /usr/local/cloudmonitor && ./cloudmonitorCtl.sh restart -
Verifique se os processos do agente estão em execução:
ps aux | grep argusagentNormalmente, dois a três processos são exibidos (daemon, wrapper e processo principal).
-
Teste a resolução de DNS novamente:
nslookup cms-cloudmonitor.aliyun.comSe um endereço IP for retornado, a resolução de DNS foi restaurada.
Comparação dos métodos de instalação
Instale o agente automaticamente ou manualmente conforme o tipo de host e o ambiente de rede.
|
Método de instalação |
Casos de uso |
Benefícios |
|
Instalação automática pelo console |
Instâncias ECS da Alibaba Cloud e hosts de terceiros gerenciados pelo Cloud Assistant. |
Recomendado. Método simples que suporta operações em lote e não exige login no host. |
|
Instalação manual |
Cenários onde a instalação automática não está disponível, hosts de terceiros não gerenciados, ambientes internos ou offline e implantações com scripts de automação como Ansible. |
Altamente flexível e adequado para todos os ambientes complexos. |
Observações sobre a instalação
A instalação do agente do Cloud Monitor não afeta as operações comerciais nem exige reinicialização da instância ECS. Após a instalação, o agente inicia automaticamente e começa a coletar dados de monitoramento. Caso haja preocupação com o impacto, instale o agente fora do horário de pico.
A instalação automática não altera o estado de login da conta root (por exemplo,
noLogin). Mesmo que o login direto como root esteja desativado no host, o Cloud Assistant Agent (aliyun-service) ainda pode executar a instalação em nome do root.O agente do Cloud Monitor (argusagent) e o agente de coleta do Simple Log Service (loongcollector) são componentes independentes, sem dependência entre si. Instalar, desinstalar ou reiniciar um deles não afeta o outro.
Para hosts não-ECS, como Simple Application Servers, instale o agente do Cloud Monitor para visualizar métricas no nível do SO, como uso de memória e disco, no console. Métricas básicas de monitoramento, como uso de CPU e tráfego de rede, são coletadas do host e não exigem o agente.
Instalação automática (Recomendada)
Este método aplica-se a hosts Alibaba Cloud e Alibaba Cloud-managed instances.
Acesse a página Host Monitoring.
-
Na página Host Monitoring, selecione os hosts nos quais deseja instalar ou atualizar o agente e clique em Batch Install/Upgrade Agent no canto inferior esquerdo. Na caixa de diálogo exibida, clique em OK.
NotaPara hosts Alibaba Cloud recém-adquiridos, ative a opção Automatically Install CloudMonitor Agent on Newly Purchased ECS Instances no canto superior direito. Quando ativada, essa opção instala automaticamente o agente do Cloud Monitor em novos hosts ECS. Caso contrário, instale o agente manualmente.
A instalação ou atualização leva cerca de 5 minutos. Quando o Agent Status do host alvo mudar de Installing para Running, a operação estará concluída.
Instalação manual
Instale o agente manualmente se a instalação automática falhar ou se estiver instalando em um ambiente especial. Se já existir uma versão antiga ou corrompida do agente no host, desinstale-a primeiro.
Instâncias do Simple Application Server não aparecem na lista de Host Monitoring. O filtro de tipo de host na página Host Monitoring oferece apenas instâncias ECS e hosts de terceiros; portanto, não é possível obter o comando de instalação na caixa de diálogo Manual Installation para uma instância do Simple Application Server. Conecte-se à instância via SSH e instale o agente manualmente.
Faça login na instância do Simple Application Server via SSH como usuário root e execute o seguinte comando para instalar o agente do Cloud Monitor:
ARGUS_VERSION=4.0.0 /bin/bash -c "$(curl -s https://cms-agent-cn-shenzhen.oss-cn-shenzhen-internal.aliyuncs.com/Argus/agent_install-2.0.3.sh)"
Substitua cn-shenzhen no comando pelo ID da região da instância. ARGUS_VERSION especifica a versão do agente a ser instalada. Após a conclusão do comando, execute o seguinte para confirmar que o processo do agente está em execução:
ps aux | grep argusagent
Os dados de monitoramento das instâncias do Simple Application Server não são exibidos na página Host Monitoring. Após instalar o agente, faça login no console do Cloud Monitor e escolha Cloud Service Monitoring > Compute > Simple Application Server para visualizar os dados de monitoramento. O namespace correspondente é acs_swas.
Acesse a página Host Monitoring.
Na página Host Monitoring, clique em Host & Agent Operations acima da lista de hosts e selecione Manual Installation no menu suspenso.
Na caixa de diálogo Manual Installation, siga as etapas abaixo para concluir a instalação.
Hosts Alibaba Cloud
Linux
No campo Region, selecione a região onde o host Alibaba Cloud está localizado.
Na área Installation Command, clique no ícone
ao lado do comando para copiá-lo. Selecione Linux ou Windows como sistema operacional para obter o comando de instalação correspondente na área Installation Command.Faça login no host como usuário root.
Cole e execute o comando de instalação.
-
Execute o seguinte comando para verificar o status do agente:
ps aux | grep argusagent | grep -v grep
Se a saída for semelhante à seguinte, o agente está funcionando corretamente.
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
No campo Region, selecione a região onde o host Alibaba Cloud está localizado.
Baixe o pacote do agente de 32 bits ou 64 bits conforme o sistema operacional do host.
Faça login no host como usuário Administrator.
Crie o diretório
C:\Program Files\Alibaba\cloudmonitor. Carregue o pacote do plugin no host e descompacte-o no diretórioC:\Program Files\Alibaba\cloudmonitor.Para abrir o Command Prompt, pressione Win+R para abrir a caixa de diálogo Run, insira
cmde clique em OK.-
Execute os seguintes comandos para instalar o agente do Cloud Monitor:
cd C:\Program Files\Alibaba\cloudmonitor\binargusagent_service.exe install
Execute o comando
net start argusagentpara iniciar o agente do Cloud Monitor.-
Verifique o status do agente.
Para abrir a janela Service, pressione Win+R para abrir a caixa de diálogo Run, insira services.msc e clique em OK.
Verifique o status do argusagent service. Se o status for Running, o agente está funcionando corretamente.
Hosts de terceiros
Linux
No campo Region, selecione uma região para receber os dados de monitoramento.
Na caixa de diálogo Manual Installation, configure os parâmetros necessários para gerar o comando de instalação. Na área Installation Command, clique no ícone de cópia
para copiar o comando.Faça login no host como usuário root.
Cole e execute o comando de instalação.
-
Execute o seguinte comando para verificar o status do agente:
ps aux | grep argusagent | grep -v grep
Se a saída for semelhante à seguinte, o agente está funcionando corretamente.
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
No campo Region, selecione uma região para receber os dados de monitoramento.
Baixe o pacote do agente (32 bits ou 64 bits, dependendo do sistema operacional do host) e o arquivo de configuração
accesskey.properties.Faça login no host como usuário Administrator.
Crie o diretório
C:\Program Files\Alibaba\cloudmonitor. Carregue o pacote do plugin no host e extraia-o no diretórioC:\Program Files\Alibaba\cloudmonitor.Carregue o arquivo de configuração no host e coloque-o no diretório
C:\Program Files\Alibaba\cloudmonitor\local_data\conf.-
Execute os seguintes comandos para instalar o agente do Cloud Monitor:
cd C:\Program Files\Alibaba\cloudmonitor\binargusagent_service.exe install
Execute o comando
net start argusagentpara iniciar o agente do Cloud Monitor.-
Verifique o status do agente.
Para abrir a janela Service, pressione Win+R para abrir a caixa de diálogo Run, insira services.msc e clique em OK.
Verifique o status do argusagent service. Se o status for Running, o agente está funcionando corretamente.
Problema comum
Se um host de terceiros com o agente do Cloud Monitor não conseguir acessar a internet, o agente não poderá relatar dados de monitoramento. Para resolver isso, configure um servidor proxy modificando o arquivo de configuração agent.properties correspondente ao sistema operacional.
Caminho Linux:
/usr/local/cloudmonitor/local_data/conf/agent.propertiesCaminho Windows:
C:\Program Files\Alibaba\cloudmonitor\local_data\conf\agent.properties
Para etapas detalhadas, consulte How do I use an Nginx proxy server to report monitoring data from a third-party host?.
Solução de problemas
Se o agente do Cloud Monitor falhar ao instalar ou iniciar, consulte as soluções abaixo.
Cenário 1: Clicar em Install ou Start no console várias vezes não surte efeito
Faça login no host e execute o seguinte comando para iniciar o Cloud Assistant (aliyun-service). Em seguida, tente novamente a operação no console.
systemctl start aliyun-service
Cenário 2: Falha na instalação em um Simple Application Server
Realize as seguintes verificações em sequência:
-
Verifique a conectividade do serviço de metadados. Execute o seguinte comando:
curl http://100.100.100.200/latest/meta-data/region-idSe um ID de região for retornado, a conectividade está normal.
-
Verifique a conectividade da URL de download do agente. Substitua
<region>pelo ID real da sua região e execute:ping cms-agent-<region>.oss-<region>.aliyuncs.com -
Verifique se o processo do agente está em execução:
ps -ef | grep cms Se todas as verificações passarem, mas a instalação ainda falhar, use o método de instalação manual. Para etapas detalhadas, consulte Instalação manual neste tópico.
Cenário 3: O status do agente mostra Reinstalling/Upgrading ou a operação falha
Verifique se o Cloud Assistant Agent (aliyun-service) está em execução. Se não estiver, reinicie-o ou repare-o e tente novamente a instalação do agente do Cloud Monitor. Se o problema persistir, reinstale manualmente o agente do Cloud Monitor.
Cenário 4: Falha na conexão do agente (geral)
Desinstale o agente do Cloud Monitor e reinstale-o.
Se o problema persistir, tente instalar uma versão específica (por exemplo, versão 1.0.6) para determinar se o problema está relacionado à versão.
Migrar do agente legado
Se o seu host executa um agente Java ou Go legado — identificável pela presença do diretório /usr/local/cloudmonitor/wrapper/ — siga as etapas abaixo para migrar para a versão C++, que oferece menor uso de recursos e atualizações contínuas de funcionalidades.
Etapas (Linux)
-
Pare o agente legado:
bash /usr/local/cloudmonitor/wrapper/bin/cloudmonitor.sh stop -
Desinstale o agente legado:
bash /usr/local/cloudmonitor/wrapper/bin/cloudmonitor.sh remove rm -rf /usr/local/cloudmonitor Instale a versão C++ seguindo a seção Instalação manual neste documento.
-
Inicie o agente C++:
bash /usr/local/cloudmonitor/cloudmonitorCtl.sh start -
Verifique se o agente está em execução:
ps aux | grep argusagent | grep -v grep
Operações comuns
Iniciar o agente
-
Linux
Execute o seguinte comando para iniciar o agente do Cloud Monitor:
bash /usr/local/cloudmonitor/cloudmonitorCtl.sh start -
Windows
Execute o seguinte comando para iniciar o agente do Cloud Monitor:
net start argusagent
Verificar o status do agente
-
Linux
Execute o seguinte comando para verificar o status do agente:
ps aux | grep argusagent | grep -v grepSe a saída for semelhante à seguinte, o agente está funcionando corretamente.
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
Para abrir a janela Service, pressione Win+R para abrir a caixa de diálogo Run, insira services.msc e clique em OK.
-
Verifique o status do argusagent service.
Se o status for Running, o agente está funcionando corretamente.
Parar o agente
-
Linux
Execute o seguinte comando para parar o agente do Cloud Monitor:
bash /usr/local/cloudmonitor/cloudmonitorCtl.sh stop -
Windows
Execute o seguinte comando para parar o agente do Cloud Monitor:
net stop argusagent
Desinstalar o agente
Após desinstalar a versão C++ do agente do Cloud Monitor, o monitoramento em tempo real do host deixa de estar disponível, mas os dados históricos de monitoramento permanecem acessíveis.
-
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/cloudmonitorSe o script
cloudmonitorCtl.shnão existir, desinstale o agente executando as seguintes etapas:Localize o diretório do agente:
find / -name cloudmonitor -type dPare o serviço:
systemctl stop cloudmonitorDesative o serviço:
systemctl disable cloudmonitor-
Encerre os processos residuais:
kill -9 $(pgrep argusagent)NotaO serviço
argusagentestá configurado comKillMode=none, portantosystemctl stopnão encerra o processo. Um processo em execução recria o diretório/usr/local/cloudmonitor. Por isso, é obrigatório encerrar o processo antes de excluir o diretório. Exclua o diretório do agente:
rm -rf /usr/local/cloudmonitorExclua o arquivo de serviço:
rm -f /etc/systemd/system/cloudmonitor.serviceRecarregue o systemd:
systemctl daemon-reloadExclua o diretório de configuração:
rm -rf /etc/cloudmonitor
Após a desinstalação, execute os seguintes comandos para verificar se o agente foi completamente removido:
systemctl status cloudmonitorretornanot-found.ls /usr/local/cloudmonitorrelataNo such file or directory.ps aux | grep argusagentnão retorna nenhum processo.find / -name cloudmonitor -type dnão retorna nenhum resultado.
-
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 cloudmonitorNotaSe o caminho de instalação contiver espaços (por exemplo,
C:\Program Files\Alibaba\cloudmonitor), envolva o caminho completo do executável entre aspas duplas no comando de desinstalação, conforme mostrado na etapa 2. Sem as aspas, o Windows não consegue localizar o executável e retorna o erro'...' is not recognized as an internal or external command.Se encontrar erros de permissão ou falhas na execução do comando, verifique se o usuário atual do Windows tem privilégios de Administrator e se o caminho do arquivo está correto.
Perguntas frequentes
P: Por que algumas métricas de monitoramento (como uso de memória e disco) não são exibidas ou estão ausentes após a instalação do agente do Cloud Monitor?
R:
Há um breve atraso entre a coleta e o relatório de dados. Aguarde alguns minutos e atualize o console.
-
Verifique se o status do agente é Running. Se o status for Stopped, acesse a página Host Monitoring no console para iniciar o agente, ou faça login no host e execute:
systemctl start aliyun-service Observe a diferença entre monitoramento básico e monitoramento do SO: métricas básicas (como uso de CPU e tráfego de rede) são coletadas do host e não exigem o agente. Métricas no nível do SO, como uso de memória e disco, exigem o agente do Cloud Monitor. Se o agente não estiver instalado ou não estiver funcionando corretamente, essas métricas ficarão indisponíveis.
Se os alertas não forem acionados conforme esperado (por exemplo, nenhum alerta quando o uso do disco atingir 100%), verifique se o agente está instalado e em execução. Os dados de monitoramento devem ser relatados com sucesso antes que as regras de alerta possam entrar em vigor.
P: Após desinstalar o agente do Cloud Monitor, ainda vejo um processo em execução. Por que isso acontece?
R:
Se um processo chamado aliyun_assist (ou aliyun-service) ainda estiver em execução após a desinstalação do agente do Cloud Monitor (argusagent), esse processo pertence ao Cloud Assistant Agent (aliyun-service), que é um product independente do agente do Cloud Monitor. Desinstalar o agente do Cloud Monitor não desinstala automaticamente o Cloud Assistant Agent. Se você não precisar mais do Cloud Assistant Agent, consulte Stop and uninstall agent para desinstalá-lo separadamente.