Vista geral do agente de registos

Este guia fornece informações básicas sobre o agente Logging, uma aplicação baseada no fluentd que é executada nas suas instâncias de máquinas virtuais (VM).

Na sua configuração predefinida, o agente de registo transmite registos de aplicações de terceiros comuns e software do sistema para o registo; reveja a lista de registos predefinidos. Pode configurar o agente para transmitir registos adicionais; aceda a Configurar o agente de registo para ver detalhes sobre a configuração e o funcionamento do agente.

É uma prática recomendada executar o agente de registo em todas as instâncias de VM. O agente é executado no Linux e no Windows.

Para instalar o agente de registos, consulte o artigo Instalar o agente de registos.

Como funciona o agente de registos

Sistemas operativos compatíveis

Pode executar o agente Logging nos seguintes sistemas operativos em instâncias de máquinas virtuais (VMs) compatíveis:

  • Rocky Linux 8
  • RHEL 8: rhel-8-6-sap-ha, rhel-8-8-sap-ha
  • Debian 11 (Bullseye)
  • SLES 12: sles-12-sp5-sap
  • SLES 15: sles-15-sp6, sles-15-sp3-sap, sles-15-sp4-sap, sles-15-sp5-sap
  • Windows Server 2016 e 2019
  • Windows Server Core 2016 e 2019

Se estiver a executar VMs do SO otimizado para contentores, siga as instruções do SO otimizado para contentores para recolher registos das suas VMs.

Ambientes suportados

O agente de registo é compatível com os seguintes ambientes:

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

    Para instâncias sem endereços IP externos, tem de ativar o acesso privado à Google para permitir que o agente de registo envie registos.

  • Instâncias do Amazon Elastic Compute Cloud (Amazon EC2). O agente do Logging envia os registos da AWS para um Google Cloud projeto.

    Para que o agente de registo funcione corretamente, a instância do Amazon EC2 na qual é executado tem de conseguir comunicar com as APIs Google Cloud, especialmente a API Logging. Isto requer um endereço IP externo ou um gateway de Internet da VPC.

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

As seguintes instâncias de VM suportam o Logging através do respetivo software, pelo que a instalação manual do agente do Logging nas mesmas não é suportada:

Apoio técnico para nuvens híbridas e nas instalações

Google Cloud faz parceria com a Bindplane para fornecer serviços de registo para plataformas no local e na nuvem híbrida de forma consistente e previsível. Com o Bindplane, pode recolher os seus próprios dados e enviá-los para o Logging para análise. O Bindplane integra-se com o Cloud Logging para capturar dados da sua infraestrutura e está incluído no seu projeto sem custos adicionais.

Para mais informações sobre o Bindplane e o Bindplane, consulte o artigo Acerca do Bindplane e do Bindplane.

Requisitos de acesso de agentes

A execução do agente requer acesso aos seguintes nomes DNS:

  • Servidor de tokens 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 estiver a usar uma versão mais antiga do agente, recomendamos que atualize o agente para a versão mais recente.

  • APIs de registo: logging.googleapis.com

A instalação do agente requer acesso aos seguintes nomes de DNS:

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

  • Servidor de transferência da Google: dl.google.com

Código-fonte do agente de registos

Não precisa das informações nesta secção, a menos que queira compreender o código fonte ou tenha outras necessidades especiais. O agente de registo é instalado pelo script descrito nas instruções de instalação.

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

  • O repositório do GitHub denominado google-fluentd que inclui o programa fluentd principal, os scripts de embalagem personalizados e o plug-in de saída para a API Cloud Logging.
    • O plug-in de saída é incluído como um gem Ruby e está incluído no pacote google-fluentd. Também está disponível em separado no serviço de alojamento de gemas Ruby em fluent-plugin-google-cloud.
    • O conteúdo relacionado com o instalador do Windows encontra-se na pasta windows-installer.
  • O repositório do GitHub denominado google-fluentd-catch-all-config que inclui os ficheiros de configuração do agente de registo para carregar os registos de vários pacotes de software de terceiros.

Notas de lançamento do agente de registos

  • Pode encontrar as notas de lançamento do google-fluentd pacote Linux em google-fluentd/releases, onde as etiquetas de lançamento seguem o formato de versão semântica [Major].[Minor].[Patch].

  • Pode encontrar as notas de lançamento dos instaladores do Windows na mesma localização: google-fluentd/releases. No entanto, as etiquetas de lançamento têm o prefixo Windows.

  • Pode encontrar as notas de lançamento da gema autónoma fluent-plugin-google-cloud em fluent-plugin-google-cloud/releases, onde as etiquetas de lançamento seguem o formato de versão semântica [Major].[Minor].[Patch].

Política de descontinuação

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

Passos seguintes