Configurare l'audit logging dell'utilizzo per NotebookLM Enterprise

Questa guida spiega come gli amministratori possono attivare e monitorare la registrazione del controllo dell'utilizzo per NotebookLM Enterprise tramite l'API. I log di controllo dell'utilizzo consentono alle organizzazioni di monitorare le operazioni degli utenti, i metadati e i contenuti principali a scopo di controllo e osservabilità.

Puoi gestire il controllo dell'utilizzo di NotebookLM Enterprise utilizzando le impostazioni ObservabilityConfig a livello di progetto. L'attivazione dell'osservabilità acquisisce i dati di richiesta e risposta, inclusi i prompt e i metadati di grounding, e li archivia in Cloud Logging.

Nota :i dati sensibili non vengono filtrati dagli audit log.

Prima di iniziare

Prima di configurare i log di controllo, assicurati di disporre dei seguenti ruoli IAM:

• Per abilitare gli audit log, devi disporre del ruolo IAM Amministratore Discovery Engine (roles/discoveryengine.admin).
• Per accedere a Cloud Logging, devi disporre del ruolo IAM Visualizzatore log (roles/logging.viewer).

Attivare l'audit logging dell'utilizzo

Per attivare la registrazione degli audit di utilizzo, esegui questo comando:

REST

Termine chiave: in Gemini Enterprise, il termine app può essere utilizzato in modo intercambiabile con il termine motore nel contesto delle API. Un motore Gemini Enterprise è un motore di ricerca generico in cui il campo app_type è impostato su 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
      }
    }
  }
}'

Sostituisci quanto segue:

• ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Specifica uno dei seguenti valori:
  • us per la multi-regione Stati Uniti
  • eu per la multiregione EU
  • global per la località globale
  Per saperne di più, consulta Specifica una regione multipla per il datastore.
• PROJECT_ID: l'ID progetto.

Informazioni registrate

La seguente tabella riepiloga i dati di utilizzo registrati da NotebookLM Enterprise:

Percorso del servizio	Dati registrati
NotebookService.CreateNotebook	Richiesta: parent notebook.name Risposta: No response fields are logged.
NotebookService.ShareNotebook	Richiesta: name account_and_roles Risposta: No response fields are logged.
NotebookService.DeleteNotebook	Richiesta: parent names Risposta: No response fields are logged.
NotebookService.GetNotebook	Richiesta: name Risposta: name title cmek_config

Accedere ai log di utilizzo

Per visualizzare i log di controllo dell'utilizzo di NotebookLM Enterprise:

1. Nella console Google Cloud , vai alla pagina Esplora log.

   Vai a Esplora log

2. Seleziona il progetto Google Cloud per cui hai attivato l'audit logging.

3. Utilizza la seguente query per visualizzare gli audit log per NotebookLM Enterprise:

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

   Puoi perfezionare ulteriormente la query per filtrare in base a metodi specifici. Ad esempio protoPayload.methodName="google.cloud.discoveryengine.v1alpha.NotebookService.CreateNotebook".

Disattivare i log di controllo dell'utilizzo

Per disattivare la registrazione degli audit log di utilizzo, esegui questo comando:

REST

Termine chiave: in Gemini Enterprise, il termine app può essere utilizzato in modo intercambiabile con il termine motore nel contesto delle API. Un motore Gemini Enterprise è un motore di ricerca generico in cui il campo app_type è impostato su 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
      }
    }
  }
}'

Sostituisci quanto segue:

• ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Specifica uno dei seguenti valori:
  • us per la multi-regione Stati Uniti
  • eu per la multiregione EU
  • global per la località globale
  Per saperne di più, consulta Specifica una regione multipla per il datastore.
• PROJECT_ID: l'ID progetto.