透過 Cloud Logging 存取 Gemini Enterprise 使用情形稽核記錄

本頁說明如何設定及存取 Gemini Enterprise 的使用情況稽核記錄。

基本概念

本節介紹 Gemini Enterprise 觀測能力的重要概念。

概念 說明
使用情況稽核記錄 使用情況稽核記錄會記錄 Google Cloud 資源中的管理和存取活動。詳細記錄執行動作的使用者、時間和位置。這些記錄檔對於安全稽核、法規遵循，以及瞭解資源的使用方式至關重要。

事前準備

設定稽核記錄前，請確認您具備下列條件：

記錄資訊

下表彙整了 Gemini Enterprise 記錄的用量資料。 各欄位標示如下：

  • 敏感：欄位可能包含提示、回覆或其他客戶內容。只有在啟用「Enable logging of prompt inputs and response outputs」(啟用提示詞輸入內容和回覆輸出內容的記錄功能) 設定時，系統才會記錄這項資訊。如果關閉這項設定，系統會將文字值替換為 <elided>，並省略其他值。詳情請參閱「開啟觀測能力設定」。
  • 不敏感：無論是否開啟設定，系統都會記錄該欄位。
  • 部分機密：只有列出的子欄位屬於機密。其他子欄位則不屬於機密資訊。
服務路徑 記錄資料
SearchService.Search

記錄用於建立基準或做為 LLM 輸入內容的來源資料。

要求：
  • query (機密)
  • user_info (部分敏感)。只有下列子欄位屬於敏感資料：
    • time_zone
    • precise_location

回應：
  • attribution_token (非機密)
  • results.id (非機密)
  • results.document.name (非機密)
AssistantService.Assist

記錄 Gemini Enterprise 助理的要求和回覆。

要求：
  • name (非機密)
  • query.text (機密)
  • query.parts (機密)

回應：
  • assist_token (非機密)
  • answer.name (非機密)
  • answer.state (非機密)
  • answer.replies.grounded_content.text (機密)
  • answer.replies.grounded_content.text_grounding_metadata.segments (機密)
  • answer.replies.grounded_content.text_grounding_metadata.references (部分敏感)。除了 document_metadata.document 和 document_metadata.uri 以外，所有子欄位都屬於機密資訊。
  • answer.skipped_reasons (非機密)
  • agent_info.agent (非機密)
  • agent_info.display_name (機密)
  • agent_info.core_assistant (非機密)
  • agent_info.agent_kind (非機密)
  • agent_info.spiffe_id (非機密)
AssistantService.StreamAssist 要求：
  • name (非機密)
  • query.text (機密)
  • query.parts (機密)
  • agents_spec (部分敏感)。只有下列子欄位屬於機密：
    • agent_specs.input_variables
    • agent_specs.node_context.node_input
    • agent_specs.node_context.agent_description
    • agent_specs.node_context.node_instruction
    • agent_specs.artifact_spec.tagged_artifact_content

回覆：
  • assist_token (非機密)
  • answer.name (非機密)
  • answer.state (非機密)
  • answer.replies.grounded_content.text (機密)
  • answer.replies.grounded_content.text_grounding_metadata.segments (機密)
  • answer.replies.grounded_content.text_grounding_metadata.references (部分敏感)。除了 document_metadata.document 和 document_metadata.uri 以外，所有子欄位都屬於機密資訊。
  • answer.skipped_reasons (非機密)
  • agent_info.agent (非機密)
  • agent_info.display_name (機密)
  • agent_info.core_assistant (非機密)
  • agent_info.agent_kind (非機密)
  • agent_info.spiffe_id (非機密)
  • model_info.model (非機密)
  • model_info.requested_model (非機密)
  • model_info.model_selection_mode (非機密)

model_info.model 是助理在該回合執行的模型。如果要求未固定模型，model_selection_mode 為 MODEL_SELECTION_MODE_AUTO，requested_model 則為空白；如果要求固定模型，model_selection_mode 為 MODEL_SELECTION_MODE_EXPLICIT，requested_model 則會保留要求的模型。

回合可以交由執行不同模型的專業人員處理。model_info.model 不會回報該代理的模型，而在此類代理中完成所有工作的輪次會將 model_info.model 留空。
ConversationSearchService.AnswerQuery 要求：
  • serving_config (非機密)
  • query.query_id (非機密)
  • query.text (機密)
  • session (非機密)
  • user_pseudo_id (非機密)
  • end_user_spec (部分敏感)。只有下列子欄位屬於機密：
    • end_user_metadata.chunk_info.content
    • end_user_metadata.chunk_info.document_metadata.title
  • answer_generation_spec.model_spec.model_version (非機密)
  • answer_generation_spec.prompt_spec.preamble (機密)
  • answer_generation_spec.include_citations (非機密)
  • answer_generation_spec.answer_language_code (機密)
  • answer_generation_spec.ignore_adversarial_query (非機密)
  • answer_generation_spec.ignore_non_answer_seeking_query (非機密)
  • answer_generation_spec.ignore_jail_breaking_query (非機密)

回覆：
  • answer (部分敏感)。只有下列子欄位屬於敏感資訊：
    • answer_text
    • grounding_supports
    • references
    • blob_attachments
    • steps.actions
  • answer_query_token (非機密)
EngineService.CreateEngine 要求：
  • engine_id (非機密)
  • engine.name (非機密)
  • engine.create_time (非機密)
  • engine.display_name (非機密)
  • engine.update_time (非機密)
  • engine.data_store_ids (非機密)
  • engine.data_stores (非機密)

回覆：
  • engine_id (非機密)
  • engine.name (非機密)
  • engine.create_time (非機密)
  • engine.display_name (非機密)
  • engine.update_time (非機密)
  • engine.data_store_ids (非機密)
  • engine.data_stores (非機密)
EngineService.UpdateEngine 要求：
  • engine.name (非機密)
  • engine.create_time (非機密)
  • engine.display_name (非機密)
  • engine.update_time (非機密)
  • engine.data_store_ids (非機密)
  • engine.data_stores (非機密)
  • update_mask (非機密)

回覆：
  • engine.name (非機密)
  • engine.create_time (非機密)
  • engine.display_name (非機密)
  • engine.update_time (非機密)
  • engine.data_store_ids (非機密)
  • engine.data_stores (非機密)
AgentService.SetIamPolicy 要求：
  • policy.bindings.roles (非機密)
  • policy.bindings.members (非機密)

回覆：
  • policy.bindings.roles (非機密)
  • policy.bindings.members (非機密)
AgentService.CreateAgent 要求：
  • parent (非機密)
  • agent_id (非機密)
  • agent.name (非機密)
  • agent.display_name (機密)
  • agent.create_time (非機密)
  • agent.update_time (非機密)
  • agent.definition_case (非機密)

回覆：
  • agent.name (非機密)
  • agent.display_name (機密)
  • agent.create_time (非機密)
  • agent.update_time (非機密)
  • agent.definition_case (非機密)
AgentService.UpdateAgent 要求：
  • agent.name (非機密)
  • agent.display_name (機密)
  • agent.create_time (非機密)
  • agent.update_time (非機密)
  • agent.definition_case (非機密)
  • update_mask (非機密)

回應：
  • agent.name (非機密)
  • agent.display_name (機密)
  • agent.create_time (非機密)
  • agent.update_time (非機密)
  • agent.definition_case (非機密)
AgentService.DeleteAgent 要求：
  • name (非機密)

回覆：
  • 未記錄任何欄位
GroundedGenerationService.GenerateGroundedContent 要求：
  • contents (機密)
  • location (非機密)
  • generation_spec (部分敏感)。只有下列子欄位屬於敏感資訊：
    • language_code
  • system_instruction (機密)
  • safety_settings (非機密)
  • user_labels (機密)
  • grounding_spec.explicit_search_queries (機密)
  • grounding_spec.grounding_sources (部分敏感)。只有下列子欄位屬於機密：
    • inline_source
    • search_source.filter
    • api_source.manifest.api_spec.open_api_yaml
    • elastic_source.search_template
    • elastic_source.num_hits
    • parallel_ai_source.custom_configs
    • exa_ai_source.custom_configs

回覆：
  • content (機密)
  • grounding_metadata (部分敏感)。只有下列子欄位屬於機密：
    • support_chunks，但 source 和 index 除外
    • google_maps_support_chunks，但 source 和 index 除外
    • api_calls.request_payload
    • api_calls.response_body
    • api_calls.uri
  • grounding_score (非機密)
DataConnectorService.UpdateDataConnector 要求：
  • data_connector.name (非機密)
  • data_connector.create_time (非機密)
  • data_connector.update_time (非機密)
  • data_connector.data_source (非機密)
  • data_connector.refresh_interval (非機密)
  • data_connector.bap_config (非機密)

回應：
  • data_connector.name (非機密)
  • data_connector.create_time (非機密)
  • data_connector.update_time (非機密)
  • data_connector.data_source (非機密)
  • data_connector.refresh_interval (非機密)
  • data_connector.bap_config (非機密)
AssistantService.AddContextFile 要求：
  • name (非機密)
  • file_name (機密)

回覆：
  • session (非機密)
  • file_id (非機密)
AssistantService.UploadSessionFile 要求：
  • name (非機密)
  • blob.filename (機密)

回應：
  • file_id (非機密)
UserEventService.WriteUserEvent 要求：
  • 要求主體中的所有欄位 (部分為私密資訊)。只有下列子欄位屬於敏感資訊：
    • user_event.user_info.time_zone
    • user_event.user_info.precise_location
    • user_event.filter
    • user_event.attributes
    • user_event.panel.documents
    • user_event.panels.documents
    • user_event.search_info.search_query
    • user_event.completion_info.selected_suggestion
    • user_event.feedback.comment
    • user_event.feedback.conversation_info.query

回覆：
  • 未記錄任何欄位

存取使用情況稽核記錄

如要存取及查看所有 Gemini Enterprise 使用情況稽核記錄，請按照下列步驟操作：

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

    前往 Logs Explorer

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

  3. 如要只顯示 Gemini Enterprise 記錄，請在查詢編輯器欄位中輸入下列查詢，然後按一下「執行查詢」：

      logName="projects/PROJECT_ID/logs/discoveryengine.googleapis.com%2Fgemini_enterprise_user_activity" OR logName=~"projects/PROJECT_ID/logs/discoveryengine.googleapis.com%2Fgen_ai.*"

    更改下列內容：

    • PROJECT_ID：專案的 ID。

控管記錄檔存取權

您可以在 Cloud Logging 中控管記錄的存取權。如需存取控管方法的詳細指引，包括使用 IAM 條件進行精細存取，請參閱「使用 IAM 控管存取權」。

預設存取控管

根據預設，Gemini Enterprise 會將 Cloud Logging 資料傳送至 _Default bucket。下列 IAM 角色可控管這個 bucket 的存取權：

精細的存取控管機制

如果專案包含敏感度等級不同的記錄，您可以使用多個 Google Cloud 和 Cloud Logging 工具，設定更精細的存取控管。

您可以透過下列選項設定精細的存取權控管：

選項 說明
IAM 條件 使用 IAM 條件設定精細的存取控管機制。詳情請參閱「Logging 角色」。
記錄檢視 使用記錄檢視，限制使用者只能存取記錄檔 bucket 中的部分記錄。詳情請參閱「設定記錄檔 bucket 的記錄檢視畫面」。
記錄接收器 使用記錄接收器將機密記錄檔傳送至 IAM 存取權限制較嚴格的專案。詳情請參閱「將記錄檔轉送至支援的目的地」。
標記 使用標記管理專案中個別記錄檔 bucket 的 IAM 存取權。詳情請參閱「使用標記管理記錄儲存空間的存取權」。
欄位層級存取控管 使用欄位層級存取控管機制，隱藏或限制存取記錄項目中的特定欄位。詳情請參閱「設定欄位層級存取權」。

後續步驟