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

O agente do Logging faz o streaming de registros das instâncias de VM e de pacotes selecionados de software de terceiros para o Cloud Logging. Recomendamos executar o agente do Logging em todas as instâncias de VM.

As imagens da VM para o Compute Engine e o Amazon Elastic Compute Cloud (EC2) não incluem o agente do Logging. Por isso, você precisa concluir estas etapas para instalá-lo nas instâncias. O agente é executado no Linux e no Windows.

Se as VMs estiverem em execução no Google Kubernetes Engine ou no App Engine, o agente já estará incluído na imagem da VM, o que significa que esta etapa pode ser pulada.

Se você estiver executando cargas de trabalho de geração de registros especializadas que exigem maior capacidade e/ou eficiência do recurso aprimorada em comparação com o agente padrão do Cloud Logging, use o agente de operações.

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 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 Logging requer acesso aos 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, 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 e verifique se você tem acesso a sudo.

  2. Altere para um diretório em que você tenha acesso de gravação, como seu diretório principal.

  3. Adicione o repositório de pacotes do agente:

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
    sudo bash add-logging-agent-repo.sh
    
  4. Instale o agente:

    1. Liste as versões disponíveis do agente para selecionar qual versão instalar:

      sudo yum list --showduplicates google-fluentd
      
    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 em uma versão principal, execute:

      sudo yum install -y google-fluentd-major-version.*
      

      Por exemplo, para fixar no 1.x.x do agente, execute:

      sudo yum install -y google-fluentd-1.*
      
    3. Se você não quiser fixar em uma versão principal, é possível selecionar uma das outras opções de instalação:

      1. Para instalar uma versão específica do agente, execute:

          sudo yum install -y google-fluentd-version-number
        
      2. Para instalar a versão mais recente do agente, execute:

          sudo yum install -y google-fluentd
        
  5. Instale os arquivos de configuração.

    1. Para geração de registros não estruturados, execute:

      sudo yum install -y google-fluentd-catch-all-config
      
    2. Para geração de registros estruturados, execute:

      sudo yum install -y google-fluentd-catch-all-config-structured
      

      Para mais informações sobre o assunto, consulte o guia de geração de registros estruturados.

  6. Inicie o serviço do agente

    sudo service google-fluentd 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 google-fluentd status
    

    O status do agente deve ser OK.

  • Também é possível examinar os registros e garantir que não há erros:

    tail /var/log/google-fluentd/google-fluentd.log
    

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

DEBIAN/UBUNTU

  1. Abra uma conexão de terminal para a instância de VM usando SSH ou uma ferramenta semelhante e verifique se você tem acesso a sudo.

  2. Altere para um diretório em que você tenha acesso de gravação, como seu diretório principal.

  3. Adicione o repositório de pacotes do agente:

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
    sudo bash add-logging-agent-repo.sh
    sudo apt-get update
    
  4. Instale o agente:

    1. Liste as versões disponíveis do agente para selecionar qual versão instalar:

      sudo apt-cache madison google-fluentd
      
    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 em uma versão principal, execute:

      sudo apt-get install -y 'google-fluentd=major-version.*'
      

      Por exemplo, para fixar no 1.x.x do agente, execute:

      sudo apt-get install -y 'google-fluentd=1.*'
      
    3. Se você não quiser fixar em uma versão principal, é possível selecionar uma das outras opções de instalação:

      1. Para instalar uma versão específica do agente, execute:

          sudo apt-get install -y google-fluentd=version-number
        
      2. Para instalar a versão mais recente do agente, execute:

          sudo apt-get install google-fluentd
        
  5. Instale os arquivos de configuração.

    1. Para geração de registros não estruturados, execute:

      sudo apt-get install -y google-fluentd-catch-all-config
      
    2. Para geração de registros estruturados, execute:

      sudo apt-get install -y google-fluentd-catch-all-config-structured
      

      Para mais informações sobre o assunto, consulte o guia de geração de registros estruturados.

  6. Inicie o serviço do agente

    sudo service google-fluentd 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 google-fluentd status
    

    O status do agente deve ser OK.

  • Também é possível examinar os registros e garantir que não há erros:

    tail /var/log/google-fluentd/google-fluentd.log
    

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

SLES/SUSE

  1. Abra uma conexão de terminal para a instância de VM usando SSH ou uma ferramenta semelhante e verifique se você tem acesso a sudo.

  2. Altere para um diretório em que você tenha acesso de gravação, como seu diretório principal.

  3. Adicione o repositório de pacotes do agente:

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
    sudo bash add-logging-agent-repo.sh
    
  4. Instale o agente:

    1. Liste as versões disponíveis do agente para selecionar qual versão instalar:

      sudo zypper search -s google-fluentd
      
    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 em uma versão principal, execute:

      sudo zypper install -y 'google-fluentd<major-version.0.0'
      

      Por exemplo, para fixar no 1.x.x do agente, execute:

      sudo zypper install -y 'google-fluentd<2.0.0'
      
    3. Se você não quiser fixar em uma versão principal, é possível selecionar uma das outras opções de instalação:

      1. Para instalar uma versão específica do agente, execute:

          sudo zypper install -y google-fluentd=version-number
        
      2. Para instalar a versão mais recente do agente, execute:

          sudo zypper install google-fluentd
        
  5. Instale os arquivos de configuração.

    1. Para geração de registros não estruturados, execute:

      sudo zypper install -y google-fluentd-catch-all-config
      
    2. Para geração de registros estruturados, execute:

      sudo zypper install -y google-fluentd-catch-all-config-structured
      

      Para mais informações sobre o assunto, consulte o guia de geração de registros estruturados.

  6. Inicie o serviço do agente

    sudo service google-fluentd 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 google-fluentd status
    

    O status do agente deve ser OK.

  • Também é possível examinar os registros e garantir que não há erros:

    tail /var/log/google-fluentd/google-fluentd.log
    

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:

  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://dl.google.com/cloudagents/windows/StackdriverLogging-v1-12.exe", ".\StackdriverLogging-v1-12.exe")
    .\StackdriverLogging-v1-12.exe
    

    Como alternativa, é possível acessar até o URL a seguir para fazer o download e executar o instalador do agente:

    https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-12.exe

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

    .\StackdriverLogging-v1-12.exe /S
    

    No modo “silencioso”, use a opção /D para especificar o diretório de instalação, por exemplo:

    .\StackdriverLogging-v1-12.exe /S /D="C:\Google Cloud's operations suite\Logging\"
    

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

O agente vem pré-configurado para monitorar determinados locais de registro conhecidos. No Linux, esses locais são descritos no pacote google-fluentd-catch-all-config, que é automaticamente solicitado pelo script de instalação. No Windows, o agente monitora o log de eventos do SO por padrão. Se você quiser ajustar a configuração do agente, consulte Como configurar o agente do Logging.

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

  1. Edite o arquivo de configuração a seguir (precisa ser criado se não existir):

     /etc/default/google-fluentd
    
  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 Logging ao executar o comando a seguir na instância de VM.

     sudo service google-fluentd restart
    

WINDOWS

  1. 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 Logging 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 Logging no seu 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' \
     google-fluentd 
google-fluentd-catch-all-config
google-fluentd-catch-all-config-structured

DEBIAN/UBUNTU

Execute este comando no Debian ou no Ubuntu:

dpkg-query --show --showformat \
    '${Package} ${Version} ${Architecture} ${Status}\n' \
     google-fluentd 
google-fluentd-catch-all-config
google-fluentd-catch-all-config-structured

SLES/SUSE

Execute o comando a seguir no SUSE:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     google-fluentd 
google-fluentd-catch-all-config
google-fluentd-catch-all-config-structured

Windows

Execute o comando a seguir no Windows:

reg query HKLM\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\GoogleStackdriverLoggingAgent\ /v Version

Como reiniciar o agente

Você precisa reiniciar o agente do Logging 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 google-fluentd restart

Depois de reiniciar o agente do Logging, envie uma mensagem de teste.

WINDOWS

Requer privilégios de administrador: para reiniciar o agente, execute o seguinte comando em um terminal do PowerShell:

Restart-Service -Name StackdriverLogging

Como atualizar o agente

Para atualizar o agente do Logging 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 upgrade google-fluentd

O comando anterior não altera o arquivo de configuração do agente. Para ver a configuração padrão mais recente e os arquivos de configuração de atualização, execute os seguintes comandos na sua instância:

sudo yum upgrade google-fluentd google-fluentd-catch-all-config

DEBIAN/UBUNTU

Execute os seguintes comandos no Debian ou no Ubuntu:

sudo apt-get update
sudo apt-get install --only-upgrade google-fluentd

Os comandos anteriores não alteram o arquivo de configuração do agente. Para ver a configuração padrão mais recente e os arquivos de configuração de atualização, execute os seguintes comandos na sua instância:

sudo apt-get install --only-upgrade -o Dpkg::Options::="--force-confnew" google-fluentd-catch-all-config
sudo apt-get install --only-upgrade google-fluentd

SLES/SUSE

Execute o comando a seguir no SUSE:

sudo zypper update google-fluentd

O comando anterior não altera o arquivo de configuração do agente. Para ver a configuração padrão mais recente e os arquivos de configuração de atualização, execute os seguintes comandos na sua instância:

sudo zypper update google-fluentd google-fluentd-catch-all-config

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 Logging 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 service google-fluentd stop
sudo yum remove google-fluentd google-fluentd-catch-all-config

DEBIAN/UBUNTU

Execute este comando no Debian ou no Ubuntu:

sudo service google-fluentd stop
sudo apt-get remove google-fluentd google-fluentd-catch-all-config

SLES/SUSE

Execute o seguinte comando no Linux SUSE:

sudo service google-fluentd stop
sudo zypper remove google-fluentd google-fluentd-catch-all-config

WINDOWS

No Painel de Controle do Windows, escolha Desinstalar um programa. Você verá o agente do Logging na lista de programas.