Visão geral do agente do Logging

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

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, consulte Como instalar o agente do Logging.

Como funciona o agente do Logging

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 7 e 8
  • Rocky Linux 8
  • Red Hat Enterprise Linux 7 e 8
  • Debian 9 "Stretch", 10 "Buster" e 11 "Bullseye"
  • Ubuntu LTS 20.04 (Focal Fossa)
  • Ubuntu Minimal LTS 20.04 (Focal Fossa)
  • SUSE Linux Enterprise Server 12 e 12 SP5 para SAP
  • SUSE Linux Enterprise Server 15, 15 SP2 para SAP, 15 S3 para SAP, 15 SP4 para SAP e 15 SP5 para SAP
  • OpenSUSE Leap 15, 15.2, 15.3 e 15.4
  • Windows Server 2016 e 2019
  • Windows Server Core 2016 e 2019
  • Amazon Linux AMI (exceto Amazon Linux 2.0 AMI)

Se você estiver executando VMs do Container-Optimized OS, siga as instruções do Container-Optimized OS para coletar registros das suas VMs.

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 Elastic Compute Cloud (Amazon EC2). O agente do Logging envia os registros ao projeto do conector da AWS que vincula a conta da AWS aos serviços do Google Cloud.

    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 observIQ para fornecer serviços de geração de registros para plataformas de nuvem híbrida e locais de maneira consistente e previsível. Com o BindPlane, é possível coletar seus próprios dados e enviá-los ao Logging para análise. O BindPlane é integrado ao Cloud Logging para capturar dados da sua infraestrutura e é incluído no seu projeto sem custo adicional.

Para mais informações sobre o observIQ e o BindPlane, consulte Sobre o observIQ e o BindPlane.

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: 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 suspensão de uso

O agente do Logging está sujeito à política de descontinuação dos agentes do Google Cloud Observability.

Próximas etapas