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 de registro. Por outro lado, quando o payload de registro é formatado como uma string e armazenado no campo textPayload, a entrada de registro é não estruturada.
É possível pesquisar o 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 da API
entries.writee forneça umLogEntrytotalmente formatado. - Use o comando
gcloud logging write.
Para mais informações sobre essas abordagens, consulte as seções a seguir.
Gravar registros usando a CLI gcloud
É possível gravar dados de registro usando a CLI gcloud. A interface oferece suporte a registros não estruturados e estruturados. Quando você 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 registro com a Google Cloud CLI.
Para exemplos de código, consulte a
gcloud logging write referência.
A seguir
Para consultar e visualizar entradas de registro, consulte Visualizar 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 usando a API Logging, consulte o
entries.listmétodo.