Sobre o 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, 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 softwares 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) e 19.10 (Eoan Ermine)
  • Ubuntu Minimal LTS 16.04 (Xenial Xerus), LTS 18.04 (Bionic Beaver) e 19.10 (Eoan Ermine)
  • 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). 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. A uma taxa de máxima de 3.000 entradas de registro de 1 KB por segundo, o agente do Logging usa 80% de CPU em um núcleo e 250 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 (em inglês) para fornecer serviços de registro para plataformas de nuvem híbridas 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 (em inglês) se integra ao Cloud Logging para capturar dados da sua infraestrutura e é incluído em seu projeto sem custo extra.

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 (em inglês) que inclui o programa principal fluentd, os scripts de empacotamento personalizado e o plug-in de saída da API do 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.
  • 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.

Política de suspensão de uso

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

A seguir