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.
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:
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 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:
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 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 principalfluentd
, 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 plug-in de saída é empacotado como uma gem do Ruby e é incluído no pacote
- 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 emgoogle-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 prefixoWindows
.As notas de lançamento do gem autônomo
fluent-plugin-google-cloud
são encontradas emfluent-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
Depois de instalar o agente, visualize os registros no Explorador de registros.