Como instalar o agente

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

As imagens de VM do Compute Engine e do AWS EC2 não incluem o agente do Logging. Portanto, será necessário instalá-lo nessas instâncias. O agente é executado tanto no Linux como no Windows.

Antes de começar

Verifique se o agente do Stackdriver Logging é compatível com sua instância de VM e saiba mais sobre os espaços de trabalho. Para saber mais sobre os requisitos e os ambientes compatíveis, consulte a página Sobre o agente do Stackdriver Logging.

Instâncias de VM compatíveis

Alguns tipos de instâncias de VM já contêm o agente do Logging ou um software semelhante a ele. Para outros, é preciso instalar o agente usando as instruções nesta página:

  • Instâncias de VM do Google Cloud Platform (GCP):
    • App Engine: um agente é incluído na imagem da VM. Pule esta página.
    • GKE: um agente é incluído na imagem da VM. Pule esta página.
    • Compute Engine: instale o agente nas instâncias de VM. Elas já têm a autorização necessária. Consulte Como instalar no Linux e no Windows.
  • Amazon EC2: antes de instalar o agente, instale as credenciais de autorização nas instâncias de VM. Depois de instalar essas credenciais, retorne a este documento para concluir as etapas de instalação no Linux e Windows.

Ao instalar o agente do Stackdriver Logging, é necessário um mínimo de 250 MB de memória, mas recomenda-se 1 GB.

Faturamento do Stackdriver

Se você estiver usando instâncias de VMs do AWS, vincule sua conta do AWS a um espaço de trabalho para usar o agente do Stackdriver Logging.

Para saber mais informações, consulte Como criar um espaço de trabalho.

VMs sem acesso ao pacote remoto

A instalação do agente do Logging 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 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.

Instância do Linux

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

  2. Faça o download do script de instalação do agente do Logging executando o seguinte comando na instância de VM:

    curl -sSO https://dl.google.com/cloudagents/install-logging-agent.sh
    
  3. Execute o script de instalação com o seguinte comando:

    sudo bash install-logging-agent.sh
    

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

Instância do Windows

  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. Esse procedimento define a variável de ambiente https_proxy para que o agente possa enviar dados ao Stackdriver Logging usando HTTPS de saída:

    setx https_proxy https://[YOUR_PROXY_SERVER_URI] /m
    
  3. Abra um terminal do PowerShell e gere os três comandos do PowerShell a seguir. Não é necessário ter privilégios de administrador.

    cd $env:UserProfile;
    Invoke-WebRequest https://dl.google.com/cloudagents/windows/StackdriverLogging-v1-9.exe -OutFile StackdriverLogging-v1-9.exe;
    .\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\"
    

Para verificar ou testar sua instalação do agente do Stackdriver Logging, consulte Como verificar a instalação do agente.

Se você tiver problemas com a instalação, consulte a Solução de problemas do agente do Logging.

Outras tarefas

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 Windows por padrão. Se você quiser ajustar a configuração do agente, consulte Como configurar o agente do Logging.

Nesta seção, há uma descrição de como executar tarefas comuns de manutenção: determinar a versão do agente, reinicializar e fazer upgrade dele e desinstalá-lo.

Como determinar a versão

Para identificar a versão do agente do Logging e seus componentes de configuração, execute o comando a seguir:

Instância do Linux

Execute o seguinte comando na instância:

# For Debian and Ubuntu systems:
dpkg-query --show --showformat \
    '${Package;-45} ${Version;-10} ${Architecture;-8} ${Status;-25}\n' \
    google-fluentd \
    google-fluentd-catch-all-config \
    google-fluentd-catch-all-config-structured

# For Amazon Linux, Red Hat, CentOS, and SUSE systems:
rpm --query --queryformat \
    '%-45{NAME} %-10{VERSION} %-10{RELEASE} %-8{ARCH}\n' \
    google-fluentd \
    google-fluentd-catch-all-config \
    google-fluentd-catch-all-config-structured

Instância do Windows

Execute o comando a seguir.

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

O comando anterior retornará um erro se a versão do agente for anterior à v1-5. Faça upgrade para o agente mais recente.

Como reiniciar o agente

É preciso reiniciar o agente do Stackdriver Logging para coletar as alterações nos arquivos de configuração. Para reiniciá-lo, use as instruções a seguir.

Instância do 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.

Instância do Windows

Requer privilégios de administrador: para reiniciar o agente, execute os comandos a seguir na sua instância de VM no prompt de comando ou no PowerShell:

# For Logging agent version v1-5 and later.
net stop  StackdriverLogging
net start StackdriverLogging

# For Logging agents before v1-5.
net stop  fluentdwinsvc
net start fluentdwinsvc

Como fazer upgrade do agente

Se você quiser fazer upgrade do agente do Stackdriver Logging para a versão mais recente, use as instruções a seguir:

Instância do Linux

Para atualizar para a versão mais recente do agente, execute o seguinte comando na instância:

# For Debian and Ubuntu systems:
sudo apt-get install --only-upgrade google-fluentd

# For Amazon Linux, Red Hat and CentOS systems:
sudo yum upgrade google-fluentd

# For SUSE systems:
sudo zypper update 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:

# For Debian and Ubuntu systems:
sudo apt-get install --only-upgrade -o Dpkg::Options::="--force-confnew" google-fluentd-catch-all-config
sudo apt-get install --only-upgrade google-fluentd

# For Amazon Linux, Red Hat and CentOS systems:
sudo yum upgrade google-fluentd google-fluentd-catch-all-config

# For SUSE systems:
sudo zypper update google-fluentd google-fluentd-catch-all-config

Uma alternativa é remover o agente atual e instalar o agente mais recente. Essa é a abordagem recomendada ao fazer upgrades que podem causar alterações de configuração. Por exemplo, no caso de bump da versão principal.

Instância do Windows

Para atualizar para a versão mais recente do agente, instale-o conforme descrito em Como instalar no Windows. Você precisará desinstalar a versão anterior do agente.

Como desinstalar o agente

Para remover o agente do Stackdriver Logging e os respectivos arquivos de configuração, use as instruções a seguir.

Instância do Linux

Desinstale o agente do Linux atual:

# For Debian and Ubuntu systems:
sudo service google-fluentd stop
sudo apt-get remove google-fluentd google-fluentd-catch-all-config

# For Amazon Linux, Red Hat and CentOS systems:
sudo service google-fluentd stop
sudo yum remove google-fluentd google-fluentd-catch-all-config

# For SUSE systems:
sudo service google-fluentd stop
sudo zypper remove google-fluentd google-fluentd-catch-all-config

Instância do Windows

Desinstale o agente atual executando o seguinte comando:

[AGENT_INSTALLATION_DIRECTORY]\uninstall.exe

Se estiver executando a versão do agente do Logging v1-5 ou posterior, use o diretório que você escolheu ao instalar o agente. O diretório de instalação padrão é:

C:\Program Files (x86)\Stackdriver\LoggingAgent\

Caso você esteja executando uma versão do agente do Stackdriver Logging anterior à v1-5, o caminho do diretório de instalação será:

C:\GoogleStackdriverLoggingAgent\

Para mais informações, consulte Como configurar o agente do Logging.

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

Enviar comentários sobre…

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