このガイドでは、管理者が API を使用して NotebookLM Enterprise の使用状況監査ロギングを有効にしてモニタリングする方法について説明します。使用状況監査ログを使用すると、組織は監査とオブザーバビリティの目的で、ユーザー操作、メタデータ、コア コンテンツを追跡できます。
NotebookLM Enterprise の使用状況監査は、プロジェクト レベルの ObservabilityConfig 設定を使用して管理できます。オブザーバビリティを有効にすると、プロンプトやグラウンディング メタデータなどのリクエストとレスポンスのデータがキャプチャされ、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 |
リクエスト:
|
NotebookService.ShareNotebook |
リクエスト:
|
NotebookService.DeleteNotebook |
リクエスト:
|
NotebookService.GetNotebook |
リクエスト:
|
使用状況ログにアクセスする
NotebookLM Enterprise の使用状況監査ログを表示するには:
Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。
監査ロギングを有効にした Google Cloud プロジェクトを選択します。
次のクエリを使用して、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。