Información del registro de auditoría de Stackdriver Monitoring

En esta página, se describen los registros de auditoría que Monitoring crea como parte de Cloud Audit Logging.

Descripción general

Los servicios de Google Cloud Platform escriben registros de auditoría para ayudarte a saber quién realizó una acción y en qué momento y lugar. Cada uno de tus proyectos de GCP solo contiene los registros de auditoría para los recursos que están directamente dentro del proyecto. Otras entidades, como carpetas, organizaciones y cuentas de facturación, contienen los registros de auditoría de la entidad.

Para ver una descripción general de Cloud Audit Logging, consulta Cloud Audit Logging. Para comprender mejor Cloud Audit Logging, consulta Comprende los registros de auditoría.

Cloud Audit Logging permite conservar tres registros de auditoría para cada proyecto, carpeta y organización de GCP:

  • Registros de auditoría de eventos del sistema
  • Registros de auditoría de actividad del administrador
  • Registros de auditoría de acceso a los datos

Monitoring realiza operaciones de escritura de registros de auditoría de eventos del sistema, que contienen entradas de registro para el momento en el que Compute Engine realiza un evento del sistema. Monitoring ofrece estos registros según la configuración predeterminada.

De manera predeterminada, Monitoring proporciona y realiza operaciones de escritura de registros de auditoría para la actividad del administrador que incluyen operaciones que modifican la configuración o los metadatos de un recurso.

Monitoring realiza operaciones de escritura de los registros de auditoría, aunque no los proporciona según la configuración predeterminada, para el acceso a los datos que registran las llamadas a la API que crean, modifican o leen los datos proporcionados por el usuario.

Los registros de auditoría de acceso a los datos se dividen en diferentes categorías:

  • Acceso a los datos (ADMIN_READ): Operaciones que leen la configuración o los metadatos de un recurso.

    Monitoring no proporciona información sobre la lectura de administración según la configuración predeterminada.

  • Acceso a los datos (DATA_READ): Operaciones que leen datos proporcionados por el usuario desde un recurso.

    Monitoring no proporciona información sobre la lectura de datos según la configuración predeterminada.

  • Acceso a los datos (DATA_WRITE): Operaciones que escriben datos proporcionados por el usuario a un recurso.

    Monitoring no proporciona información sobre la escritura de datos según la configuración predeterminada.

Se puede configurar la información de auditoría que no se proporciona según la configuración predeterminada. Para obtener más información, consulta Configura registros de acceso a los datos.

Operaciones auditadas

En la siguiente tabla, se muestra un resumen de las operaciones de la API que corresponden a cada tipo de registro de auditoría en Monitoring:

Categoría de registros de auditoría Operaciones de Monitoring
Actividad del administrador projects.groups.create
projects.groups.delete
projects.groups.update
projects.metricsDescriptors.create
projects.metricDescriptors.delete
monitoring.uptimeCheckConfigs.create
monitoring.uptimeCheckConfigs.update
monitoring.uptimeCheckConfigs.delete
Acceso a los datos (ADMIN_READ) projects.metricDescriptors.get
projects.metricDescriptors.list
projects.groups.get
projects.groups.list
projects.groups.members.list
monitoring.uptimeCheckConfigs.list
monitoring.uptimeCheckConfigs.get
Acceso a los datos (DATA_READ) projects.timeSeries.list
Acceso a los datos (DATA_WRITE) projects.timeSeries.create
projects.collectdTimeSeries.create

Formato de registro de auditoría

Las entradas del registro de auditoría, que se pueden ver en Stackdriver Logging con el visor de registros en la API de Monitoring o en el SDK de Cloud, incluyen los siguientes objetos:

  • La entrada de registro, que es un objeto de tipo LogEntry. Los campos útiles incluyen los siguientes objetos:

    • logName contiene la identificación del proyecto y el tipo de registro de auditoría.
    • resource contiene el objetivo de la operación auditada.
    • timeStamp contiene el tiempo de la operación auditada.
    • protoPayload contiene la información auditada.
  • Los datos del registro de auditoría que corresponden a un objeto AuditLog contenido en el campo protoPayload de la entrada de registro.

  • Información opcional de auditoría específica del servicio, que es un objeto específico del servicio contenido en el campo serviceData del objeto AuditLog. Para obtener más información, consulta Datos de auditoría específica del servicio.

Para ver otros campos en estos objetos, su contenido de muestra y las consultas de muestra sobre la información en los objetos, consulta Tipos de datos de registro de auditoría.

Nombre del registro

Los nombres de recursos de Cloud Audit Logging indican el proyecto o cualquier otra entidad al que pertenecen los registros de auditoría y, también, si el registro contiene datos de registro de auditoría de la actividad del administrador, el acceso a los datos o los eventos del sistema. Por ejemplo, en el siguiente segmento, se muestran los nombres de registro para los registros de la actividad del administrador de un proyecto y los registros de acceso a los datos de una organización:

projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity
organizations/[ORGANIZATION_ID]/logs/cloudaudit.googleapis.com%2Fdata_access

Nombre del servicio

Los registros de auditoría de Monitoring usan el nombre de servicio monitoring.googleapis.com.

Para obtener más información sobre los servicios de registro, consulta Asigna servicios a recursos.

Tipos de recursos

Los registros de auditoría de Monitoring usan el tipo de recurso audited_resource para todos los registros de auditoría, ya que se pueden supervisar varios tipos de recursos.

Para ver una lista completa, consulta Tipos de recursos supervisados.

Habilita el registro de auditoría

Los registros de eventos del sistema están habilitados según la configuración predeterminada y no se pueden inhabilitar.

Los registros de auditoría de la actividad del administrador están habilitados según la configuración predeterminada y no se pueden inhabilitar.

La mayoría de los registros de auditoría de acceso a los datos están inhabilitados según la configuración predeterminada. La excepción son los registros de auditoría de acceso a los datos para BigQuery, que están habilitados según la configuración predeterminada y no se pueden inhabilitar. Los registros de acceso a los datos de BigQuery no cuentan para la cuota de registro de tu proyecto.

Para habilitar algunos o todos tus registros de acceso a los datos, consulta Configura registros de acceso a los datos.

Los registros de acceso a los datos que configures pueden afectar al precio de tus registros en Stackdriver. Consulta la sección Precios de esta página.

Permisos de registro de auditoría

Los permisos y las funciones de Cloud Identity and Access Management determinan qué registros de auditoría puedes ver o exportar. Los registros se encuentran en proyectos y en algunas otras entidades, incluidas organizaciones, carpetas y cuentas de facturación. Para obtener más información, consulta Comprende las funciones.

Para ver los registros de actividad del administrador, debes tener una de las siguientes funciones de Cloud IAM en el proyecto que contiene tus registros de auditoría:

Para ver los registros de acceso a los datos, debes tener una de las siguientes funciones en el proyecto que contiene tus registros de auditoría:

Para ver los registros de eventos del sistema, debes tener una de las siguientes funciones de Cloud IAM en el proyecto que contiene tus registros de auditoría:

Si usas registros de auditoría desde una entidad ajena al proyecto, como una organización, debes cambiar las funciones del proyecto por funciones adecuadas de la organización.

Visualiza los registros

Tienes varias opciones para ver tus entradas de registro de auditoría:

Lector básico

Para recuperar tus entradas de registro de auditoría, puedes usar la interfaz básica del visor de registros en GCP Console. Sigue estos pasos:

  1. Ve a la página Stackdriver Logging > Registros (Visor de registros) en GCP Console:

    Ir a la página Visor de registros

  2. Selecciona un proyecto de GCP existente en la parte superior de la página o crea un proyecto nuevo.

  3. En el primer menú desplegable, selecciona el tipo de recurso cuyos registros de auditoría desees ver. Puedes seleccionar un recurso específico o Global para todos los recursos.

  4. En el segundo menú desplegable, selecciona el tipo de registro que desees ver: activity para registros de auditoría de la actividad del administrador, data_access para registros de auditoría de acceso a los datos y system_events para registros de eventos del sistema.

    Si no ves ninguna de estas opciones, entonces no hay registros de auditoría de ese tipo disponibles en el proyecto.

Lector avanzado

Para recuperar tus entradas de registro de auditoría, puedes usar la interfaz avanzada del visor de registros de GCP Console. Sigue estos pasos:

  1. Ve a la página Stackdriver Logging > Registros (Visor de registros) en GCP Console:

    Ir a la página Visor de registros

  2. Selecciona un proyecto de GCP existente en la parte superior de la página o crea un proyecto nuevo.

  3. En el primer menú desplegable, selecciona el tipo de recurso cuyos registros de auditoría desees ver. Puedes seleccionar un recurso específico o Global para todos los recursos.

  4. Haz clic en la flecha desplegable (▾) en el extremo derecho del cuadro de filtro de búsqueda y selecciona Convertir en filtro avanzado.

  5. Crea un filtro que especifique más a fondo las entradas de registro que desees ver. Para recuperar todos los registros de auditoría de tu proyecto, agrega el siguiente filtro. Proporciona un [PRODUCT_ID] válido en cada uno de los nombres de registro.

      logName = ("projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity" OR
          OR "projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events"
          OR "projects/[PROJECT_ID]logs/cloudaudit.googleapis.com%2Fdata_access")
    

    Para obtener más información sobre los filtros, consulta Filtros avanzados de registro.

API

Para ver las entradas de tu registro de auditoría con la API de Monitoring, sigue los pasos a continuación:

  1. Ve a la sección Prueba esta API en la documentación del método entries.list.

  2. Ingresa lo siguiente en el cuerpo de la solicitud del formulario Prueba esta API. Si haces clic en este formulario propagado previamente, se completará el cuerpo de la solicitud de manera automática, pero deberás proporcionar un [PRODUCT_ID] válido para cada uno de los nombres de registro.

      {
        "resourceNames": [
          "projects/[PROJECT_ID]"
        ],
        "pageSize": 5,
        "filter": "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)"
      }
    
  3. Haz clic en Ejecutar.

Para obtener más información sobre los filtros, consulta Filtros avanzados de registro.

SDK

Para leer las entradas de registro con el SDK de Cloud, ejecuta el siguiente comando. Proporciona un [PRODUCT_ID] válido en cada uno de los nombres de registro.

gcloud logging read "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)

Para obtener más información sobre el uso del SDK de Cloud, consulta Lee entradas de registro.

Para ver una muestra de entrada de registro de auditoría y obtener más información sobre cómo encontrar la información más importante allí, consulta Comprende los registros de auditoría.

Exporta registros de auditoría

Puedes exportar registros de auditoría de la misma manera en la que exportas otro tipo de registros. Para obtener más información sobre cómo exportar los registros, consulta Exporta registros. Estas son algunas aplicaciones clave para exportar registros de auditoría:

  • Para conservar los registros de auditoría por un período más largo o usar capacidades de búsqueda más potentes, puedes exportar copias de los registros de auditoría a Cloud Storage, BigQuery o Cloud Pub/Sub. Con Cloud Pub/Sub, puedes exportar a otras aplicaciones, a otros repositorios y a terceros.

  • Para administrar los registros de auditoría en toda la organización, puedes crear receptores de exportación agregada que puedan exportar registros de cualquier proyecto o de todos los proyectos de la organización.

  • Si tus registros de acceso a los datos habilitados sobrepasan las asignaciones de registros de tus proyectos, puedes exportar y excluir los registros de acceso a los datos de Logging. Para obtener más información, consulta Excluye registros.

Precios

Stackdriver Logging no te cobra por los registros de auditoría que están habilitados según la configuración predeterminada, incluidos todos los registros de actividad del administrador y eventos del sistema.

Stackdriver Logging te cobra por los registros de acceso a los datos que solicitas de manera explícita.

Para obtener más información sobre los precios de los registros, incluidos los precios de los registros de auditoría, consulta Precios de Stackdriver.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Stackdriver Monitoring
Si necesitas ayuda, visita nuestra página de asistencia.