Visão geral do agente do Logging

Neste guia, você verá informações básicas sobre o agente do Logging, um aplicativo baseado em 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.

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.

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 (VM) 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 18.04 (Bionic Beaver) e LTS 20.04 (Focal Fossa)
  • Ubuntu Minimal LTS 18.04 (Bionic Beaver) e LTS 20.04 (Focal Fossa)
  • SUSE Linux Enterprise Server 12, 12 SP3 para SAP, 12 SP4 para SAP e 12 SP5 para SAP
  • SUSE Linux Enterprise Server 15, 15 SP1 for SAP, 15 SP2 para SAP, 15 SP3 for SAP, e 15 SP4 para SAP
  • OpenSUSE Leap 15, 15.2, 15.3 e 15.4
  • Windows Server 2012 R2, 2016 e 2019
  • Windows Server Core 2012 R2, 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:

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

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

Próximas etapas