Per le applicazioni Node.js, i plug-in vengono gestiti per le librerie di logging Winston e Bunyan più diffuse. Winston è una libreria generica che implementa una serie di formattatori e trasporti di log. Bunyan, specializzato per i log JSON strutturati, supporta la formattazione dei log tramite il piping alla riga di comando Bunyan.
Puoi anche utilizzare direttamente la libreria client di Logging per Node.js o creare integrazioni personalizzate con la tua libreria di logging preferita. Ad esempio, puoi utilizzare l'esempio del framework di logging Pino.
L'agente Logging non deve essere installato per utilizzare Winston o Bunyan su un'istanza di macchina virtuale (VM) Compute Engine.
Prima di iniziare
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Logging API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Logging API.
- Prepara l'ambiente per lo sviluppo Node.js.
Per installare il plug-in Logging Winston, utilizza npm:
npm install @google-cloud/logging-winston winston
Importa il plug-in e aggiungilo alla configurazione di Winston:
Configura il plug-in.
Puoi personalizzare il comportamento del plug-in Winston utilizzando le stesse opzioni di configurazione supportate dalla libreria client di Cloud per Node.js dell'API Cloud Logging. Queste opzioni possono essere trasmesse nell'oggetto
options
passato al costruttore del plug-in.Per installare il plug-in Logging Bunyan, utilizza npm:
npm install bunyan @google-cloud/logging-bunyan
Importa il plug-in e aggiungilo alla configurazione Bunyan:
Configura il plug-in.
Puoi personalizzare il comportamento del plug-in Bunyan utilizzando le stesse opzioni di configurazione supportate dalla libreria client di Cloud per l'API Cloud Logging per Node.js. Queste opzioni possono essere trasmesse nell'oggetto
options
passato al costruttore del plug-in.Se esegui il deployment dell'applicazione in App Engine o utilizzi le librerie specifiche di App Engine, imposta la risorsa su Applicazione GAE.
Se esegui il deployment dell'applicazione su Compute Engine, imposta la risorsa su Istanza VM GCE.
Se esegui il deployment dell'applicazione su Google Kubernetes Engine, la configurazione di logging del cluster determina il tipo di risorsa delle voci di log. Per una discussione dettagliata sulle soluzioni Legacy Google Cloud Observability e Google Cloud Observability Kubernetes Monitoring e su come queste opzioni influiscono sul tipo di risorsa, consulta Migrazione a Google Cloud Observability Kubernetes Monitoring.
Se la tua applicazione utilizza direttamente l'API Cloud Logging, la risorsa dipende dall'API e dalla tua configurazione. Ad esempio, nella tua applicazione puoi specificare una risorsa o utilizzarne una predefinita.
Se non vedi alcun log in Esplora log, per visualizzare tutte le voci di log, passa alla modalità di query avanzata e utilizza una query vuota.
- Per passare alla modalità di query avanzata, fai clic sul menu (▾) nella parte superiore di Esplora log e poi seleziona Converti in filtro avanzato.
- Cancella i contenuti visualizzati nella casella del filtro.
- Fai clic su Invia filtro.
Puoi esaminare le singole voci per identificare le tue risorse.
Configurazione logging
Questa sezione descrive come installare e configurare i plug-in per le librerie di logging Winston e Bunyan. Per Bunyan, vengono fornite informazioni su come utilizzare Bunyan con un'applicazione Node.js Express.
Puoi utilizzare altre librerie o framework. Ad esempio, puoi utilizzare il framework di logging Pino. Per un codice campione che utilizza OpenTelemetry per raccogliere metriche e dati di traccia e il framework di logging Pino per raccogliere dati di log, consulta Esempio di strumentazione Node.js. Se utilizzi Pino, devi implementare una mappatura tra i livelli di gravità di Pino e quelli utilizzati da Cloud Logging. Per un esempio di codice, consulta la pagina Mapping dei livelli di log Pino.
Installare e configurare il plug-in Winston
Cloud Logging fornisce un plug-in per la libreria di logging Node.js Winston. Il plug-in Logging per Winston fornisce un livello più semplice e di livello superiore per lavorare con Logging.
Per installare e configurare il plug-in Winston:
Installa e configura il plug-in Bunyan
Cloud Logging fornisce un plug-in per la libreria di logging Node.js Bunyan. Il plug-in Logging per Bunyan fornisce un livello più semplice e di livello superiore per lavorare con Logging.
Per installare e configurare il plug-in Bunyan:
Utilizzare Bunyan ed Express
Puoi configurare e utilizzare Bunyan con Logging in un'applicazione Node.js Express.
Per maggiori informazioni sull'installazione, consulta la documentazione delle librerie Cloud Logging per Node.js. Puoi anche segnalare i problemi utilizzando il tracker dei problemi.
Scrivere log con la libreria client di Cloud Logging
Per informazioni sull'utilizzo diretto della libreria client di Cloud Logging per Node.js, consulta Librerie client di Cloud Logging.
Esegui il giorno Google Cloud
Affinché un'applicazione possa scrivere log utilizzando le librerie Cloud Logging per Node.js, il account di servizio per la risorsa sottostante deve disporre del ruolo Logs Writer (roles/logging.logWriter
) IAM.
La maggior parte degli ambienti Google Cloud configura automaticamente l'account di servizio predefinito in modo che disponga di questo ruolo.
App Engine
Cloud Logging è abilitato automaticamente per App Engine e l'account di servizio predefinito della tua app dispone delle autorizzazioni IAM per scrivere voci di log per impostazione predefinita.
Per scrivere voci di log dalla tua app, ti consigliamo di utilizzare Bunyan o Winston, come descritto in questa pagina.
Per ulteriori informazioni, vedi Scrittura e visualizzazione dei log.
Google Kubernetes Engine (GKE)
GKE concede automaticamente al account di servizio predefinito
il ruolo IAM Logs Writer (roles/logging.logWriter
).
Se utilizzi la
federazione delle identità per i carichi di lavoro per GKE
con questo account di servizio predefinito per consentire ai carichi di lavoro di accedere ad API
Google Cloud specifiche, non è necessaria alcuna configurazione aggiuntiva.
Tuttavia, se utilizzi la federazione delle identità per i carichi di lavoro per GKE con un account di servizio IAM personalizzato, assicurati che quest'ultimo disponga del ruolo Writer log (roles/logging.logWriter
).
Se necessario, puoi anche utilizzare il seguente comando per aggiungere l'ambito di accesso logging.write
durante la creazione del cluster:
gcloud container clusters create example-cluster-name \
--scopes https://www.googleapis.com/auth/logging.write
Compute Engine
Quando utilizzi le istanze VM di Compute Engine, aggiungi l'ambito di accesso cloud-platform
a ogni istanza. Quando crei una nuova istanza tramite la consoleGoogle Cloud , puoi farlo nella sezione Identità e accesso API del riquadro Crea istanza. Utilizza il service account predefinito di Compute Engine o un altro account di servizio a tua scelta e seleziona Consenti l'accesso completo a tutte le API Cloud nella sezione Identità e accesso API. Qualunque service account tu scelga, assicurati che gli sia stato concesso il ruolo Logs Writer nella sezione IAM e amministrazione della consoleGoogle Cloud .
Cloud Run Functions
Cloud Run Functions concede il ruolo Writer log per impostazione predefinita.
Le librerie Cloud Logging per Node.js possono essere utilizzate senza dover fornire esplicitamente le credenziali.
Le funzioni Cloud Run sono configurate per utilizzare Cloud Logging automaticamente.
Esegui localmente e altrove
Per utilizzare le librerie Cloud Logging per Node.js al di fuori di Google Cloud, incluso l'esecuzione della libreria sulla tua workstation, sui computer del tuo data center o sulle istanze VM di un altro provider cloud, devi configurare le Credenziali predefinite dell'applicazione (ADC) nel tuo ambiente locale per l'autenticazione alle librerie Cloud Logging per Node.js.
Per saperne di più, vedi Configurare ADC per on-premise o un altro provider cloud.
Utilizza Winston:Utilizza Bunyan:
Visualizzare i log
Nella Google Cloud console, vai alla pagina Esplora log:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
In Esplora log devi specificare una o più risorse, ma la selezione delle risorse potrebbe non essere ovvia. Ecco alcuni suggerimenti per iniziare:
Per ulteriori informazioni, consulta la sezione Utilizzare Esplora log.