Como instalar o agente do Cloud Monitoring em uma única VM

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 sua VM está executando um sistema operacional compatível.
Um espaço de trabalho que monitore a conta da AWS que contém a instância de VM. Para informações sobre preços, acesse Preços do conjunto de operações do Google Cloud.
Credenciais na instância de VM que autorizem 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 autorização do agente:
- 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.

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 espaço de trabalho, o projeto do conector da AWS é criado. Para identificar o projeto de conector da AWS, acesse a guia Configurações do espaço de trabalho. O projeto do conector está listado no título Contas da AWS. A coluna ID do projeto exibe os projetos do Google Cloud associados ao seu espaço de trabalho.

Consulte a página Espaço de trabalho para ver mais informações sobre projetos 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 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.

Como instalar o agente em uma única VM

Para instalar o agente em uma instância de VM com Linux ou Microsoft Windows, use as instruções a seguir.

AMAZON LINUX AMI / CENTOS / RHEL

Abra uma conexão de terminal para a instância de VM usando SSH ou uma ferramenta semelhante.
Verifique se você tem acesso sudo.
Altere para um diretório em que você tenha acesso de gravação, como seu diretório principal.

Adicione o repositório de pacotes do agente:

curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
sudo bash add-monitoring-agent-repo.sh

Instale o agente:
1. Liste as versões disponíveis do agente para selecionar qual versão instalar:
```
sudo yum list --showduplicates stackdriver-agent
```
2. Para ambientes de produção, talvez você queira fixar em uma versão principal para evitar extrair versões principais que podem incluir mudanças incompatíveis com versões anteriores. Para fixar uma versão principal, execute:
```
sudo yum install -y stackdriver-agent-major-versio.*
```
  Por exemplo, para fixar no 6.xx do agente, execute:
```
sudo yum install -y stackdriver-agent-6.*
```
3. Se você não quiser fixar em uma versão principal, selecione uma das outras opções de instalação:
  1. Para instalar uma versão específica do agente, execute:
```
  sudo yum install -y stackdriver-agent-version-number
```
  2. Para instalar a versão mais recente do agente, execute:
```
  sudo yum install -y stackdriver-agent
```
Iniciar 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.

Você também pode examinar os registros e garantir que não haja 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.

DEBIAN/UBUNTU

Abra uma conexão de terminal para a instância de VM usando SSH ou uma ferramenta semelhante.
Verifique se você tem acesso sudo.
Altere para um diretório em que você tenha acesso de gravação, como seu diretório principal.

Adicione o repositório de pacotes do agente:

curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
sudo bash add-monitoring-agent-repo.sh
sudo apt-get update

Instale o agente:
1. Liste as versões disponíveis do agente para selecionar qual versão instalar:
```
sudo apt-cache madison stackdriver-agent
```
2. Para ambientes de produção, talvez você queira fixar em uma versão principal para evitar extrair versões principais que podem incluir mudanças incompatíveis com versões anteriores. Para fixar uma versão principal, execute:
```
sudo apt-get install -y 'stackdriver-agent=major-version.*'
```
  Por exemplo, para fixar no 6.xx do agente, execute:
```
sudo apt-get install -y 'stackdriver-agent=6.*'
```
3. Se você não quiser fixar em uma versão principal, selecione uma das outras opções de instalação:
  1. Para instalar uma versão específica do agente, execute:
```
  sudo apt-get install -y stackdriver-agent=version-number
```
  2. Para instalar a versão mais recente do agente, execute:
```
  sudo apt-get install stackdriver-agent
```
Iniciar 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.

Você também pode examinar os registros e garantir que não haja 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.

SLES/SUSE

Abra uma conexão de terminal para a instância de VM usando SSH ou uma ferramenta semelhante.
Verifique se você tem acesso sudo.
Altere para um diretório em que você tenha acesso de gravação, como seu diretório principal.

Adicione o repositório de pacotes do agente:

curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
sudo bash add-monitoring-agent-repo.sh

Instale o agente:
1. Liste as versões disponíveis do agente para selecionar qual versão instalar:
```
sudo zypper search -s stackdriver-agent
```
2. Para ambientes de produção, talvez você queira fixar em uma versão principal para evitar extrair versões principais que podem incluir mudanças incompatíveis com versões anteriores. Para fixar uma versão principal, execute:
```
sudo zypper install -y 'stackdriver-agent<major-version.0.0'
```
  Por exemplo, para fixar no 6.xx do agente, execute:
```
sudo zypper install -y 'stackdriver-agent<6+1.0.0'
```
3. Se você não quiser fixar em uma versão principal, selecione uma das outras opções de instalação:
  1. Para instalar uma versão específica do agente, execute:
```
  sudo zypper install -y stackdriver-agent=version-number
```
  2. Para instalar a versão mais recente do agente, execute:
```
  sudo zypper install stackdriver-agent
```
Iniciar 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.

Você também pode examinar os registros e garantir que não haja 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

Para instalar o agente em uma instância de VM com Windows, execute estas etapas:

Conecte-se à sua instância usando o RDP ou uma ferramenta semelhante e faça login no Windows.
Abra um terminal do PowerShell e execute os comandos a seguir. Não é necessário ter privilégios de administrador.
```
cd $env:UserProfile;
(New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", ".\StackdriverMonitoring-GCM-46.exe")
.\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:
```
.\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:
```
.\StackdriverMonitoring-GCM-46.exe /S /D="C:\Google Cloud's operations suite\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.

Tarefas opcionais

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

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 arquivo de configuração a seguir (deve ser criado se 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 estas linhas:

 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 Monitoring executando o seguinte comando 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 configura as variáveis de ambiente HTTP_PROXY e HTTPS_PROXY para que o agente possa enviar dados para o Monitoring usando o 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

Requer privilégios de administrador: para reiniciar o agente, execute o seguinte comando em um terminal 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:

AMAZON LINUX AMI/CENTOS/RHEL

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

sudo yum update stackdriver-agent

DEBIAN/UBUNTU

Execute os seguintes comandos no Debian ou no Ubuntu:

sudo apt-get update
sudo apt-get install stackdriver-agent

SLES/SUSE

Execute o comando a seguir no SUSE:

sudo zypper update stackdriver-agent

Se você estiver fazendo upgrade de um agente com versão <= 6.0.5, precisará reiniciar o serviço manualmente:

sudo service stackdriver-agent restart

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 desinstalar o agente

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

AMAZON LINUX AMI / CENTOS / RHEL

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

sudo yum remove stackdriver-agent

DEBIAN/UBUNTU

Execute este comando no Debian ou no Ubuntu:

sudo apt-get purge stackdriver-agent

SLES/SUSE

Execute o seguinte comando no Linux SUSE:

sudo zypper remove stackdriver-agent

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.