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 멀티 리전의 경우 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 콘솔에서 로그 탐색기 페이지로 이동합니다.

    로그 탐색기로 이동

  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 멀티 리전의 경우 eu
    • 전역 위치의 경우 global
    자세한 내용은 데이터 스토어의 멀티 리전 지정을 참조하세요.
  • PROJECT_ID: 프로젝트의 ID입니다.