Questa pagina descrive i log disponibili quando si utilizza Knative serving e come visualizzare e scrivere i log.
Knative serving ha due tipi di log:
- Log delle richieste: log delle richieste inviate ai servizi Knative serving. Questi log vengono creati automaticamente.
- Log dei container: log emessi dalle istanze di container, in genere dal tuo codice, scritti nelle località supportate come descritto in Scrittura dei log dei container.
Abilitazione dei log in corso...
Per Google Cloud, i log vengono inviati automaticamente a Cloud Logging. Per GKE su VMware, devi prima abilitare i log.
Visualizzazione dei log
Puoi visualizzare i log relativi al tuo servizio in due modi:
- Utilizzare la pagina Knative serving nella console Google Cloud
- Utilizza Esplora log di Cloud Logging nella console Google Cloud.
Entrambi questi metodi di visualizzazione esaminano gli stessi log archiviati in Cloud Logging, ma Esplora log di Cloud Logging fornisce ulteriori dettagli e maggiori funzionalità di filtro.
Visualizzazione dei log in Knative serving
Per visualizzare i log nella pagina di Knative serving:
Fai clic sul servizio desiderato nell'elenco visualizzato.
Fai clic sulla scheda LOG per ottenere i log delle richieste e dei container per tutte le revisioni di questo servizio. Puoi filtrare in base al livello di gravità dei log.
Visualizzazione dei log in Cloud Logging
Per visualizzare i log di Knative serving in Esplora log di Cloud Logging:
Vai alla pagina Esplora log nella console Google Cloud.
Seleziona un progetto Google Cloud esistente nella parte superiore della pagina o creane uno nuovo.
Dai menu a discesa, seleziona la risorsa: Container Kubernetes.
Per ulteriori informazioni, consulta Utilizzo di Esplora log.
Visualizzazione dei log in Cloud Code
Per visualizzare i log in Cloud Code, leggi le guide su IntelliJ e Visual Studio Code.
Lettura dei log in modo programmatico
Se vuoi leggere i log in modo programmatico, puoi utilizzare uno di questi metodi:
- Usa un sink di log in Pub/Sub e uno script per eseguire il pull da Pub/Sub.
- Chiama l'API Logging tramite le librerie client per il tuo linguaggio di programmazione.
- Chiama direttamente gli endpoint REST dell'API Logging.
Scrittura dei log dei container
Quando scrivi i log dal tuo servizio, questi vengono raccolti automaticamente da Cloud Logging purché siano scritti in una delle seguenti posizioni:
- Stream di output standard (
stdout
) o errore standard (stderr
) - syslog (
/dev/log
) - Log scritti utilizzando le librerie client di Cloud Logging, disponibili per molti dei linguaggi più diffusi
La maggior parte degli sviluppatori dovrebbe scrivere i log utilizzando output standard ed errore standard.
I log dei container scritti in queste località supportate vengono associati automaticamente al servizio, alla revisione e alla località di Knative serving.
Utilizzo di testo semplice o JSON strutturato nei log
Quando scrivi i log, puoi inviare una semplice stringa di testo o una singola riga di JSON serializzato, chiamato anche dati "strutturati". Viene raccolto e analizzato da Cloud Logging e viene inserito in jsonPayload
. Al contrario, il semplice messaggio di testo viene inserito in textPayload
.
Scrittura di log strutturati
Il seguente snippet mostra come scrivere voci di log strutturate. Mostra inoltre come correlare i messaggi di log con il log delle richieste corrispondente.
Node.js
Python
Go
La struttura di ogni voce di log è fornita da un tipo Entry
:
Quando viene registrato uno struct di tipo Entry, viene chiamato il metodo String
per eseguirne il marshal nel formato JSON previsto da Cloud Logging:
Java
Abilita il logging JSON con Logback e SLF4J abilitando il encoder JSON Logstash nella configurazione logback.xml
.
Campi JSON speciali nei messaggi
Quando fornisci un log strutturato come dizionario JSON, alcuni campi speciali vengono eliminati da jsonPayload
e scritti nel campo corrispondente nel LogEntry generato, come descritto nella documentazione relativa ai campi speciali.
Ad esempio, se il file JSON include una proprietà severity
, viene rimosso da jsonPayload
e viene visualizzato come severity
della voce di log.
La proprietà message
viene utilizzata come testo visualizzato principale della voce di log, se presente.
Per ulteriori informazioni sulle proprietà speciali, leggi la sezione Risorsa di logging riportata di seguito.
Correlazione dei log dei container con un log delle richieste
In Esplora log, i log correlati allo stesso trace
sono visualizzabili in formato "padre-figlio": quando fai clic sull'icona a forma di triangolo a sinistra della voce di log delle richieste, i log dei container relativi alla richiesta vengono visualizzati nidificati sotto il log delle richieste.
I log dei container non sono correlati automaticamente ai log delle richieste, a meno che non utilizzi una
libreria client di Cloud Logging.
Per correlare i log dei container ai log delle richieste senza utilizzare una libreria client,
puoi utilizzare una riga di log JSON strutturata contenente un
campo logging.googleapis.com/trace
con l'identificatore della traccia estratto
dall'intestazione X-Cloud-Trace-Context
, come mostrato nell'esempio riportato sopra per il
logging strutturato.
Controllo dell'utilizzo delle risorse dei log delle richieste
I log delle richieste vengono creati automaticamente. Anche se non puoi controllare la quantità di log delle richieste direttamente da Knative serving, puoi utilizzare la funzionalità di esclusione dei log di Cloud Logging.
Una nota sugli agenti di logging
Se hai utilizzato Cloud Logging con alcuni prodotti Google Cloud, ad esempio Compute Engine, potresti aver utilizzato gli agenti di logging di Cloud Logging. Knative serving non utilizza gli agenti di logging perché dispone del supporto integrato per la raccolta dei log.
Risorsa di logging
Se fai clic su una voce di log in Esplora log, si apre una voce di log in formato JSON che ti consente di visualizzare i dettagli desiderati.
Tutti i campi in una voce di log, ad esempio timestamp, gravità e httpRequest
, sono standard e sono descritti nella documentazione relativa a una voce di log.
Tuttavia, esistono alcune etichette o etichette delle risorse speciali per Knative serving. Di seguito vengono elencati i contenuti di esempio:
{
httpRequest: {…}
insertId: "5c82b3d1000ece0000000000"
labels: {
instanceId: "00bf4bf00000fb59c906a00000c9e29c2c4e06dce91500000000056008d2b6460f163c0057b97b2345f2725fb2423ee5f0bafd36df887fdb1122371563cf1ff453717282afe000001"
}
logName: "projects/my-project/logs/anthos/run/.googleapis.com%2Frequests"
receiveTimestamp: "2019-03-08T18:26:25.981686167Z"
resource: {
labels: {
configuration_name: "myservice"
location: "us-central1"
project_id: "my-project"
revision_name: "myservice-00002"
service_name: "myservice"
}
type: "cloud_run_revision"
}
severity: "INFO"
timestamp: "2019-03-08T18:26:25.970397Z"
}
Campo | Valori e note |
---|---|
instanceId |
L'istanza di container che ha gestito la richiesta. |
logName |
Identifica il log, ad esempio log richieste, errore standard, output standard e così via. |
configuration_name |
La risorsa di configurazione che ha creato la revisione che ha gestito la richiesta. |
location |
Identifica la località Google Cloud del servizio. |
project_id |
Il progetto in cui viene eseguito il deployment del servizio. |
revision_name |
La revisione che ha gestito la richiesta. |
service_name |
Il servizio che ha gestito la richiesta. |
type |
cloud_run_revision . Il tipo di risorsa Knative serving. |