Este documento aborda o conceito de registo estruturado e os métodos para adicionar estrutura aos campos de payload das entradas de registo. Quando o payload do registo é formatado como um objeto JSON e esse objeto é armazenado no campo jsonPayload, a entrada do registo é denominada registo estruturado. Para estes registos, pode criar consultas que pesquisem caminhos JSON específicos e pode indexar campos específicos no payload do registo. Por outro lado, quando o payload do registo é formatado como uma string e armazenado no campo textPayload, a entrada do registo é não estruturada.
Pode pesquisar o campo de texto, mas não pode indexar o respetivo conteúdo.
Para criar entradas de registo estruturadas, faça qualquer uma das seguintes ações:
- Chame o método da API
entries.writee forneça umLogEntrytotalmente formatado. - Use o comando
gcloud logging write.
Para mais informações acerca destas abordagens, consulte as secções seguintes.
Escreva registos através da CLI gcloud
Pode escrever dados de registo através da CLI gcloud. A interface suporta registos não estruturados e registos estruturados. Quando quiser escrever um registo estruturado, forneça ao comando um objeto JSON serializado.
Para um início rápido, consulte o artigo Escreva e consulte entradas de registo com a CLI do Google Cloud.
Para ver exemplos de código, consulte a referência de
gcloud logging write.
O que se segue?
Para consultar e ver entradas de registo, consulte o artigo Veja registos através do Explorador de registos.
Para ler entradas de registo através da CLI Google Cloud, consulte o artigo Ler entradas de registo.
Para ler entradas de registo através da API Logging, consulte o método
entries.list.