Cómo ver los registros enrutados a los buckets de Cloud Logging

En este documento, se explica cómo encontrar las entradas de registro que enrutaste a los buckets de Cloud Logging. Los buckets de registros son contenedores de almacenamiento de Cloud Logging en tus proyectos de Google Cloud que contienen los datos de registros. Puedes crear receptores de registros para enrutar todos tus registros, o solo un subconjunto de ellos, a cualquier bucket de Cloud Logging. Esta flexibilidad te permite elegir en qué proyecto de Google Cloud se almacenan tus registros y qué otros registros se almacenan con ellos.

Los registros que enrutas a los buckets de Cloud Logging están disponibles de inmediato.

Para obtener información sobre cómo ver registros enrutados a otros destinos, consulta los siguientes documentos:

Antes de comenzar

Para obtener instrucciones sobre cómo crear y administrar buckets de registros, consulta los siguientes documentos:

Para obtener un análisis conceptual de los receptores, consulta Descripción general de los modelos de enrutamiento y almacenamiento: Receptores.

Para obtener instrucciones sobre cómo enrutar tus registros, consulta Enruta registros a destinos compatibles.

Ver registros

Para solucionar problemas y ver entradas de registro individuales en un bucket de registro, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página Explorador de registros.

    Ir al Explorador de registros

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

  2. En la barra de herramientas Acción, selecciona Definir mejor el permiso.
  3. En el diálogo Definir mejor el permiso, selecciona Vista de registro.

  4. Selecciona una o más vistas de registro y, luego, haz clic en Aplicar.

    Para obtener información sobre cómo ejecutar consultas, consulta Compila consultas en el Explorador de registros.

Organización de las entradas de registro

Las entradas del registro son objetos del tipo LogEntry.

Las entradas de registro con el mismo tipo de registro, denominado [LOG_ID] en la referencia LogEntry, suelen tener el mismo formato. En la siguiente tabla, se muestran ejemplos de entradas de registro:

syslogrequest_logactivity

El siguiente es un ejemplo de un syslog de 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"
}

El request_log de App Engine tiene entradas de registro que contienen campos protoPayload que comprenden objetos de 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"
  }
}

El registro activity es un registro de auditoría de la actividad del administrador. Su carga útil es una representación 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"
}

Soluciona problemas

Si parece que faltan registros en el destino de tu receptor o sospechas que este no enruta los registros correctamente, consulta Cómo solucionar problemas de enrutamiento y receptores.

Precios

Cloud Logging no cobra por enrutar registros a un destino compatible. Sin embargo, es posible que el destino aplique cargos. Con la excepción del bucket de registros _Required, Cloud Logging cobra por transmitir registros a buckets de registros y almacenarlos durante más tiempo que el período de retención predeterminado del bucket de registros.

Cloud Logging no cobra por copiar registros, crear alcances de registro o vistas de estadísticas, ni por las consultas que se emiten a través de las páginas Explorador de registros o Análisis de registros.

Para obtener más información, consulta los siguientes documentos: