設定 NotebookLM Enterprise 的使用稽核記錄

本指南說明管理員如何透過 API，為 NotebookLM Enterprise 開啟及監控使用情況稽核記錄。機構可透過使用情況稽核記錄追蹤使用者作業、中繼資料和核心內容，以進行稽核和可觀測性作業。

您可以在專案層級使用 ObservabilityConfig 設定，管理 NotebookLM Enterprise 的使用情況稽核。開啟可觀測性後，系統會擷取要求和回應資料 (包括提示詞和基礎中繼資料)，並儲存在 Cloud Logging 中。

事前準備

設定稽核記錄前，請確認您擁有下列 IAM 角色：

  • 如要啟用稽核記錄，您必須具備 Discovery Engine 管理員 IAM 角色 (roles/discoveryengine.admin)。
  • 如要存取 Cloud Logging，您必須具備「記錄檢視者」IAM 角色 (roles/logging.viewer)。

啟用使用情況稽核記錄

如要啟用用量稽核記錄，請執行下列指令：

REST

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

更改下列內容：

  • ENDPOINT_LOCATION：API 要求的適用多區域。指定下列其中一個值：
    • 美國多區域的 us
    • eu 適用於歐盟多區域
    • global 全球位置
    詳情請參閱「為資料儲存庫指定多區域」。
  • PROJECT_ID：專案 ID。

記錄資訊

下表摘要說明 NotebookLM Enterprise 記錄的用量資料：

服務路徑 記錄資料
NotebookService.CreateNotebook 要求：
  • parent
  • notebook.name
回應：
  • No response fields are logged.
NotebookService.ShareNotebook 要求：
  • name
  • account_and_roles
回應：
  • No response fields are logged.
NotebookService.DeleteNotebook 要求：
  • parent
  • names
回應：
  • No response fields are logged.
NotebookService.GetNotebook 要求：
  • name
回應：
  • name
  • title
  • cmek_config

存取用量記錄

如要查看 NotebookLM Enterprise 的使用稽核記錄，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Logs Explorer」頁面。

    前往 Logs Explorer

  2. 選取已啟用稽核記錄的 Google Cloud 專案。

  3. 使用下列查詢，查看 NotebookLM Enterprise 的稽核記錄：

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

    您可以進一步篩選特定方法，縮小查詢範圍。例如 protoPayload.methodName="google.cloud.discoveryengine.v1alpha.NotebookService.CreateNotebook"。

關閉使用情況稽核記錄

如要關閉用量稽核記錄，請執行下列指令：

REST

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

更改下列內容：

  • ENDPOINT_LOCATION：API 要求的適用多區域。指定下列其中一個值：
    • 美國多區域的 us
    • eu 適用於歐盟多區域
    • global 全球位置
    詳情請參閱「為資料儲存庫指定多區域」。
  • PROJECT_ID：專案 ID。