Panoramica delle librerie di logging

Molti linguaggi di programmazione dispongono di interfacce di scrittura dei log standard che puoi riconfigurare per utilizzare Logging.

Nota: Strumenta la tua applicazione per raccogliere informazioni specifiche che ti aiutino a comprenderne le prestazioni e a risolvere i problemi. Esistono diversi framework di strumentazione open source che raccolgono dati di log, metriche e tracce e possono inviarli a qualsiasi fornitore, incluso Google Cloud. Per le tue applicazioni basate su agenti, alcuni framework possono raccogliere i tuoi prompt e le tue risposte o passare un contesto che consente di tracciare alcune chiamate remote ai server MCP di Google Cloud.

Per instrumentare la tua applicazione, ti consigliamo di utilizzare un framework di strumentazione open source e indipendente dal fornitore, come OpenTelemetry, anziché API o librerie client specifiche del fornitore e del prodotto. Per informazioni su questi framework, consulta Osservabilità per gli sviluppatori di applicazioni e Scegli un approccio di strumentazione.

Scrivi log

Per scrivere i log in Cloud Logging, puoi eseguire una delle seguenti operazioni:

• Scrivi i log in file di log esistenti, ad esempio syslog, nell'istanza VM di Compute Engine e utilizza Ops Agent per inviare i log a Cloud Logging. Per saperne di più, consulta Agenti di Google Cloud Observability.
• Configura un pacchetto di logging standard per inviare i log che scrivi a Logging. Per saperne di più, consulta le seguenti pagine dei dettagli:
  • Qualsiasi lingua: fluentd
  • C#: utilizzo di ASP.NET o chiamata dell'API
  • Java: utilizzo di Logback e java.util.logging
  • Go: utilizzo del logging standard
  • Node.js: utilizzo di Winston e Bunyan
  • PHP: utilizzo del logger PSR-3
  • Python: utilizzo della funzionalità di logging standard
  • Ruby: utilizzo della gemma Google Cloud Observability
• Chiama l'API Logging utilizzando le librerie client di Logging per il tuo linguaggio di programmazione.
• Chiama direttamente l'endpoint REST dell'API Logging. Consulta la documentazione di riferimento dell'API Logging.
• Utilizza gcloud CLI. Per saperne di più, consulta l'interfaccia a riga di comando gcloud logging.

Nota: le voci di log in entrata con timestamp che risalgono a un periodo precedente al periodo di conservazione dei log o che sono successive di più di 24 ore vengono ignorate.

Associa i dati di traccia alle voci di log

Le voci di log possono contenere informazioni sulle tracce. Includendo i dati di traccia nelle voci di log, puoi correlare log e tracce per consentire una migliore risoluzione dei problemi distribuiti. Per informazioni sull'acquisizione manuale e automatica delle informazioni di traccia nelle voci di log, consulta Integrazione con Cloud Logging.

Leggi i log

Per leggere le voci di log in Logging, puoi eseguire una delle seguenti operazioni:

• Nella console Google Cloud , vai alla pagina segmento Esplora log:

  Vai a Esplora log

  Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

  Per saperne di più, consulta la panoramica di Esplora log.

• Chiama l'API Logging tramite le librerie client per il tuo linguaggio di programmazione.

• Chiamare direttamente gli endpoint REST dell'API Logging. Consulta la documentazione di riferimento dell'API Logging.

• Utilizza gcloud CLI. Per saperne di più, consulta l'interfaccia a riga di comando gcloud logging.