Visualizza i log con routing ai bucket Cloud Logging

Questo documento spiega come trovare le voci di log a cui hai eseguito l'instradamento Bucket Cloud Logging. I bucket di log sono container di archiviazione di Cloud Logging nei progetti Google Cloud che contengono i dati dei log. Puoi creare sink di log per instradare tutto oppure un sottoinsieme dei tuoi log in qualsiasi bucket in Cloud Logging. Questa flessibilità ti permette di scegliere in quale progetto Google Cloud archiviare i tuoi log quali altri log vengono archiviati.

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 sui sink, vedi Panoramica dei modelli di routing e archiviazione: sink.

Per istruzioni su come eseguire il routing dei log, consulta Esegui il 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:

  1. Nella console Google Cloud, vai alla pagina Esplora log:

    Vai a Esplora log

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

  2. Nella barra degli strumenti Azione, seleziona Perfeziona ambito.
  3. Nella finestra di dialogo Perfeziona ambito, seleziona Vista di log.

  4. Seleziona una o più visualizzazioni log e fai clic su Applica.

    Per informazioni su come eseguire query, consulta Creare query in Esplora log.

eseguire analisi sulle voci di log archiviate in un bucket di log di cui è stato eseguito l'upgrade. per utilizzare Analisi dei log:

  1. Nella console Google Cloud, vai alla pagina Log Analytics:

    Vai ad Analisi dei log

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

  2. Nell'elenco Visualizzazioni log, trova la visualizzazione e seleziona Query. Il riquadro Query viene compilato con una query predefinita, che include la vista del log 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 in un bucket di log, seleziona la visualizzazione _AllLogs per il bucket di log.

  3. Nella barra degli strumenti, fai clic su Esegui query.

    La query viene eseguita e il risultato viene mostrato nel Scheda Risultati.

    Puoi utilizzare le opzioni della barra degli strumenti per formattare la query, cancellarla e apri la documentazione di riferimento su SQL di BigQuery.

    Per informazioni su come eseguire query, vedi Query e visualizza i log in Analisi dei log.

Organizzazione delle voci di log

Le voci di log di registrazione sono oggetti di tipo LogEntry.

Le voci di log con lo stesso tipo di log, indicate come [LOG_ID] nel riferimento LogEntry, in genere hanno lo stesso formato. Le seguenti mostra esempi di voci di log:

syslog

Di seguito è riportato un esempio di syslog Compute Engine:

{
  insertId: "4zymupf98ac6v"
  jsonPayload: {
    message: "Jul 15 13:36:33 my-instance dhclient[328]: DHCPACK of 10.240.0.48 from 169.254.169.254"
  }
  logName: "projects/my-gcp-project-id/logs/syslog"
  receiveTimestamp: "2024-07-15T13:36:33.400534415Z"
  resource: {
    labels: {
      instance_id: "0123456789" (instance_name: my-instance)
      project_id: "my-gcp-project-id"
      zone: "us-central1-a"
    }
    type: "gce_instance"
  }
  timestamp: "2024-07-15T13:36:33.097822178Z"
}

request_log

request_log di App Engine contiene voci di log contenenti campi protoPayload che contengono oggetti di tipo RequestLog:

{
  httpRequest: {
    status: 200
  }
  insertId: "669525c0000d39d1eab2bb03"
  labels: {1}
  logName: "projects/my-gcp-project-id/logs/appengine.googleapis.com%2Frequest_log"
  operation: {4}
  protoPayload: {
    @type: "type.googleapis.com/google.appengine.logging.v1.RequestLog"
    appEngineRelease: "1.9.71"
    appId: "s~my-gcp-project-id"
    startTime: "2024-07-15T13:36:00.861387Z"
    ...
  }
  receiveTimestamp: "2024-07-15T13:36:01.169966997Z"
  resource: {2}
  spanId: "7925702051311044593"
  timestamp: "2024-07-15T13:36:00.861387Z"
  trace: "projects/my-gcp-project-id/traces/8a4fab4bd4fbafac2a0fa901c1485847"
  resource: {
    labels: {
      module_id: "default"
      project_id: "my-gcp-project-id"
      version_id: "20200221t133337"
      zone: "us14"
    }
    type: "gae_app"
  }
}

attività

Il log activity è un audit log delle attività di amministrazione. Il relativo payload è una rappresentazione JSON del tipo AuditLog:

{
  insertId: "dlu8qwc69c"
  labels: {
    compute.googleapis.com/root_trigger_id: "a97f30b1-45ab-4c12-9309-8e8af3bb011f"
  }
  logName: "projects/my-gcp-project-id/logs/cloudaudit.googleapis.com%2Factivity"
  operation: {
    id: "operation-1721047950764-61d48b3bf2b65-1ba1f256-82e9b5fd"
    last: true
    producer: "compute.googleapis.com"
  }
  protoPayload: {
    @type: "type.googleapis.com/google.cloud.audit.AuditLog"
    authenticationInfo: {...}
    methodName: "v1.compute.instances.insert"
    request: {...}
    requestMetadata: {...}
    resourceName: "projects/my-gcp-project-id/zones/us-central1-f/instances/my-instance"
    serviceName: "compute.googleapis.com"
  }
  receiveTimestamp: "2024-07-15T12:52:41.376292847Z"
  resource: {
  labels: {
    instance_id: "2891866457752773984" (instance_name: my-instance)
    project_id: "my-gcp-project-id"
    zone: "us-central1-f"
    }
    type: "gce_instance"
  }
  severity: "NOTICE"
  timestamp: "2024-07-15T12:52:40.965840Z"
}

Risoluzione dei problemi

Se i log sembrano non essere presenti nella destinazione del sink o sospetti in altro modo se il sink non esegue correttamente il routing dei log, Risolvi i problemi di routing e sink.

Prezzi

Cloud Logging non addebita alcun costo per il routing dei log a un destinazione supportata; ma la destinazione potrebbe applicare dei costi. Ad eccezione del bucket di log _Required, Cloud Logging addebita un costo per trasferire i log nei bucket di log. per un'archiviazione più lunga del periodo di conservazione predefinito del bucket di log.

Cloud Logging non addebita alcun costo per la copia dei log, per la definizione degli ambiti dei log o per le query inviate tramite le pagine Esplora log o Analisi dei log.

Per ulteriori informazioni, consulta i seguenti documenti: