Como instalar o agente do Stackdriver Logging

O agente do Logging transmite para o Stackdriver Logging os registros das instâncias de VM e dos pacotes específicos de software de terceiros. 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.

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 Platform (GCP) ou conta da Amazon Web Services (AWS)

    • Ao instalar o agente do Logging, é necessário um mínimo de 250 MiB de memória, mas o recomendado é 1 GiB.
  • 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 Stackdriver.

  • Credenciais na instância de VM que autorizem a comunicação com o Stackdriver As instâncias de VM do Compute Engine normalmente têm as credenciais corretas por padrão. 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 GCP para instâncias de VM da AWS EC2

A documentação do Stackdriver geralmente se refere ao projeto do GCP associado à instância de VM. Para instâncias de VM da EC2, a frase se refere ao projeto de conector vinculado à sua 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. Ele tem os tributos a seguir:

  • Um nome que começa com AWS Link

  • Um ID que começa com aws-

    Esse ID é o projeto do GCP associado à 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 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 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.

Se você estiver tentando ativar a criação de registros estruturados, consulte as instruções de instalação para os registros estruturados.

LINUX

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

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

    curl -sSO https://dl.google.com/cloudagents/install-logging-agent.sh
    sudo bash install-logging-agent.sh
    
  3. Se você usa um proxy HTTP, faça o seguinte:

    1. Edite o seguinte arquivo:

           /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
      

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. Abra uma conexão de terminal com a instância usando o RDP ou uma ferramenta similar e faça login no Windows.

  2. 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
    
  3. 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-9.exe", ".\StackdriverLogging-v1-9.exe")
    .\StackdriverLogging-v1-9.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-9.exe

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

    .\StackdriverLogging-v1-9.exe /S
    

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

    .\StackdriverLogging-v1-9.exe /S /D="C:\Stackdriver\Logging\"
    

    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 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 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:

DEBIAN ou 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

AMAZON LINUX, RED HAT ou CENTOS

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

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 os seguintes comandos na instância de VM 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:

DEBIAN ou 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

AMAZON LINUX, RED HAT ou CENTOS

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

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.

DEBIAN ou 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

AMAZON LINUX, RED HAT ou CENTOS

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

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.

Solução de problemas

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