Questo documento spiega come trovare le voci di log instradate ai bucket Cloud Logging. I bucket di log sono container di archiviazione di Cloud Logging nei progetti Google Cloud che contengono i dati di log. Puoi creare sink di log per instradare tutti i log o solo un sottoinsieme a qualsiasi bucket in Cloud Logging. Grazie a questa flessibilità, puoi scegliere in quale progetto Google Cloud archiviare i log e in quali altri log.
I log che instrada ai bucket Cloud Logging sono disponibili immediatamente.
Per informazioni sulla visualizzazione dei log indirizzati ad altre destinazioni, consulta i seguenti documenti:
Prima di iniziare
Per istruzioni su come creare e gestire i bucket di log, consulta i seguenti documenti:
Per una discussione concettuale dei sink, consulta Panoramica dei modelli di routing e archiviazione: sink.
Per istruzioni su come eseguire il routing dei log, consulta Routing dei log alle destinazioni supportate.
visualizza i log
Per risolvere i problemi e visualizzare le singole voci di log in un bucket di log, segui questi passaggi:
-
Nella console Google Cloud, vai alla pagina Esplora log:
Se usi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
- Nella barra degli strumenti Azione, seleziona Perfeziona ambito.
- Nella finestra di dialogo Perfeziona ambito, seleziona Ambito in base all'archiviazione.
Seleziona uno o più bucket di log e fai clic su Applica.
Per informazioni su come eseguire query, consulta Creare query in Esplora log.
Per eseguire l'analisi sulle voci di log archiviate in un bucket di log di cui è stato eseguito l'upgrade per utilizzare Analisi dei log, segui questi passaggi:
-
Nella console Google Cloud, vai alla pagina Analisi dei log:
Se usi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
Nell'elenco Viste log individua la vista e seleziona Query. Il riquadro Query viene compilato con una query predefinita, che include il nome della tabella su cui viene eseguita la query.
Puoi anche inserire una query nel riquadro Query o modificare una query visualizzata.
Per eseguire query su tutti i log nel bucket di log, seleziona la vista
_AllLogs.Nella barra degli strumenti, fai clic su Esegui query.
La query viene eseguita e il risultato viene visualizzato nella scheda Risultati.
Puoi utilizzare le opzioni della barra degli strumenti per formattare la query, cancellarla e aprire la documentazione di riferimento di SQL BigQuery.
Per informazioni su come eseguire le query, consulta Query e visualizza i log in Analisi dei log.
Organizzazione delle voci di log
Le voci di log di Logging sono oggetti di tipo LogEntry.
Le voci di log con lo stesso tipo di log, indicate come [LOG_ID] nel riferimento
LogEntry, di solito hanno lo stesso formato. La tabella seguente mostra le voci di log di esempio:
syslog
syslog di Compute Engine è un tipo di log personalizzato prodotto dall'agente di logging google-fluentd, che viene eseguito su istanze di macchine virtuali:
{
logName: "projects/my-gcp-project-id/logs/syslog",
timestamp: "2015-01-13T19:17:01Z",
resource: {
type: "gce_instance",
labels: {
instance_id: "12345",
zone: "us-central1-a",
project_id: "my-gcp-project-id"
}
},
insertId: "abcde12345",
textPayload: "Jan 13 19:17:01 my-gce-instance /USR/SBIN/CRON[29980]: (root) CMD ( cd / && run-parts --report /etc/cron.hourly)"
}
request_log
L'request_log di App Engine ha voci di log contenenti protoPayload campi che contengono oggetti di tipo RequestLog:
{
logName: "projects/my-gcp-project-id/logs/appengine.googleapis.com%2Frequest_log",
timestamp: "2015-01-13T19:00:39.796169Z",
resource: {
type: "gae_app",
labels: {
module_id: "default",
zone: "us6",
project_id: "my-gcp-project-id",
version_id: "20150925t173233"
}
}
httpRequest: {
status: 200
}
insertId: "abcde12345",
operation: {
id: "abc123",
producer: "appengine.googleapis.com/request_id",
first: true,
last: true
}
protoPayload: {
@type: "type.googleapis.com/google.appengine.logging.v1.RequestLog"
versionId: "20150925t173233",
status: 200,
startTime: "2017-01-13T19:00:39.796169Z",
# ...
appId: "s~my-gcp-project-id",
appEngineRelease: "1.9.17",
}
}
attività
Il log activity è un log di controllo per le attività di amministrazione.
Il suo payload è una rappresentazione JSON del tipo AuditLog:
{
logName: "projects/my-gcp-project-id/logs/cloudaudit.googleapis.com%2Factivity"
timestamp: "2017-04-22T13:41:32.245Z"
severity: "NOTICE"
resource: {
type: "gce_instance"
labels: {
instance_id: "2403273232180765234"
zone: "us-central1-b"
project_id: "my-gcp-project-id"
}
}
insertId: "54DC1882F4B49.A4996C2.6A02F4C1"
operation: {
id: "operation-1492868454262-54dc185e9a4f0-249fe233-f73d472a"
producer: "compute.googleapis.com"
last: true
}
protoPayload: {
@type: "type.googleapis.com/google.cloud.audit.AuditLog"
authenticationInfo: {
principalEmail: "649517127304@cloudservices.gserviceaccount.com"
}
requestMetadata: {…}
serviceName: "compute.googleapis.com"
methodName: "v1.compute.instances.delete"
resourceName: "projects/my-gcp-project-id/zones/us-central1-b/instances/abc123"
}
}
Risoluzione dei problemi
Se sembra che i log non siano presenti nella destinazione del sink o se sospetti che il sink non stia eseguendo correttamente il routing dei log, consulta Risolvere i problemi di routing e sink.
Prezzi
Cloud Logging non addebita alcun costo per il routing dei log a una destinazione supportata, ma la destinazione potrebbe applicare dei costi.
Ad eccezione del bucket di log _Required, Cloud Logging addebita un costo per lo streaming dei log nei bucket di log e per l'archiviazione per un periodo più lungo rispetto al periodo di conservazione predefinito del bucket di log.
Cloud Logging non addebita alcun costo per la copia dei log o per le query emesse tramite la pagina Esplora log o Analisi dei log.
Per ulteriori informazioni, consulta i seguenti documenti:
- Riepilogo dei prezzi di Cloud Logging
Costi di destinazione:
- I costi per la generazione di log di flusso VPC si applicano quando invii e poi escludi i log di flusso Virtual Private Cloud da Cloud Logging.