Sobre o agente do Logging

Neste guia, você verá informações básicas sobre o agente do Cloud Logging, um aplicativo baseado em fluentd que é executado em instâncias de máquina virtual (VM, na sigla em inglês).

Como funciona o agente do Logging

Em sua configuração padrão, o agente do Logging transmite registros de aplicativos de terceiros e software de sistema comuns para o Logging. Veja a lista de registros padrão. É possível configurar o agente para transmitir outros registros. Acesse Como configurar o agente do Logging para mais detalhes sobre a configuração e a operação do agente.

Recomendamos executar o agente do Logging em todas as instâncias de VM. O agente é executado no Linux e no Windows. Para instalar o agente do Logging, acesse Como instalar o agente.

Sistemas operacionais compatíveis

É possível executar o agente do Logging nos sistemas operacionais a seguir em instâncias de máquina virtual compatíveis:

  • CentOS 6, 7 e 8
  • Debian 9 "Stretch" e 10 "Buster"
  • Red Hat Enterprise Linux 6, 7 e 8
  • Ubuntu LTS 16.04 (Xenial Xerus), LTS 18.04 (Bionic Beaver), 19.10 (Eoan Ermine) e LTS 20.04 (Focal Fossa)
  • Ubuntu Minimal LTS 16.04 (Xenial Xerus), LTS 18.04 (Bionic Beaver), 19.10 (Eoan Ermine) e LTS 20.04 (Focal Fossa)
  • SUSE Linux Enterprise Server 12 SP3, 12 SP2 para SAP, 12 SP3 para SAP, 15, 15 para SAP e 15 SP1 para SAP
  • Windows Server 2008 R2, 2012 R2, 2016 e 2019
  • Amazon Linux AMI (exceto Amazon Linux 2.0 AMI)

Ambientes compatíveis

O agente do Logging é compatível com os seguintes ambientes:

  • Instâncias do Compute Engine. O agente do Logging envia os registros para o projeto associado a cada instância de VM.

    Para instâncias sem endereços IP externos, você precisa ativar o Acesso privado do Google para permitir que o agente do Logging envie registros.

  • Instâncias do Amazon Web Services Elastic Compute Cloud (AWS EC2) (em inglês). O agente do Logging envia os registros ao projeto do conector da AWS para seu espaço de trabalho. Esse projeto é criado pelo Monitoring quando você conecta a conta do AWS a um espaço de trabalho.

    Para que o agente do Logging funcione corretamente, a instância do Amazon EC2 em que ele é executado precisa ser capaz de se comunicar com as APIs do Google Cloud, especialmente com a API do Logging. Isso requer um endereço IP externo ou um gateway de Internet da VPC (em inglês).

Para essas instâncias de VM, é necessário um mínimo de 250 MiB de memória residente (RSS) para executar o agente do Logging, mas recomenda-se 1 GiB. Por exemplo, a uma taxa de 100 entradas de registro de 1 KB por segundo, o agente do Logging com configurações padrão consome 5% da CPU em um núcleo e 150 MiB de memória.

As instâncias de VM a seguir são compatíveis com o Logging em seu próprio software. Portanto, não é possível instalar manualmente o agente do Logging nelas:

Suporte para nuvens locais e híbridas

O Google Cloud fez parceria com a Blue Medora para fornecer serviços de registro para plataformas de nuvem híbrida e locais de maneira consistente e previsível. Com a Blue Medora, é possível coletar seus próprios dados e enviá-los para o Logging para análise. O Bindplane da Blue Medora se integra ao Cloud Logging para capturar dados da sua infraestrutura e é incluído em seu projeto sem custo adicional.

Para mais informações sobre a Blue Medora, acesse Sobre a Blue Medora.

Requisitos de acesso do agente

Para executar o agente, é preciso ter acesso aos seguintes nomes de DNS:

  • Servidor de token OAuth2: oauth2.googleapis.com

    As versões mais antigas do agente podem exigir acesso a www.googleapis.com. URL completo: https://www.googleapis.com/oauth2/v3/token.

    Se você estiver usando uma versão antiga do agente, recomendamos que atualize-o para a versão mais recente.

  • APIs do Logging: logging.googleapis.com

Para instalar o agente, é preciso ter acesso aos seguintes nomes de DNS:

  • (Linux) Repositório de pacotes do Google Cloud: packages.cloud.google.com

  • Servidor de download do Google para Windows: dl.google.com

Código-fonte do agente do Logging

Você não precisa das informações desta seção, a menos que queira entender o código-fonte ou tenha outras necessidades especiais. O agente do Logging é instalado pelo script descrito nas instruções de instalação.

O agente do Logging, google-fluentd, é uma versão modificada do coletor de dados de registro fluentd (em inglês). google-fluentd é distribuído em dois pacotes separados. O código-fonte está disponível nos repositórios associados do GitHub:

  • O repositório do GitHub chamado google-fluentd, que inclui o programa principal fluentd, os scripts de empacotamento personalizado e o plug-in de saída da API Cloud Logging.
    • O plug-in de saída é empacotado como uma gem do Ruby e é incluído no pacote google-fluentd. Ele também está disponível separadamente no serviço de hospedagem da gem do Ruby em fluent-plugin-google-cloud (em inglês).
    • O conteúdo relacionado ao instalador do Windows é encontrado na pasta windows-installer .
  • O repositório do GitHub chamado google-fluentd-catch-all-config (em inglês) que inclui os arquivos de configuração do agente do Logging para processar os registros de vários pacotes de software de terceiros.

Notas de lançamento do agente do Logging

  • As notas de lançamento do pacote Linux google-fluentd são encontradas em google-fluentd/releases, em que as tags da versão seguem o formato de versão semântica [Major].[Minor].[Patch].

  • As notas de lançamento para os instaladores do Windows são encontradas no mesmo local: google-fluentd/releases. Mas as tags de lançamento têm o prefixo Windows.

  • As notas de lançamento do gem autônomo fluent-plugin-google-cloud são encontradas em fluent-plugin-google-cloud/releases, em que as tags de versão seguem o formato de versão semântica [Major].[Minor].[Patch].

Política de desativação

O agente do Logging está sujeito à Política de suspensão de uso de agentes do pacote de operações do Google Cloud.

A seguir