Neste documento, você verá o conceito de geração de registros estruturados e os métodos para adicionar uma estrutura aos campos de payload da entrada de registro. Quando o payload de registro é formatado como um objeto JSON e esse objeto é armazenado no campo jsonPayload, a entrada de registro é chamada de registro estruturado. Para esses registros, é possível criar consultas que pesquisam caminhos JSON específicos e indexar campos específicos no payload do registro. Por outro lado, quando o payload do registro é formatado como uma string e armazenado no campo textPayload, a entrada de registro é não estruturada.
É possível pesquisar no campo de texto, mas não indexar o conteúdo dele.
Para criar entradas de registro estruturadas, faça o seguinte:
- Chame o método de API
entries.writee forneça umLogEntrytotalmente formatado. - Use o comando
gcloud logging write.
- Use uma biblioteca de cliente do Cloud Logging que grava registros estruturados.
Gravar registros usando a CLI gcloud
É possível gravar dados de registro usando a CLI gcloud. A interface aceita registros estruturados e não estruturados. Quando quiser gravar um registro estruturado, forneça ao comando um objeto JSON serializado.
Para um guia de início rápido, consulte Gravar e consultar entradas de registros com a Google Cloud CLI.
Para exemplos de código, consulte a
referência gcloud logging write.
A seguir
Para consultar e visualizar entradas de registro, consulte Ver registros usando a Análise de registros.
Para ler entradas de registro usando a Google Cloud CLI, consulte Como ler entradas de registro.
Para ler entradas de registro por meio da API Logging, consulte o método
entries.list.