Como instalar o agente do Cloud Monitoring em VMs individuais

Este é um agente legado. Embora esse agente ainda seja compatível com o Linux, não é recomendável usá-lo para novas cargas de trabalho do Google Cloud.

Em vez disso, recomendamos que você use o Agente de operações para novas cargas de trabalho do Google Cloud e faça a transição eventual das VMs atuais do Compute Engine para que elas usem esse agente. O Agente de operações, que combina a coleta de métricas e a geração de registros em um único agente, é o substituto final dos agentes legados.

O Agente de operações está em desenvolvimento ativo, mas pode haver alguns casos de uso não compatíveis. Se ele não for compatível com o seu caso de uso, ainda será possível usar o agente do Monitoring no Linux.

Não haverá desenvolvimento de recursos ou suporte a novos sistemas operacionais para o agente do Monitoring legado.

Não recomendamos o uso do agente do Monitoring legado no Windows. O agente do Monitoring legado não é compatível com o Windows e todos os recursos dele estão disponíveis no Agente de operações. É altamente recomendável usar o Agente de operações para monitorar instâncias do Windows. No entanto, se você precisar executar o agente do Logging legado no Windows e coletar métricas, use o agente do Monitoring legado. Isso porque não será possível executar o Agente de operações e um agente legado na mesma máquina.

O agente do Cloud Monitoring reúne as métricas de sistema e aplicativo das instâncias de VM e as envia para o Monitoring. Também é possível configurar o agente do Monitoring para monitorar aplicativos de terceiros.

Este guia explica como instalar o agente do Cloud Monitoring para Monitoring no Compute Engine e nas VMs do Amazon Elastic Compute Cloud (EC2). O uso do agente é opcional, mas recomendado para as instâncias de VM do Compute Engine. Para essas VMs, o Monitoring acessa algumas métricas do hipervisor da VM sem o agente, incluindo a utilização da CPU, algumas métricas de tráfego de disco, tráfego de rede e tempo de atividade. O uso do agente é necessário para VMs do Amazon Elastic Compute Cloud (EC2).

Nas instâncias em execução no Microsoft Windows, o agente registra o uso e memória da CPU, arquivo de paginação e uso de volume. Se você executa o servidor IIS ou SQL, o agente coleta métricas deles por padrão.

Antes de começar

Para instalar o agente, verifique se você tem os seguintes itens:

Uma instância de VM compatível em um projeto do Google Cloud ou em uma conta da Amazon Web Services (AWS).
- São recomendados pelo menos 250 MiB de memória residente (RSS. na sigla em inglês) para executar o agente do Monitoring.
Verifique também se a VM está executando um sistema operacional compatível.
Credenciais na instância de VM que autorizam a comunicação com o Cloud Logging ou o Cloud Monitoring. Por padrão, as instâncias de VM do Compute Engine normalmente têm as credenciais corretas. Se uma das situações a seguir for aplicável ao seu caso, talvez você não tenha as credenciais corretas e precise concluir os procedimentos de Autorizar o agente do Monitoring:
- Para instâncias de VM da AWS EC2 em execução, você precisa instalar credenciais de autorização nas VMs antes de instalar o agente.
- Instâncias do Compute Engine em execução que são muito antigas ou foram criadas sem as credenciais padrão.
Para verificar se você tem as credenciais corretas, execute os procedimentos de verificação das credenciais do Compute Engine.
Para usuários da AWS, faça o seguinte:
1. Conecte sua conta da AWS a um Google Cloud. Para informações sobre esse processo, consulte Coletar métricas de contas da AWS.
  
  Observação: ao conectar sua conta da AWS a um Google Cloud, você cria um projeto de conector da AWS. Para facilitar a identificação desses projetos, recomendamos que seus projetos de conector da AWS sigam uma convenção de nomenclatura.
2. Consulte a seção Projetos do Google Cloud para instâncias de VM da AWS EC2 para mais informações.
Para informações sobre preços, acesse Preços de observabilidade do Google Cloud.
Se você estiver usando VMs que não têm acesso a repositórios de pacotes remotos, consulte a seção VMs sem acesso de pacote remoto para mais informações.

Como instalar o agente da linha de comando

Para instalar o agente usando a linha de comando, siga as instruções abaixo.

Como instalar a versão mais recente do agente de operações

Para instalar a versão mais recente do agente, conclua as etapas a seguir.

Linux

Abra uma conexão de terminal com a instância de VM usando SSH ou uma ferramenta semelhante e verifique se você tem acesso a sudo.
Altere para um diretório em que você tenha acesso de gravação, como seu diretório principal.
Faça o download e execute o script de instalação do agente usando os seguintes comandos:
```
curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
sudo bash add-monitoring-agent-repo.sh --also-install
```
Depois de instalado, o agente é iniciado automaticamente.

Windows

Conecte-se à sua instância usando o RDP ou uma ferramenta semelhante e faça login no Windows.
Abra um terminal do PowerShell com privilégios de administrador. Para isso, clique com o botão direito do mouse no ícone do PowerShell e selecione Executar como administrador.

Execute os seguintes comandos do PowerShell:

(New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe")
& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe"

Como instalar uma versão específica do agente

Para instalar uma versão específica do agente, conclua as etapas a seguir.

Linux

Abra uma conexão de terminal com a instância de VM usando SSH ou uma ferramenta semelhante e verifique se você tem acesso a sudo.
Altere para um diretório em que você tenha acesso de gravação, como seu diretório principal.
Faça o download do script de instalação do agente:
```
curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
```
Ao executar o script add-monitoring-agent-repo.sh, também é possível definir as seguintes sinalizações:
- --verbose: ativa o registro detalhado durante a execução do script.
- --also-install: instala o agente após adicionar o repositório de pacotes.
- --version: define a versão do agente a ser instalada pelo script.
- --uninstall: desinstala o agente.
- --remove-repo: remove o repositório do pacote do agente correspondente depois de instalar ou desinstalar o agente.
- --dry-run: aciona apenas uma simulação da execução do script e imprime os comandos que ele precisa executar.
Consulte os comentários do script para mais informações e exemplos de uso.
Adicione o repositório de pacotes do agente e instale-o:
1. Para listar as versões disponíveis do agente para selecionar qual versão instalar, consulte Como listar todas as versões do agente.
2. Para ambientes de produção, talvez você queira fixar em uma versão principal para evitar instalar versões principais que podem incluir mudanças incompatíveis com versões anteriores. Para fixar em uma versão principal, execute:
```
sudo bash add-monitoring-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*
```
  Por exemplo, para fixar no 6.xx do agente, execute:
```
sudo bash add-monitoring-agent-repo.sh --also-install \
  --version=6.*.*
```
3. Para instalar uma versão específica do agente, execute:
```
sudo bash add-monitoring-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
```
Inicie o serviço do agente
```
sudo service stackdriver-agent start
```

Exclua o script de instalação depois que ele for executado com sucesso.

Para verificar se o agente está funcionando conforme o esperado, execute:
```
sudo service stackdriver-agent status
```
O status do agente deve ser OK.

Também é possível examinar os registros e garantir que não há erros:
```
sudo grep collectd /var/log/{syslog,messages} | tail
```

Se você tiver problemas com a instalação, consulte a página Solução de problemas.

Windows

Conecte-se à sua instância usando o RDP ou uma ferramenta semelhante e faça login no Windows.
Abra um terminal do PowerShell com privilégios de administrador. Para isso, clique com o botão direito do mouse no ícone do PowerShell e selecione Executar como administrador.

Observação: somente a versão mais recente do agente é compatível com instâncias de VM que executam o Windows. Não é recomendável instalar versões anteriores.
1. Execute os seguintes comandos do PowerShell:
```
(New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe")
& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe"
```
Como alternativa, é possível acessar até o URL a seguir para fazer o download e executar o instalador do agente:

https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe

Cuidado: você precisa fazer o download do instalador em um diretório que não seja do sistema, como C:\Users\[USERNAME]. Por motivos de segurança, o instalador não pode ser executado em diretórios do sistema, como C:\.
Se você fizer o download do instalador em um diretório do sistema, mova-o para outro diretório antes de executar o instalador.
Observação: o instalador do agente tem uma opção “silenciosa”, /S, que pode ser usada no script da instalação.

Para instalar o agente silenciosamente, anexe a opção /S à invocação do instalador:
```
& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S
```
Atenção: a instalação silenciosa é uma operação assíncrona. Quando o comando de instalação é encerrado, o agente ainda não está instalado. Para verificar se há uma instalação bem-sucedida, procure o serviço StackdriverMonitoring.
Observação: o instalador coloca o agente no diretório "C:\Program Files (x86)\Stackdriver\MonitoringAgent" por padrão. É possível alterá-lo durante a instalação.

No modo “silencioso”, use a opção /D para especificar o diretório de instalação, por exemplo:
```
& "${env:UserProfile}\StackdriverMonitoring-GCM-46.exe" /S /D="C:\Stackdriver\Monitoring\"
```
Exclua o instalador depois que o processo for concluído

Se você tiver problemas com a instalação, consulte a página Solução de problemas.

Como visualizar informações do agente usando o console do Google Cloud

Encontre informações sobre o status do agente no painel pré-configurado Instâncias de VM do Monitoring. Para acessar esse painel, faça o seguinte:

No painel de navegação do console do Google Cloud, selecione Monitoramento, Painéis e VM instâncias:

Acessar o painel de instâncias de VM

A visualização Lista na guia Inventário do painel lista todas as VMs e inclui uma coluna de status para seu agente, conforme mostrado na captura de tela a seguir:

O painel "Instâncias de VM" no Monitoring mostra o status
dos
agentes.

A coluna Agente informa os seguintes valores:

Não detectado: você não tem um agente instalado ou ele não está em execução. Se você não tiver certeza se instalou um agente, consulte a versão instalada. Se você já instalou o agente, é possível reiniciá-lo.
Agente de operações: você está executando o agente de operações. Se você não vir uma marca de seleção verde ao lado da entrada, isso significa que há um upgrade de agente disponível, baseado no sistema operacional detectado da sua VM.

Ao passar o cursor sobre o indicador "Agente de operações" na tabela, você vê informações sobre a versão. Se você estiver executando uma versão mais antiga, também vai ver uma recomendação para fazer upgrade do agente.
Pendente: o agente de operações está sendo instalado ou atualizado.
Agente legado: você está executando o agente legado do Monitoring ou do Logging. Consulte Como migrar dos agentes legados para o agente de operações para informações sobre como fazer a transição para o agente de operações.
Não aplicável: esta VM não é uma plataforma compatível para executar o agente.
Desconhecido: a VM não está em execução, então o status do agente é desconhecido.

É possível instalar o Agente de operações fazendo o seguinte:

Selecione as instâncias de VM em que você quer instalar agentes.
Clique na opção Instalar/atualizar Agente de operações na tabela Instâncias.

Também é possível instalar ou atualizar o Agente de operações na página Detalhes da VM de uma VM específica.

Quando possível, o agente é instalado usando uma política de SO do agente de operações. Para mais informações, consulte Gerenciar VMs cobertas pela política de SO do agente de operações. As políticas de SO do agente de operações não são compatíveis com todas as versões de todos os sistemas operacionais. Nesse caso, clicar em Instalar/atualizar Agente de operações fornece uma série de comandos a serem executados no Cloud Shell.

Por padrão, o agente de operações coleta métricas e registros. É possível alterar esse comportamento padrão configurando o agente de operações.

Tarefas opcionais

Veja nesta seção como executar tarefas comuns de manutenção.

Como configurar o agente do Monitoring

Para ajustar a configuração do agente, consulte Configurar o agente do Monitoring.

Como configurar um proxy HTTP

Se você usa um proxy HTTP para representar solicitações de proxy para as APIs Logging e Monitoring, faça o seguinte:

Linux

Edite o seguinte arquivo de configuração (crie o arquivo, se ele ainda não existir):
- Para as versões 6.0.0 e posteriores do agente, edite:
```
/etc/default/stackdriver-agent
```
- Para versões do agente anteriores à versão 6.0.0, edite o arquivo apropriado para seu sistema operacional:
  
  Para o Debian e o Ubuntu, edite:
```
/etc/default/stackdriver-agent
```
  Para CentOS e SLES, edite:
```
/etc/default/stackdriver-collectd
```
  Observação: se este arquivo não existir, crie-o.

Adicione o seguinte ao arquivo:

 export http_proxy="http://proxy-ip:proxy-port"
 export https_proxy="http://proxy-ip:proxy-port"
 export no_proxy=169.254.169.254  # Skip proxy for the local Metadata Server.

Reinicie o agente do Logging ao executar o comando a seguir na instância de VM.
```
 sudo service stackdriver-agent restart
```

Windows

Se você usar um proxy HTTP, gere o comando a seguir em um prompt de comando de administrador. Isso define as variáveis de ambiente HTTP_PROXY e HTTPS_PROXY para que o agente possa enviar dados usando HTTPS de saída:
```
setx HTTP_PROXY http://proxy-ip:proxy-port /m
setx HTTPS_PROXY http://proxy-ip:proxy-port /m
setx no_proxy 169.254.169.254 /m
```

Como determinar a versão do agente

Para determinar a versão do agente do Monitoring no sistema, execute os seguintes comandos na instância de VM:

AMAZON LINUX AMI/CENTOS/RHEL

Execute o seguinte comando no Amazon Linux, Red Hat ou CentOS Linux:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent

DEBIAN/UBUNTU

Execute este comando no Debian ou no Ubuntu:

dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' stackdriver-agent

SLES/SUSE

Execute o comando a seguir no SUSE:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' stackdriver-agent

WINDOWS

No momento, não há como determinar a versão do agente do Monitoring em execução no Windows.

Como reiniciar o agente

Você precisa reiniciar o agente do Monitoring para selecionar as alterações nos arquivos de configuração. Para reiniciar o agente, use as instruções a seguir.

LINUX

Execute o seguinte comando na instância:


     sudo service stackdriver-agent restart

Windows

Conecte-se à sua instância usando o RDP ou uma ferramenta semelhante e faça login no Windows.
Abra um terminal do PowerShell com privilégios de administrador. Para isso, clique com o botão direito do mouse no ícone do PowerShell e selecione Executar como administrador.
Execute o seguinte comando do PowerShell:

Restart-Service -Name StackdriverMonitoring

Como atualizar o agente

Para atualizar o agente do Monitoring para a versão mais recente, siga estas instruções:

Linux

Para fazer upgrade do agente para a versão mais recente, execute o comando abaixo:

sudo bash add-monitoring-agent-repo.sh --also-install

Para fazer upgrade do agente para a versão pontual mais recente de uma versão principal específica, execute o comando abaixo:

sudo bash add-monitoring-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

Para fazer upgrade para a versão mais recente do agente, instale essa versão conforme descrito em Como instalar no Windows. O instalador solicitará que você desinstale a versão anterior do agente.

Como listar todas as versões do agente

Para listar as versões disponíveis do agente, execute o seguinte comando:

AMAZON LINUX AMI/CENTOS/RHEL

Liste as versões disponíveis do agente:

sudo yum list --showduplicates stackdriver-agent

DEBIAN/UBUNTU

Liste as versões disponíveis do agente:

sudo apt-cache madison stackdriver-agent

SLES/SUSE

Liste as versões disponíveis do agente:

sudo zypper search -s stackdriver-agent

WINDOWS

Não é possível instalar versões anteriores do agente no Windows.

Como desinstalar o agente

Para remover o agente do Monitoring e os respectivos arquivos de configuração, use as instruções a seguir.

Depois de desinstalar o agente, o console do Google Cloud pode levar até uma hora para informar essa alteração.

Linux

Execute este comando:

sudo bash add-monitoring-agent-repo.sh --uninstall

Outra opção é anexar --remove-repo ao comando anterior para remover o repositório e desinstalar o agente.

Windows

No Painel de Controle do Windows, escolha Desinstalar um programa. Você verá o agente do Monitoring na lista de programas que podem ser desinstalados. Também é possível executar uninstall.exe no diretório em que você instalou o agente do Monitoring.

Informações sobre projetos do Google Cloud para instâncias de VM da AWS EC2

Quando a documentação se referir ao projeto do Google Cloud associado à instância de VM, para instâncias de VM do EC2, essa frase se refere ao projeto do conector da AWS vinculado à sua conta da AWS.

Ao conectar sua conta da AWS a um Google Cloud, você cria um projeto de conector da AWS. Para informações sobre esse processo, consulte Coletar métricas de contas da AWS.

Para acessar o projeto de conector da AWS em uma conta da AWS, siga um destes procedimentos:

Use o seletor de projetos do console do Google Cloud para identificar os projetos que correspondem às convenções de nomenclatura do seu projeto de conector da AWS e selecione o projeto específico da sua conta da AWS.
Identifique o projeto do Google Cloud que tem o escopo de métricas que inclui as métricas da sua conta da AWS e selecione esse projeto no seletor de projetos do console do Google Cloud. Para este projeto do Google Cloud, acesse a página Monitoring e selecione a página Configurações. A página Configurações lista os projetos do conector da AWS. Use o seletor de projetos do console do Google Cloud para acessar o projeto de conector da AWS.

VMs sem acesso ao pacote remoto

A instalação do agente do Monitoring requer acesso a repositórios de pacotes remotos, tanto para o pacote do agente quanto para as dependências (no Linux).

Se você estiver usando o VPC-SC ou uma rede privada, a configuração da rede também poderá afetar a instalação de dependências do agente a partir de repositórios upstream. Os próprios pacotes de agente podem ser acessados usando o Acesso privado do Google. Isso pode ser configurado em Ativar o Acesso privado do Google.

Se a política de segurança da VM host negar o acesso aos repositórios de pacotes remotos, recomendamos criar uma imagem de VM personalizada com o agente pré-instalado e desativar o gerenciamento de pacotes nessa imagem.