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 Google Cloud proyectos 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é Google Cloud proyecto 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 los 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 registros, haz lo siguiente:

  1. En la Google Cloud consola de, ve a la Explorador de registros del segmento:

    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 panel Definir mejor el permiso, selecciona Vista de registros.

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

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

Para realizar análisis en las entradas de registro almacenadas en un bucket de registros que se actualizó para usar Análisis de observabilidad, haz lo siguiente:

  1. En la Google Cloud consola de, ve a la página Análisis de registros:

    Ir a Análisis 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 lista Vistas de registros , busca la vista y, luego, selecciona Consulta. El panel Consulta se propaga con una consulta predeterminada, que incluye la vista de registros que se consulta.

    También puedes ingresar una consulta en el panel Consulta o editar una consulta que se muestra.

    Para consultar todos los registros de un bucket de registros, selecciona la vista _AllLogs para el bucket de registros.

  3. En la barra de herramientas, haz clic en Ejecutar consulta.

    Se ejecuta la consulta y el resultado de la consulta se muestra en la pestaña Resultados.

    Puedes usar las opciones de la barra de herramientas para dar formato a tu consulta, borrarla y abrir la documentación de referencia de BigQuery SQL.

    Para obtener información sobre cómo ejecutar consultas, consulta Consulta y visualiza registros en Análisis de observabilidad.

Organización de entradas de registro

Las entradas del registro son LogEntry objetos. Las entradas de registro almacenadas en un bucket de registros pueden incluir el campo errorGroups. Este campo vincula una entrada de registro a un grupo de errores que identifica Error Reporting. Logging establece este campo cuando almacena una entrada de registro en un bucket de registros.

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

syslog

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"
}

request_log

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"
  }
}

activity

El registro activity es un registro de auditoría de la actividad del administrador audit log. Su carga útil es una representación JSON del AuditLog tipo:

{
  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 el receptor no enruta los registros de forma correcta, consulta Soluciona problemas de enrutamiento y receptores.

Precios

Para obtener información sobre los precios, consulta la página de precios de Google Cloud Observability. Si enrutas datos de registros a otros Google Cloud servicios, consulta los siguientes documentos: