Como instalar o agente do Monitoring

Este guia explica como instalar o agente do Stackdriver Monitoring para monitoramento no Compute Engine e as instâncias de máquina virtual (VM, na sigla em inglês) do Amazon Elastic Compute Cloud (EC2). Para saber mais, consulte Instâncias de VMs compatíveis.

O uso do agente do Monitoring é opcional, mas recomendado. O Monitoring acessa algumas métricas sem o agente, incluindo o uso da CPU, algumas métricas de tráfego do disco, tráfego de rede e tempo de atividade.

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 um dos seguintes itens:

  • Uma instância de VM compatível em um projeto do Google Cloud Platform (GCP) ou 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.
  • Um espaço de trabalho que monitore o projeto do GCP ou conta da AWS contendo a instância de VM
  • Credenciais na instância de VM que autorizem a comunicação com o Stackdriver

    • As instâncias de VM do GCP normalmente têm as credenciais corretas por padrão.

    • Para instâncias da AWS, você precisa instalar credenciais de autorização nas VMs antes de instalar o agente.

Projetos do GCP para instâncias de VM da AWS

A documentação do Stackdriver normalmente se refere ao "projeto do GCP associado à instância de VM". Em instâncias de VM da AWS, isso se refere ao projeto de conector da AWS vinculado à conta da AWS.

O Stackdriver cria o projeto do conector da AWS quando você conecta a conta da AWS a um espaço de trabalho. O projeto tem os seguintes atributos:

  • Um nome que começa com AWS Link;
  • Um ID que começa com aws-

Use esse ID como identificador do "projeto do GCP associado à instância de VM".

Para mais informações, consulte o guia de início rápido do Stackdriver Monitoring (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 acesso a 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 autorizar o agente

Antes de instalar o agente do Monitoring, verifique se a instância de VM tem as credenciais de que ele precisa. O agente precisa ter permissão para enviar informações de acompanhamento ao Monitoring. A permissão é concedida quando se usam credenciais da conta de serviço armazenadas na instância de VM. Elas funcionam como credenciais padrão de aplicativo para o agente.

  • Se você estiver instalando o agente em uma instância de VM do Compute Engine, a conta de serviço padrão na instância precisará ter as credenciais necessárias para o agente. No entanto, instâncias muito antigas ou criadas sem as credenciais padrão exigem credenciais de chave privada. Para verificar as credenciais, consulte a seção a seguir, Como verificar as credenciais do Compute Engine.

  • Se você estiver instalando o agente em uma instância de VM do Amazon EC2, não haverá conta de serviço padrão. Em vez disso, você precisa receber manualmente as credenciais de chave privada de uma conta de serviço do projeto de conector da AWS. Se você acha que a instância já tem credenciais de chave privada, consulte Como verificar credenciais de chave privada para verificá-las. Para adicionar credenciais de chave privada, avance para Como adicionar credenciais.

Como adicionar credenciais

Se você estiver instalando o agente em uma instância de VM do Compute Engine e tiver criado a instância com as credenciais padrão, pule esta seção e vá diretamente para Como instalar no Linux ou Como instalar no Windows. Se você não souber se tem as credenciais corretas, consulte Como verificar credenciais do Compute Engine.

Se a instância do Compute Engine não tiver as credenciais corretas ou se você estiver instalando o agente em uma instância do Amazon EC2, veja estas instruções nas seções a seguir:

  1. Criar uma conta de serviço com os privilégios e as credenciais de chave privada necessários.
  2. Copiar as credenciais de chave privada para a instância de VM em que elas funcionam como credenciais padrão do aplicativo para o software em execução na instância.

Como criar uma conta de serviço

Use a página IAM e Admin > Contas de serviço do Console do GCP para criar uma conta de serviço e uma chave privada para o projeto do GCP associado à instância de VM.

Abrir a página "Conta de serviço" do IAM

  1. Clique em Selecionar um projeto e escolha o projeto do GCP em que você quer criar a conta de serviço:

    • Para instâncias do Compute Engine, escolha o projeto em que você criou a instância. Se a instância foi criada no projeto de hospedagem do espaço de trabalho, escolha o espaço de trabalho.

    • Para instâncias do Amazon EC2, escolha o projeto de conector da AWS criado quando você conectou o Monitoring à conta da AWS. Normalmente, o nome do projeto do conector começa com AWS Link. Não crie a conta de serviço no projeto do espaço de trabalho.

    Clique em Abrir. Se não houver uma conta de serviço, uma caixa de diálogo solicitará que você crie uma. Caso contrário, você verá a seguinte página Contas de serviço:

    Contas de serviço

  2. Na página Contas de serviço, clique em Criar conta de serviço.

  3. No painel Detalhes da conta de serviço, preencha as seguintes informações:

    1. Insira o nome da conta de serviço. Por exemplo, Agent service account.
    2. Digite a descrição de uma conta de serviço.
    3. Clique em Criar.
  4. No painel Permissões da conta de serviço, preencha as seguintes informações:

    1. No menu suspenso Selecionar um papel, selecione Monitoramento > Gravador de métrica de monitoramento. Isso autoriza o agente do Monitoring.
    2. Clique em Adicionar outro papel.
    3. No novo menu suspenso Selecionar um papel, selecione Logging > Gravador de registros. Isso autoriza o agente do Stackdriver Logging. A adição desse papel permite usar essa conta de serviço para executar os dois agentes do Stackdriver.
    4. Clique em Continuar.
  5. No painel Conceder aos usuários acesso a essa conta de serviço :

    1. Clique em Criar chave.
    2. Selecione JSON como Tipo de chave.
    3. Clique em Criar.

    Depois que a chave é criada, o Console do GCP grava o arquivo de chave privada no diretório de download da estação de trabalho e exibe uma caixa de diálogo semelhante à seguinte:

    Chave privada salva

  6. Clique em Fechar na janela pop-up.

  7. Na página Criar conta de serviço, clique em Concluído.

Como copiar a chave privada para a instância

Para que as credenciais da conta de serviço adicionadas sejam reconhecidas, você precisa copiar o arquivo de chave privada para um dos seguintes locais na instância de VM, usando qualquer ferramenta de cópia de arquivos desejada:

  • Somente Linux: /etc/google/auth/application_default_credentials.json.
  • Somente Windows: C:\ProgramData\Google\Auth\application_default_credentials.json.
  • Qualquer local que você armazena na variável, GOOGLE_APPLICATION_CREDENTIALS. Ela precisa ser visível ao processo do agente.

Para sua comodidade, nas instruções a seguir defina a variável de ambiente CREDS a fim de apontar para o arquivo de credenciais. Por exemplo:

`CREDS="~/Downloads/{project_name}-{key_id}.json"`

As instruções de cópia de arquivo a seguir pressupõem que você tenha um ambiente Linux tanto na estação de trabalho quanto na instância. Se você usa uma configuração diferente, consulte a documentação do seu provedor de nuvem para saber como copiar o arquivo de chave privada. Na etapa anterior, Como criar uma conta de serviço, as credenciais de chave privada foram armazenadas na estação de trabalho em um local salvo na variável CREDS:

Compute Engine

Na estação de trabalho, use a ferramenta de linha de comando gcloud:

REMOTE_USER="$USER"
INSTANCE="{your-instance-id}"
ZONE="{your-instance-zone}"
gcloud compute scp "$CREDS" "$REMOTE_USER@$INSTANCE:~/temp.json" --zone "$ZONE"

Na instância do Google Compute Engine, execute estes comandos:

APPLICATION_DEFAULT_CREDS="/etc/google/auth/application_default_credentials.json"
sudo mkdir -p /etc/google/auth
sudo mv "$HOME/temp.json" "$APPLICATION_DEFAULT_CREDS"
sudo chown root:root "$APPLICATION_DEFAULT_CREDS"
sudo chmod 0400 "$APPLICATION_DEFAULT_CREDS"

Amazon EC2

Na estação de trabalho, use scp:

KEY="{your-ssh-key-pair-file}"
INSTANCE="ec2-{your-instance's-public-ip}.{your-zone}.compute.amazonaws.com"
# The remote user depends on the installed OS: ec2-user, ubuntu, root, etc.
REMOTE_USER="ec2-user"
scp -i "$KEY" "$CREDS" "$REMOTE_USER@$INSTANCE:~/temp.json"

Na instância do EC2, execute estes comandos:

APPLICATION_DEFAULT_CREDS="/etc/google/auth/application_default_credentials.json"
sudo mkdir -p /etc/google/auth
sudo mv "$HOME/temp.json" "$APPLICATION_DEFAULT_CREDS"
sudo chown root:root "$APPLICATION_DEFAULT_CREDS"
sudo chmod 0400 "$APPLICATION_DEFAULT_CREDS"

Próximas etapas

Agora, a instância de VM tem as credenciais necessárias ao agente.

Como instalar no Linux

Nesta etapa, pressupõe-se que você tem uma instância de VM com Linux que é monitorada por um espaço de trabalho, e que a instância tem as devidas credenciais para o agente. Para mais informações, consulte Como adicionar credenciais. Essas instruções funcionam para as instâncias do Compute Engine e do Amazon EC2:

  1. Execute os seguintes comandos na instância de VM para instalar o agente de monitoramento:

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

    No final da instalação, você verá uma mensagem parecida com esta.

    Restarting services
    [ ok ] Restarting stackdriver-agent (via systemctl): stackdriver-agent.service.
    
  2. Se você usa um proxy HTTP, faça o seguinte:

    1. Edite o arquivo de padrões do sistema do agente do Monitoring para definir PROXY_URL como o URL do proxy HTTP. Esse URL vem da configuração, e não de um valor fornecido pelo Google. O nome do arquivo de configuração depende da versão do Linux:

      • Para Debian e Ubuntu, edite /etc/default/stackdriver-agent.
      • Para Amazon Linux, Red Hat, CentOS e SUSE, edite /etc/sysconfig/stackdriver.
    2. Reinicie o agente do Monitoring executando o seguinte comando na instância de VM:

      sudo service stackdriver-agent restart
      

Você concluiu a instalação do agente. Se tiver algum problema, consulte Solução de problemas.

Como instalar no Windows

Para instalar o agente em uma instância de VM com Windows, execute as seguintes etapas depois de estabelecer uma conexão RDP ou similar com a instância e fazer login no Windows:

  1. Se você usar o proxy HTTP, execute o comando a seguir em um prompt de comando de administrador para definir a variável de ambiente https_proxy. Dessa maneira, o agente pode enviar dados ao Monitoring usando HTTPS de saída:

    setx https_proxy https://[YOUR_PROXY_SERVER_URI] /m
    

    Reinicie o shell para que essa configuração seja aplicada.

  2. Navegue para o URL a seguir. Faça o download e execute o instalador do agente:

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

    Também é possível fazer isso com os seguintes comandos do PowerShell:

    cd $env:UserProfile;
    Invoke-WebRequest https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe -OutFile StackdriverMonitoring-GCM-46.exe;
    .\StackdriverMonitoring-GCM-46.exe
    

A instalação do agente está concluída.

Para instalar o agente silenciosamente, anexe a opção /S à invocação do instalador:

.\StackdriverMonitoring-GCM-46.exe /S

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:\Stackdriver\Monitoring\"

Instalação automatizada

Os scripts de instalação dos gerenciadores de configuração mais usados, incluindo o Ansible, Chef e Puppet, são disponibilizados por fornecedores e outros membros da comunidade. Publicamos links para novos scripts conforme são disponibilizados.

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:

Debian e Ubuntu

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

Amazon Linux

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

Red Hat e CentOS

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

SUSE

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

Microsoft Windows

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

Como atualizar o agente

Use os comandos da tabela a seguir para atualizar o agente:

Debian e Ubuntu

Execute os seguintes comandos nos sistemas Linux Debian ou Ubuntu:

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

Amazon Linux

Execute o seguinte comando no Amazon Linux:

sudo yum update stackdriver-agent

Red Hat e CentOS

Execute o seguinte comando nos sistemas Linux Red Hat ou CentOS:

sudo yum update stackdriver-agent

SUSE

Execute o seguinte comando no Linux SUSE:

sudo zypper update stackdriver-agent

Microsoft Windows

Para fazer upgrade do agente do Microsoft Windows, instale a nova versão do agente conforme descrito em Como instalar no Microsoft Windows. Isso remove todos os agentes anteriores instalados.

Como remover o agente

Use os comandos da tabela a seguir para remover o agente:

Debian e Ubuntu

Execute os seguintes comandos nos sistemas Linux Debian ou Ubuntu:

sudo apt-get purge stackdriver-agent

Amazon Linux

Execute o seguinte comando no Amazon Linux:

sudo yum remove stackdriver-agent

Red Hat e CentOS

Execute o seguinte comando nos sistemas Linux Red Hat ou CentOS:

sudo yum remove stackdriver-agent

SUSE

Execute o seguinte comando no Linux SUSE:

sudo zypper remove stackdriver-agent

Microsoft 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.

Solução de problemas

Consulte a página Solução de problemas.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Stackdriver Monitoring
Precisa de ajuda? Acesse nossa página de suporte.