Como instalar o agente do Cloud Monitoring

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. O Monitoring pode acessar algumas métricas do hipervisor da máquina virtual 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.

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:

Projetos do Google Cloud para instâncias de VM da AWS EC2

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

Quando você conecta sua conta do AWS a um espaço de trabalho, o projeto do conector do AWS é criado. Ele tem os atributos a seguir:

  • Um nome que começa com AWS Link

  • Um ID que começa com aws-

    Esse código é o projeto do Google Cloud associado à sua instância de VM.

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 do host da VM 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 no Linux e no Windows

Para instalar o agente em instâncias de VM que executam o Linux ou o Microsoft Windows, use as instruções a seguir.

AMAZON LINUX AMI / CENTOS / RHEL

  1. Abra uma conexão de terminal para a instância de VM usando SSH ou uma ferramenta semelhante.

  2. Verifique se você tem acesso sudo.

  3. Altere para um diretório ao qual você tenha acesso de gravação, por exemplo, seu diretório inicial.

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

  5. Instale o agente:

    1. Para instalar a versão mais recente do agente, execute:

      sudo yum install -y stackdriver-agent
          
    2. Opcionalmente, você pode listar todas as versões disponíveis do agente para selecionar a versão a ser instalada. Para listar as versões disponíveis, execute:

      sudo yum list -y stackdriver-agent
          
    3. Para ambientes de produção, talvez você queira fixar em uma versão principal para evitar extrair versões principais que podem incluir alterações incompatíveis com versões anteriores. Para fixar uma versão principal, execute:

      sudo yum install -y stackdriver-agent-[MAJOR_VERSION].*
          

      Por exemplo, para fixar na versão Nxx do agente, execute:

      sudo yum install -y stackdriver-agent-N.*
          
    4. Você também tem a opção de instalar uma versão específica do agente executando o seguinte comando:

      sudo yum install -y stackdriver-agent-[VERSION_NUMBER]
          
  6. Iniciar o serviço do agente

    sudo service stackdriver-agent start
        

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

DEBIAN / UBUNTU

  1. Abra uma conexão de terminal para a instância de VM usando SSH ou uma ferramenta semelhante.

  2. Verifique se você tem acesso sudo.

  3. Altere para um diretório ao qual você tenha acesso de gravação, por exemplo, seu diretório inicial.

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

  5. Instale o agente:

    1. Para instalar a versão mais recente do agente, execute:

      sudo apt-get install stackdriver-agent
          
    2. Opcionalmente, você pode listar todas as versões disponíveis do agente para selecionar a versão a ser instalada. Para listar as versões disponíveis, execute:

      sudo apt-cache madison stackdriver-agent
          
    3. Para ambientes de produção, talvez você queira fixar em uma versão principal para evitar extrair versões principais que podem incluir alterações incompatíveis com versões anteriores. Para fixar uma versão principal, execute:

      sudo apt-get install 'stackdriver-agent=[MAJOR_VERSION].*'
          

      Por exemplo, para fixar na versão Nxx do agente, execute:

      sudo apt-get install 'stackdriver-agent=N.*'
          
    4. Você também tem a opção de instalar uma versão específica do agente executando o seguinte comando:

      sudo apt-get install stackdriver-agent=[VERSION_NUMBER]
          
  6. Iniciar o serviço do agente

    sudo service stackdriver-agent start
        

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

SLES / SUSE

  1. Abra uma conexão de terminal para a instância de VM usando SSH ou uma ferramenta semelhante.

  2. Verifique se você tem acesso sudo.

  3. Altere para um diretório ao qual você tenha acesso de gravação, por exemplo, seu diretório inicial.

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

  5. Instale o agente:

    1. Para instalar a versão mais recente do agente, execute:

      sudo zypper install stackdriver-agent
          
    2. Opcionalmente, você pode listar todas as versões disponíveis do agente para selecionar a versão a ser instalada. Para listar as versões disponíveis, execute:

      sudo zypper search -s stackdriver-agent
          
    3. Para ambientes de produção, talvez você queira fixar em uma versão principal para evitar extrair versões principais que podem incluir alterações incompatíveis com versões anteriores. Para fixar uma versão principal, execute:

      sudo zypper install 'stackdriver-agent<[MAJOR_VERSION].0.0'
          

      Por exemplo, para fixar na versão Nxx do agente, execute:

      sudo zypper install 'stackdriver-agent<N+1.0.0'
          
    4. Você também tem a opção de instalar uma versão específica do agente executando o seguinte comando:

      sudo zypper install stackdriver-agent=[VERSION_NUMBER]
          
  6. Iniciar o serviço do agente

    sudo service stackdriver-agent start
        

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

WINDOWS

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

  1. Conecte-se à sua instância usando o RDP ou uma ferramenta semelhante e faça login no Windows.

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

    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:\Google Cloud's operations suite\Monitoring\"
        

    Exclua o instalador depois que o processo for concluído.

Tarefas opcionais

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

Como configurar um proxy HTTP

Se você usa um proxy HTTP, faça o seguinte:

LINUX

  1. Edite o seguinte arquivo de configuração:

    • 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
          
  2. 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.
        
  3. Reinicie o agente do Monitoring executando o seguinte comando na instância de VM:

     sudo service stackdriver-agent restart
        

WINDOWS

  1. Se você usar um proxy HTTP, execute o comando a seguir em um prompt de comando do 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 os seguintes comandos na instância de VM do PowerShell:

Restart-Service -Name StackdriverMonitoring
    

Como fazer upgrade do agente

Para fazer o upgrade do 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
    

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.

Como solucionar problemas

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