Sobre o agente do Logging

Neste guia, apresentamos informações básicas sobre o agente do Stackdriver Logging, um aplicativo baseado em fluentd executado nas instâncias de máquina virtual (VM, na sigla em inglês).

Como funciona o agente do Stackdriver Logging

Na configuração padrão, o agente do Stackdriver Logging faz streaming de registros de aplicativos terceirizados e software de sistema comuns para o Stackdriver Logging. Consulte a lista de registros compatíveis. Configure o agente para fazer streaming de outros registros. Consulte Como configurar o agente do Stackdriver Logging para detalhes sobre configuração e operação do agente.

Executar o agente do Stackdriver Logging em todas as instâncias de VM é uma prática recomendada. O agente é executado no Linux e no Windows. Para instalar o agente do Stackdriver Logging, consulte Como instalar o agente da geração de registros.

Sistemas operacionais compatíveis

Execute o agente do Stackdriver Logging nos seguintes sistemas operacionais em instâncias de VM compatíveis:

  • CentOS 6 e 7
  • Debian 9 "Stretch"
  • Red Hat Enterprise Linux 6 e 7
  • Ubuntu LTS 16.04 "Xenial", LTS 18.04 "Bionic" e 18.10 "Cosmic"
  • SUSE Linux Enterprise Server 12 SP3, 12 SP2 para SAP e 12 SP3 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 Stackdriver Logging é compatível com os seguintes ambientes:

  • Instâncias do Compute Engine. Os registros são enviados para o projeto associado a cada instância de VM pelo agente do Stackdriver Logging.

    Para instâncias sem endereços IP externos, você precisa ativar o Acesso particular do Google para permitir que o agente do Stackdriver Logging envie registros.

  • Instâncias do Amazon Web Services Elastic Compute Cloud (AWS EC2). O agente do Stackdriver Logging envia os registros para o projeto de conector do AWS do espaço de trabalho. Esse projeto é criado pelo Stackdriver quando você conecta a conta do AWS a um espaço de trabalho.

    Para que o agente do Stackdriver Logging funcione corretamente, a instância do Amazon EC2 em que ele é executado precisa se comunicar com as APIs do Google Cloud, principalmente a API Stackdriver Logging. Isso requer um endereço IP externo ou um gateway de internet VPC.

Para as instâncias de VMs acima, é obrigatório ter um mínimo de 250 MiB de memória residente (RSS) para executar o agente do Stackdriver Logging, mas recomenda-se 1 GiB. Por exemplo, a uma taxa de 100 entradas de registro de 1 KB por segundo, o agente do Stackdriver Logging com as configurações padrão consome 5% da CPU em um núcleo e 150 MiB de memória. Com uma taxa de pico de 3.000 entradas de registro de 1 KB por segundo, o agente do Stackdriver Logging usa 80% da CPU em um núcleo e 250 MiB de memória.

Essas instâncias de VM aceitam que o próprio software seja usado pelo Stackdriver Logging, possivelmente incluindo versões personalizadas ou configurações do agente do Stackdriver Logging. A instalação manual do agente do Stackdriver Logging nelas não é compatível:

Requisitos de acesso do agente

Para executar o agente, é preciso ter acesso aos seguintes nomes DNS:

  • Servidor de token OAuth2: oauth2.googleapis.com

    As versões mais antigas do agente podem exigir o acesso a www.googlapis.com (URL completo: https://www.googleapis.com/oauth2/v3/token).

    Se você estiver usando uma versão mais antiga do agente, recomendamos que faça upgrade do agente para a versão mais recente.

  • APIs do Logging: logging.googleapis.com

Para instalar o agente, é preciso ter acesso aos seguintes nomes DNS:

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

  • (Windows) Servidor de download do Google: dl.google.com

Código-fonte do agente do Stackdriver Logging

Você não precisará das informações nesta seção, a menos que você queira entender o código-fonte ou tenha outras necessidades especiais. O agente do Stackdriver Logging é instalado pelo script descrito nas instruções de instalação.

O agente do Stackdriver 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 do GitHub associados:

  • O repositório do GitHub chamado google-fluentd, que inclui o programa principal do fluentd, os scripts de empacotamento personalizado e o plug-in de saída da API Stackdriver Logging.
    • O plug-in de saída é empacotado como uma gem do Ruby e está 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, que inclui os arquivos de configuração do agente do Stackdriver Logging referentes à ingestão dos registros de vários pacotes de software de terceiros.

Política de desativação

O agente do Stackdriver Logging está sujeito à política de desativação de agentes do Stackdriver.

A seguir

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Stackdriver Logging
Precisa de ajuda? Acesse nossa página de suporte.