Panoramica delle librerie di logging

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

Nota: Instrumenta l'applicazione per raccogliere informazioni specifiche che ti aiutino a comprenderne le prestazioni e a risolvere i problemi relativi agli errori. Diversi framework di strumentazione open source raccolgono dati di log, metriche e tracce e possono inviarli a qualsiasi fornitore, incluso Google Cloud. Per le tue applicazioni agentiche, alcuni framework possono raccogliere i tuoi prompt e le tue risposte o passare il contesto che consente di tracciare alcune chiamate ai server Google Cloud MCP remoti.

Per strumentare l'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, vedi Strumentazione e osservabilità e Scegliere un approccio di strumentazione.

Scrivi log

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

• Scrivi i log nei file di log esistenti, ad esempio syslog, sull'istanza della VM di Compute Engine e utilizza l'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 in modo che invii i log che scrivi a Logging. Per saperne di più, consulta le seguenti pagine di dettagli:
  • Qualsiasi lingua: fluentd
  • C#: utilizzo di ASP.NET o chiamata all'API
  • Java: utilizzo di Logback e java.util.logging
  • Go: utilizzo della registrazione 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 la gcloud CLI. Per saperne di più, consulta l'interfaccia a riga di comando gcloud logging.

Nota: le voci di log in entrata con timestamp precedenti al periodo di conservazione dei log o successivi alla data odierna di più di 24 ore vengono eliminate.

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 migliorare la risoluzione dei problemi distribuiti. Per informazioni sull'acquisizione manuale e automatica delle informazioni di traccia nelle voci di log, vedi Integrare con Cloud Logging.

Leggi i log

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

• Nella Google Cloud console, 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 Panoramica di Esplora log.

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

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

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