Como instalar o agente do Cloud Logging em várias VMs

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:

Como instalar o agente usando a 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

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

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

  3. Execute:

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

Windows

  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 com privilégios de administrador. Para isso, clique com o botão direito do mouse no ícone do PowerShell e selecione Executar como administrador.

  3. Execute os seguintes comandos do PowerShell:

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-17.exe", "${env:UserProfile}\StackdriverLogging-v1-17.exe")
    & "${env:UserProfile}\StackdriverLogging-v1-17.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

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

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

  3. Faça o download do script de instalação do agente:

    curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
    

    Ao executar o script add-logging-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.
    • --uninstall-standalone-logging-agent: desinstala o agente do Logging legado (StackdriverLogging).
    • --uninstall-standalone-monitoring-agent: desinstala o agente legado do Monitoring (StackdriverMonitoring).

    Consulte os comentários do script para mais informações e exemplos de uso.

  4. 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-logging-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.*.*
      

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

      sudo bash add-logging-agent-repo.sh --also-install \
        --version=1.*.*
      
    3. Para instalar uma versão específica do agente, execute:

      sudo bash add-logging-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
      
  5. Reiniciar o serviço do agente

    É necessário reiniciar para que as configurações instaladas pelos pacotes pega-tudo acima entrem em vigor.

    sudo service google-fluentd restart
    

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

  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 com privilégios de administrador. Para isso, clique com o botão direito do mouse no ícone do PowerShell e selecione Executar como administrador.

    1. Execute os seguintes comandos do PowerShell:

      (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-17.exe", "${env:UserProfile}\StackdriverLogging-v1-17.exe")
      & "${env:UserProfile}\StackdriverLogging-v1-17.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-17.exe

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

    & "${env:UserProfile}\StackdriverLogging-v1-17.exe" /S
    

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

    & "${env:UserProfile}\StackdriverLogging-v1-17.exe" /S /D="C:\Stackdriver\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.

Como instalar o agente usando o Console do Google Cloud

É possível instalar o agente em uma ou mais VMs do Compute Engine no painel Instâncias de VM do Monitoring pré-configurado.

Para acessar esse painel, faça o seguinte:

  1. No Console do Cloud, selecione seu projeto do Google Cloud.

    Acessar o Console do Cloud

  2. No painel de navegação, selecione Monitoring.

  3. No painel de navegação do Monitoring, selecione Painéis.

  4. Na tabela de painéis, localize a entrada das Instâncias de VM e clique no nome.

A guia Inventário no painel Instâncias de VM lista todas as VMs e contém uma coluna de status para o agente, como mostra a 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. Se o Cloud Monitoring não detectar nenhum agente instalado na instância do Compute Engine, será possível instalar um agente da seguinte maneira:

    • Selecione as instâncias de VM em que você quer instalar agentes.
    • Clique na opção Instalar agentes na tabela Instâncias, que gera um fluxo de trabalho de instalação no painel e siga as instruções. O agente de operações é o agente padrão instalado, mas o fluxo de trabalho de instalação fornece um link para instalar os agentes legados.

      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.

  • Agente de operações: você está executando o agente de operações.

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

  • VM interrompida: a VM não está em execução e, portanto, o status do agente é desconhecido.

Tarefas opcionais

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

Ativar a geração de registros estruturados

Ao executar o script de instalação em uma VM do Linux, por padrão, o script instala o pacote google-fluentd-catch-all quando a sinalização --also-install está presente. Para alternar para a geração de registros estruturados, conclua as etapas a seguir.

  1. Faça backup de todas as alterações locais para /etc/google-fluentd/config.d/.

  2. Execute um dos seguintes comandos, dependendo da sua distribuição do Linux:

    • YUM:

      sudo yum remove -y google-fluentd-catch-all-config
      sudo yum install -y google-fluentd-catch-all-config-structured
      sudo service google-fluentd restart
      
    • APT:

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

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

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.

Para ajustar a configuração do agente, consulte Como configurar o agente.

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 seguinte arquivo de configuração (crie o arquivo, se ele ainda não existir):

     /etc/default/google-fluentd
    
  2. 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.
    
  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

  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 com privilégios de administrador. Para isso, clique com o botão direito do mouse no ícone do PowerShell e selecione Executar como administrador.

  3. Execute o seguinte comando do PowerShell:

     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

  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 com privilégios de administrador. Para isso, clique com o botão direito do mouse no ícone do PowerShell e selecione Executar como administrador.

  3. Execute o seguinte comando 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:

Linux

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

sudo bash add-logging-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-logging-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 google-fluentd

DEBIAN/UBUNTU

Liste as versões disponíveis do agente:

sudo apt-cache madison google-fluentd

SLES/SUSE

Liste as versões disponíveis do agente:

sudo zypper search -s google-fluentd

WINDOWS

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

Como desinstalar o agente

Para remover o agente do Logging 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-logging-agent-repo.sh --uninstall

Windows

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

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 Como visualizar 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 Logging requer acesso aos 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.

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.

A seguir