Analiza la actividad del feed con Cloud Logging

Compatible con:

Esta guía ayuda a los ingenieros y administradores de seguridad a supervisar, depurar y solucionar problemas de las canalizaciones y los feeds de transferencia en Google SecOps SIEM. Para obtener una descripción general más amplia de la supervisión de la transferencia de datos, consulta Verifica el estado de la transferencia de datos y Soluciona problemas de transferencia de datos. En esta guía, se explica cómo enviar, ver y consultar los registros de actividad de transferencia y de feeds en Cloud Logging. Con Cloud Logging, puedes diagnosticar problemas con la entrega de registros, como registros faltantes, retrasados o con errores, y disminuir el tiempo necesario para resolver las anomalías de transferencia. Esta visibilidad de los mecanismos de transferencia basados en push y pull también te permite usar Gemini Cloud Assist para investigar la telemetría de registros y métricas.

Antes de comenzar

  • Para obtener los permisos necesarios para ver los registros, pídele a tu administrador que te otorgue uno de los siguientes roles de Identity and Access Management (IAM) en tu proyecto:

    • Visor de registros (roles/logging.viewer)
    • Visor de registros privados (roles/logging.privateLogViewer)

    Si quieres obtener más información para otorgar roles, consulta Administra el acceso.

  • Comprender las implicaciones de costos Cloud Logging es un servicio facturable. Hay un nivel gratuito disponible como parte del Programa gratuito de Google Cloud . Para obtener más información, consulta Precios de observabilidad deGoogle Cloud .

Terminología clave

  • chronicle-siem: Es la etiqueta del espacio de nombres para los registros asociados con el ecosistema de Google SecOps.
  • chronicle.googleapis.com/ingestion_activity: Es el ID del registro para el flujo de registros relacionado específicamente con las canalizaciones de transferencia de datos de Google SecOps.
  • storage_transfer_job: Es el tipo de recurso para los registros de feeds estáticos que usan el Servicio de transferencia de almacenamiento (STS).
  • storagetransfer.googleapis.com/transfer_activity: Es el ID de registro para los registros de actividad del STS.

Descripción general del análisis de la actividad del feed

El análisis de la actividad del feed en Cloud Logging implica varios pasos clave:

  1. Accede al Explorador de registros: Navega al Explorador de registros en la consola de Google Cloud y selecciona el proyecto de Google Cloud correcto. Para obtener más información, consulta la documentación de la interfaz del Explorador de registros.
  2. Consultar registros: Crea consultas para filtrar registros según varios parámetros, como intervalos de tiempo, espacios de nombres, IDs de registro, mecanismos de transferencia, IDs de feed o IDs de recopilador. Para conocer las reglas de sintaxis, consulta Lenguaje de consulta de Logging. En esta guía, se proporcionan ejemplos de situaciones de filtrado comunes.
  3. Investiga tipos de feeds específicos: Obtén información para consultar registros de feeds con diferentes métodos de transferencia, incluidos los que usan el Servicio de transferencia de almacenamiento (STS), que tienen formatos de registro únicos.
  4. Usa las herramientas de la consola: Aprovecha las funciones integradas de la consola de Google SecOps, como Depurar con registros y Gemini Cloud Assist, para optimizar el proceso de análisis y depuración.
  5. Comprende el esquema de registros: Consulta la referencia del esquema para comprender los campos y los tipos de datos dentro de las cargas útiles de los registros, lo que ayuda a realizar análisis y solucionar problemas más detallados.

En las siguientes secciones, se proporciona información detallada para ayudarte a supervisar de manera eficaz el estado de tus canalizaciones de transferencia de datos, depurar problemas y solucionar errores.

Visualiza y consulta los registros de actividad del feed

Para ver y consultar los registros de actividad del feed, haz lo siguiente:

  1. Navega a la página Explorador de registros en la consola de Google Cloud .
  2. Selecciona el proyecto de Google Cloud asociado con tu instancia de Google SecOps.
  3. Ingresa una expresión de consulta en el panel Consulta para filtrar los registros.
  4. Haz clic en Ejecutar consulta.

En las siguientes secciones, se muestran ejemplos de consultas para situaciones comunes.

Filtrar por espacio de nombres de Google SecOps

Para recuperar todos los registros asociados con el ecosistema de Google SecOps, usa la siguiente consulta:

labels.namespace="chronicle-siem"

Filtra por flujo de registro de actividad de transferencia

Para aislar los registros relacionados específicamente con las canalizaciones de transferencia de datos, usa la siguiente consulta:

log_id("chronicle.googleapis.com/ingestion_activity")

Filtra por mecanismo de transferencia

Para orientar los registros a un mecanismo de transferencia específico, como las APIs de terceros, usa el campo labels.ingestion_mechanism en tu consulta:

labels.ingestion_mechanism="Third Party API"

Filtrar por ID de feed o ID de recopilador

Para ver los registros de un feed de transferencia o un recopilador específicos, usa el campo labels.feed_id o labels.collector_id. Para obtener información sobre cómo configurar los feeds, consulta Administra feeds de datos y Descripción general de los feeds de datos. Para los recopiladores, consulta Transferencia y análisis de registros:

labels.feed_id="FEED_ID"

Reemplaza FEED_ID por el identificador único de tu feed.

labels.collector_id="COLLECTOR_ID"

Reemplaza COLLECTOR_ID por el identificador único de tu recopilador.

Visualiza los registros del Servicio de transferencia de almacenamiento

Los registros de los feeds estáticos que usan el Servicio de transferencia de almacenamiento (STS) se enrutan desde el entorno de usuario hacia tu proyecto de Google Cloud y usan un tipo de recurso y un nombre de registro diferentes. Para obtener información general sobre el STS, consulta la documentación del Servicio de transferencia de almacenamiento.

  • Objetivo: Ver la actividad de registro del STS.
    Acción: Ejecuta la siguiente consulta: none resource.type="storage_transfer_job" AND log_id("storagetransfer.googleapis.com/transfer_activity")

  • Falla anticipada: La búsqueda con log_id("chronicle.googleapis.com/ingestion_activity") no mostrará registros para estos feeds estáticos.

  • Paso correctivo: Usa el resource.type="storage_transfer_job" y el STS log_id específico.

Excluye registros específicos con el enrutador de registros

Tienes control total y detallado sobre qué registros de actividad de feeds se enrutan a Cloud Logging. Si configuras filtros de exclusión en tu proyecto de Google Cloud , puedes dejar de recibir registros específicos, como los de un ID de feed en particular.

Para crear un filtro de exclusión y dejar de recibir registros específicos, haz lo siguiente:

  1. En la consola de Google Cloud , selecciona tu proyecto.
  2. En el cuadro de búsqueda, busca Enrutador de registros.
  3. En la lista Receptores del enrutador de registros, haz clic en el menú Más (tres puntos) junto al receptor _Default y, luego, selecciona Editar receptor.
  4. En la página Editar receptor, ve a la sección Elige registros para filtrar fuera del receptor (opcional) y agrega exclusiones según sea necesario.

Por ejemplo, para filtrar los registros del Servicio de transferencia de almacenamiento (STS), agrega un filtro de exclusión y proporciona la siguiente expresión de filtro:

resource.type="storage_transfer_job"

Si tienes problemas y quieres inhabilitar por completo todo el registro de actividad del feed, puedes abrir un caso de asistencia y solicitar esta acción. Google SecOps puede inhabilitar el registro por completo, pero esta es una acción de "todo o nada": inhabilita por completo los registros de todos los feeds de tu cuenta, en lugar de líneas o feeds específicos.

Usa las herramientas de la consola para depurar feeds

Google SecOps proporciona integraciones de consola para acceder a los registros de actividad:

  • Pregúntale a Gemini Cloud Assist: En la página Feeds, selecciona Pregúntale a Gemini Cloud Assist para abrir el panel de chat. Puedes hacer preguntas sobre los volúmenes y los errores de tus feeds.
  • Depura con registros: En la página Administración de feeds, abre el menú de acciones de un feed específico y selecciona Depurar con registros. Esta opción también está disponible en la página Ver feed. Se abrirá el Explorador de registros en una pestaña nueva, con un prefiltrado para el ID del feed seleccionado.

Referencia del esquema de registro

Los registros de actividad de los feeds usan una estructura de carga útil de JSON unificada.

Campos del registro de actividad de transferencia

Campo Tipo de datos Descripción
request_start_time string Marca de tiempo (RFC 3339) en la que se inició la actividad.
activity_duration string Es la duración total transcurrida de la actividad (p.ej., "1.500s").
transfer_id string Es el identificador único de una operación específica de transferencia de archivos o datos.
feed_id string Es el identificador único del feed de transferencia de Google SecOps.
collector_id string Identificador único del recopilador que ejecuta la transferencia.
log_type string Es el formato de los registros que se transfieren (p.ej., DUO, OFFICE_365). Para obtener una lista de cadenas de formato, consulta Analizadores predeterminados compatibles.
file string Es el nombre del archivo procesado o del contenedor de BLOB (para fuentes basadas en archivos).
request_urls array of strings Son las URLs de destino que se usan para extraer o transferir datos (en el caso de las fuentes basadas en APIs).
http_status_code integer Es el código de estado HTTP que se recibe de las operaciones de recuperación de la API.
bytes_transferred integer Es la cantidad de bytes sin procesar que se transfirieron correctamente durante la actividad.
record_count integer Es la cantidad de entradas de registro individuales procesadas, extraídas o analizadas.
activity string Es el nombre de la tarea que se está ejecutando (p.ej., File Processing, File Transfer).
details string Metadatos o detalles adicionales para la actividad de transferencia.
error_details object Información detallada del error si la actividad falló. Consulta Campos de detalles del error.

Campos de detalles del error

Campo Tipo de datos Descripción
error_message string Explicación legible por humanos del error.
error_code string Es el código de error o identificador (admite códigos de cadena numéricos y descriptivos).
error_type string Clasificación o categoría del error.
is_retriable boolean Indica si se puede reintentar la operación que causó el error.

Cargas útiles de registro de muestra

Ejemplo de registro de actividad de transferencia exitosa

{
  "request_start_time": "2026-06-30T19:00:00Z",
  "activity_duration": "0.500s",
  "transfer_id": "transfer-12345",
  "feed_id": "feed-998877",
  "collector_id": "collector-abcd",
  "log_type": "WORKDAY_AUDIT",
  "file": "audit_log_2026_06_30.json",
  "request_urls": [
    "https://api.workday.com/ccx/v1/tenant/logs"
  ],
  "http_status_code": 200,
  "bytes_transferred": 4512000,
  "record_count": 12500,
  "activity": "File Processing",
  "details": "Successfully processed and validated 12500 records from Workday."
}

Ejemplo de registro de actividad de transferencia con errores

{
  "request_start_time": "2026-06-30T19:05:00Z",
  "activity_duration": "1.200s",
  "transfer_id": "transfer-12346",
  "feed_id": "feed-998877",
  "collector_id": "collector-abcd",
  "log_type": "WORKDAY_AUDIT",
  "request_urls": [
    "https://api.workday.com/ccx/v1/tenant/logs"
  ],
  "http_status_code": 401,
  "bytes_transferred": 0,
  "record_count": 0,
  "activity": "File Transfer",
  "details": "Authorization failure during API request.",
  "error_details": {
    "error_message": "Invalid API token or credential expired.",
    "error_code": "401",
    "error_type": "AUTHORIZATION_ERROR",
    "is_retriable": true
  }
}

Soluciona problemas

En esta sección, se describen las limitaciones y los problemas habituales.

Limitaciones

  • Campos del Servicio de transferencia de almacenamiento (STS): Los registros de los feeds estáticos enrutados desde el STS usan el tipo de recurso storage_transfer_job y el nombre de registro storagetransfer.googleapis.com/transfer_activity en lugar de chronicle.googleapis.com/ingestion_activity.
  • Correlación de telemetría: Los campos de cardinalidad alta, como feed_id, se incluyen como etiquetas de metadatos en los registros, en lugar de etiquetas de recursos en la definición del recurso supervisado. Las capacidades de correlación de Gemini Cloud Assist con etiquetas de metadatos están sujetas a una evaluación continua.

Corrección de errores

Descripción del problema Corregir
Faltan registros de feeds estáticos en las consultas estándar Asegúrate de realizar la consulta con el tipo de recurso específico de STS storage_transfer_job y el ID de registro storagetransfer.googleapis.com/transfer_activity. Consulta Visualiza los registros del Servicio de transferencia de almacenamiento.

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.