Journalisation structurée

Ce document traite du concept de journalisation structurée et des méthodes d'ajout d'une structure aux champs de charge utile des entrées de journal. Lorsque la charge utile du journal est mise en forme en tant qu'objet JSON et que cet objet est stocké dans le champ jsonPayload, l'entrée de journal est appelée journal structuré. Pour ces journaux, vous pouvez créer des requêtes qui recherchent des chemins JSON spécifiques et vous pouvez indexer des champs spécifiques dans la charge utile du journal. En revanche, lorsque la charge utile du journal est mise en forme sous forme de chaîne et stockée dans le champ textPayload, l'entrée de journal est non structurée. Vous pouvez effectuer une recherche dans le champ de texte, mais vous ne pouvez pas en indexer le contenu.

Pour créer des entrées de journal structurées, procédez comme suit:

  • Appelez la méthode API entries.write et fournissez un LogEntry entièrement formaté.
  • Exécutez la commande gcloud logging write.

Pour en savoir plus sur ces approches, consultez les sections suivantes.

Écrire des journaux à l'aide de la gcloud CLI

Vous pouvez écrire des données de journal à l'aide de la CLI gcloud. L'interface est compatible avec les journaux structurés et non structurés. Lorsque vous souhaitez écrire un journal structuré, fournissez à la commande un objet JSON sérialisé.

Pour un guide de démarrage rapide, consultez Écrire et interroger des entrées de journal avec la Google Cloud CLI.

Pour obtenir des exemples de code, consultez la documentation de référence de gcloud logging write.

Étape suivante