Présentation des bibliothèques Logging

De nombreux langages de programmation ont des interfaces d'écriture de journal standard que vous pouvez reconfigurer pour utiliser Logging.

Remarque: Vous pouvez instrumenter votre application pour qu'elle collecte des informations spécifiques à l'application. Plusieurs solutions Open Source vous permettent de collecter des métriques, des journaux les traces de votre application et les envoyer à n'importe quel fournisseur, y compris Google Cloud. Pour instrumenter votre application, nous vous recommandons d'utiliser un d'instrumentation neutre du fournisseur et Open Source, comme OpenTelemetry, et non plus API ou bibliothèques clientes spécifiques aux fournisseurs et aux produits.

Pour en savoir plus sur l'instrumentation de vos applications à l'aide de frameworks d'instrumentation neutres à l'égard des fournisseurs, consultez la section Instrumentation et observabilité.

Écrire des journaux

Pour écrire des journaux dans Cloud Logging, vous pouvez effectuer l'une des opérations suivantes : les éléments suivants:

• Écrivez vos journaux dans des fichiers journaux existants tels que syslog sur votre instance de VM Compute Engine et utilisez l'Agent Ops pour envoyer les journaux à Cloud Logging. Pour en savoir plus, consultez Agents d'observabilité Google Cloud.
• Configurer un package de journalisation standard pour envoyer les journaux dans lesquels vous écrivez Journalisation. Pour en savoir plus, consultez les pages d'informations suivantes :
  • Tous les langages : fluentd
  • C#: utiliser ASP.NET ou appeler l'API
  • Java : utiliser Logback et java.util.logging
  • Go : utiliser la journalisation standard
  • Node.js : utiliser Winston et Bunyan
  • PHP : utiliser l'enregistreur PSR-3
  • Python : utiliser la fonction de journalisation standard
  • Ruby: utiliser l'observabilité Google Cloud joyau
• Appelez l'API Logging via les bibliothèques clientes de Logging pour votre langage de programmation.
• Appelez directement le point de terminaison REST de l'API Logging. Consultez la documentation de référence de l'API Logging.
• Utilisez la gcloud CLI. Pour plus d'informations, consultez l'interface de ligne de commande gcloud logging.

Remarque :Les entrées de journal entrantes dont les horodatages sont supérieurs à la valeur durée de conservation des journaux passée ou qui se situent dans plus de 24 heures sont supprimés.

Associer des données de trace à des entrées de journal

Les entrées de journal peuvent contenir des informations sur les traces. En incluant des données de trace dans les entrées de journal, vous pouvez corréler les journaux et les traces pour mieux le dépannage distribué. Pour en savoir plus sur les clés capture automatique des informations de trace dans les entrées de journal, consultez Intégration à Cloud Logging

Lire les journaux

Pour lire les entrées de journal dans Logging, effectuez l'une des opérations suivantes :

• Dans la console Google Cloud, accédez à la page Explorateur de journaux.

  Accéder à l'explorateur de journaux

  Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

  Pour en savoir plus, consultez Présentation de l'explorateur de journaux

• Appelez l'API Logging via les bibliothèques clientes langage de programmation.

• Appelez directement les points de terminaison REST de l'API Logging. Consultez la documentation de référence de l'API Logging.

• Utilisez la gcloud CLI. Pour en savoir plus, consultez l'interface de ligne de commande gcloud logging.