Visão geral das bibliotecas do Logging

Muitas linguagens de programação têm interfaces de gravação de registros padrão que podem ser reconfiguradas para usar o Logging.

Observação:Instrumente seu aplicativo para coletar informações específicas que ajudam a entender o desempenho dele e resolver problemas. Vários frameworks de instrumentação de código aberto coletam dados de registro, métrica e trace e podem enviá-los a qualquer fornecedor, incluindo o Google Cloud. Para seus aplicativos de agentes, alguns frameworks podem coletar seus comandos e respostas ou transmitir contexto que permite o rastreamento de algumas chamadas remotas de servidores MCP do Google Cloud.

Para instrumentar seu aplicativo, recomendamos o uso de um framework de instrumentação de código aberto e neutro em relação a fornecedores, como o OpenTelemetry, em vez de APIs ou bibliotecas de cliente específicas de fornecedores e produtos. Para mais informações sobre esses frameworks, consulte Observabilidade para desenvolvedores de aplicativos e Escolher uma abordagem de instrumentação.

Gravar registros

Para gravar registros no Cloud Logging, faça o seguinte:

• Grave os registros em arquivos de registro já criados, como syslog, na instância de VM do Compute Engine e use o Agente de Operações para enviar os registros ao Cloud Logging. Para mais informações, consulte Agentes do Google Cloud Observability.
• Configure um pacote de geração de registros padrão para enviar os registros gravados no Logging. Para mais informações, consulte as seguintes páginas de detalhes:
  • Qualquer linguagem: fluentd
  • C#: como usar o ASP.NET ou chamar a API
  • Java: como usar o Logback e java.util.logging
  • Go: como usar a geração de registros padrão
  • Node.js: como usar o Winston e o Bunyan
  • PHP: como usar o registrador PSR-3
  • Python: como usar o recurso de geração de registros padrão
  • Ruby: como usar a gem do Google Cloud Observability
• Chame a API Logging usando as bibliotecas de cliente do Logging para sua linguagem de programação.
• Chame diretamente o endpoint da API Logging REST. Consulte a documentação de referência da API Logging.
• Use a gcloud CLI. Para mais informações, consulte a interface de linha de comando gcloud logging.

Observação :as entradas de registro recebidas com carimbos de data/hora anteriores ao período de retenção de registros ou posteriores a 24 horas no futuro são descartadas.

Associar dados de trace a entradas de registro

As entradas de registro podem conter informações sobre traces. Ao incluir dados de trace nas entradas de registro, é possível correlacionar registros e traces para melhorar a solução de problemas distribuída. Para informações sobre a captura manual e automática de informações de trace em entradas de registro, consulte Integrar com o Cloud Logging.

Ler registros

Para as entradas de registro no Logging, faça o seguinte:

• No console do Google Cloud , acesse a página segmento Análise de registros:

  Acessar a Análise de registros

  Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.

  Para mais informações, consulte Visão geral da Análise de registros.

• Chame a API Logging usando as bibliotecas de cliente da linguagem de programação sendo usada.

• Chame diretamente os endpoints da API Logging REST. Consulte a documentação de referência da API Logging.

• Use a gcloud CLI. Para mais informações, consulte a interface de linha de comando gcloud logging.