Configura el registro de auditoría de uso para NotebookLM Enterprise

En esta guía, se explica cómo los administradores pueden activar y supervisar el registro de auditoría de uso de NotebookLM Enterprise a través de la API. Los registros de auditoría de uso permiten a las organizaciones hacer un seguimiento de las operaciones del usuario, los metadatos y el contenido principal con fines de auditoría y observabilidad.

Puedes administrar la auditoría de uso de NotebookLM Enterprise con la configuración de ObservabilityConfig a nivel del proyecto. Activar la observabilidad captura datos de solicitudes y respuestas, incluidos los mensajes y los metadatos de fundamentación, y los almacena en Cloud Logging.

Nota: Los datos sensibles no se filtran de los registros de auditoría.

Antes de comenzar

Antes de configurar los registros de auditoría, asegúrate de tener los siguientes roles de IAM:

• Para habilitar los registros de auditoría, debes tener el rol de IAM de administrador de Discovery Engine (roles/discoveryengine.admin).
• Para acceder a Cloud Logging, debes tener el rol de IAM de Visualizador de registros (roles/logging.viewer).

Activa el registro de auditoría de uso

Para activar el registro de auditoría de uso, ejecuta el siguiente comando:

REST

Término clave: En Gemini Enterprise, el término app se puede usar indistintamente con el término motor en el contexto de las APIs. Un motor de Gemini Enterprise es un motor de búsqueda genérico en el que el campo app_type se establece en APP_TYPE_INTRANET.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID?updateMask=customerProvidedConfig.notebooklmConfig.observabilityConfig" \
-d '{
  "customerProvidedConfig": {
    "notebooklmConfig": {
      "observabilityConfig": {
        "observabilityEnabled": true,
        "sensitiveLoggingEnabled": true
      }
    }
  }
}'

Reemplaza lo siguiente:

• ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
  • us para la multirregión de EE.UU.
  • eu para la multirregión de la UE
  • global para la ubicación global
  Para obtener más información, consulta Cómo especificar una región múltiple para tu almacén de datos.
• PROJECT_ID: el ID de tu proyecto.

Información registrada

En la siguiente tabla, se resumen los datos de uso que registra NotebookLM Enterprise:

Ruta de servicio	Datos registrados
NotebookService.CreateNotebook	Solicitud: parent notebook.name Respuesta: No response fields are logged.
NotebookService.ShareNotebook	Solicitud: name account_and_roles Respuesta: No response fields are logged.
NotebookService.DeleteNotebook	Solicitud: parent names Respuesta: No response fields are logged.
NotebookService.GetNotebook	Solicitud: name Respuesta: name title cmek_config

Accede a los registros de uso

Para ver los registros de auditoría de uso de NotebookLM Enterprise, haz lo siguiente:

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

   Ve al Explorador de registros

2. Selecciona el proyecto Google Cloud para el que habilitaste el registro de auditoría.

3. Usa la siguiente consulta para ver los registros de auditoría de NotebookLM Enterprise:

   resource.type="audited_resource"
   resource.labels.service="discoveryengine.googleapis.com"
   protoPayload.serviceName="discoveryengine.googleapis.com"
   protoPayload.methodName:"NotebookService"
   

   Puedes definir mejor la búsqueda para filtrar por métodos específicos. Por ejemplo: protoPayload.methodName="google.cloud.discoveryengine.v1alpha.NotebookService.CreateNotebook"

Cómo desactivar los registros de auditoría de uso

Para desactivar el registro de auditoría de uso, ejecuta el siguiente comando:

REST

Término clave: En Gemini Enterprise, el término app se puede usar indistintamente con el término motor en el contexto de las APIs. Un motor de Gemini Enterprise es un motor de búsqueda genérico en el que el campo app_type se establece en APP_TYPE_INTRANET.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID?updateMask=customerProvidedConfig.notebooklmConfig.observabilityConfig" \
-d '{
  "customerProvidedConfig": {
    "notebooklmConfig": {
      "observabilityConfig": {
        "observabilityEnabled": false,
        "sensitiveLoggingEnabled": false
      }
    }
  }
}'

Reemplaza lo siguiente:

• ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
  • us para la multirregión de EE.UU.
  • eu para la multirregión de la UE
  • global para la ubicación global
  Para obtener más información, consulta Cómo especificar una región múltiple para tu almacén de datos.
• PROJECT_ID: el ID de tu proyecto.