Dans Cloud Logging, un objet LogEntry peut stocker une charge utile de journal sous forme de données structurées ou de texte non structuré. Une entrée de journal structurée stocke sa charge utile sous la forme d'un objet JSON dans le champ jsonPayload, tandis qu'une entrée de journal non structurée stocke sa charge utile sous la forme d'une chaîne dans le champ textPayload.
En formatant la charge utile de votre journal en tant qu'objet JSON, vous pouvez effectuer des recherches et des requêtes par chemins JSON dans l'explorateur de journaux. Avec les journaux non structurés, vous pouvez rechercher la chaîne de texte, mais vous ne pouvez pas interroger des clés individuelles.
Écriture des journaux structurés
La façon dont les entrées de journal structurées sont écrites dans Logging dépend de votre environnement et de la façon dont vos journaux sont collectés :
- Bibliothèques clientes Logging : ces bibliothèques écrivent des journaux structurés lorsque vous transmettez un objet ou un mappage JSON en tant que charge utile, ou lorsqu'elles génèrent un fichier JSON d'une seule ligne vers
stdoutoustderr.
- Google Cloud CLI ou l'API Logging : vous pouvez exécuter
gcloud logging writeavec l'option--payload-type=json(exemple) ou appeler la méthode APIentries.writeavec un objetjsonPayload.
Étapes suivantes
Pour interroger et afficher les entrées de journal, consultez Afficher les journaux à l'aide de l'explorateur de journaux.
Pour lire les entrées de journal à l'aide de la gcloud CLI, consultez Lire les entrées de journal.
Pour lire les entrées de journal à l'aide de l'API Logging, consultez la méthode
entries.list.