Visão geral do agente do Cloud 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).

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 aprimorada do recurso 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 Cloud 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
• Debian 9 "Stretch" e 10 "Buster"
• Red Hat Enterprise Linux 7 e 8
• 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 para SAP, 15 SP1 para SAP e 15 SP2 para SAP
• OpenSUSE Leap 15
• Windows Server 2012 R2, 2016 e 2019
• Windows Server Core 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 de 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).

Observação: o agente padrão do Logging não é compatível com máquinas no local. No entanto, os clusters do Anthos no VMware vêm com uma versão do agente já instalada e pronta para uso.

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:

• Instâncias de ambiente padrão do App Engine. O App Engine inclui suporte integrado para o Logging. Para mais informações, acesse Como gravar registros do aplicativo.

• Instâncias do ambiente flexível do App Engine. Os apps em execução no ambiente flexível do App Engine podem gravar registros além dos incluídos no ambiente padrão do App Engine. Para mais informações, acesse Como gravar registros do aplicativo.

• Instâncias do node Google Kubernetes Engine. É possível ativar o Cloud Operations para GKE, uma solução integrada de monitoramento e registro, para os clusters de contêineres novos ou atuais.

• Para instâncias em execução nos clusters do Anthos no VMware, o agente coleta registros do sistema, mas não do aplicativo.

• Instâncias de contêiner do Cloud Run. O Cloud Run inclui suporte integrado para o Logging. Para mais informações, acesse Como gerar e visualizar registros.

• HTTP do Cloud Functions e funções de plano de fundo. O Cloud Functions inclui suporte integrado para o Logging. Para mais informações, acesse Como gravar, ver e responder registros.

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 atualizar o agente 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 suspensão de uso de agentes do pacote de operações do Google Cloud.

Próximas etapas

• Como instalar o agente do Logging

• Como configurar o agente do Logging

• Como dar autorização ao agente do Logging

• Como fazer upgrade do agente do Logging

• Depois de instalar o agente, visualize os registros no Explorador de registros.