Cloud Logging で Gemini Enterprise の使用状況監査ログにアクセスする

このページでは、Gemini Enterprise の使用状況の監査ログを設定してアクセスする方法について説明します。

主なコンセプト

このセクションでは、Gemini Enterprise のオブザーバビリティに関連する主なコンセプトについて説明します。

コンセプト 説明
使用状況の監査ログ 使用状況の監査ログは、 Google Cloud リソース内の管理アクティビティとアクセスの記録です。誰が、いつ、どこから、どのような操作を行ったかに関する詳細な情報が提供されます。これらのログは、セキュリティ監査、コンプライアンス、リソースの使用状況の把握に不可欠です。

始める前に

監査ログを構成する前に、次のものがあることを確認してください。

ログに記録される情報

次の表に、Gemini Enterprise によってログに記録される使用状況データの概要を示します。各フィールドには、次のようにラベルが付けられます。

  • 機密: フィールドには、プロンプト、レスポンス、その他の顧客コンテンツが含まれる場合があります。これは、[プロンプト入力とレスポンス出力のロギングを有効にする] 設定がオンになっている場合にのみログに記録されます。この設定をオフにすると、テキスト値は <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

レスポンス:
  • フィールドがログに記録されない
CoscientistService.CoscientistRunCompletion

Co-Scientist の実行が正常に完了すると、1 回記録されます。他の行とは異なり、このエントリは API リクエストのログではありません。log_metadata.name は、Co-Scientist インスタンスのリソース名です。一時停止して再開したインスタンスは、インスタンス全体をカバーする 1 つのエントリを生成します。これらのエントリをクエリする方法については、Co-Scientist の実行をモニタリングするをご覧ください。

coscientist_run_info:
  • starter_user_principal(機密ではない): 実行を開始したユーザー。メールアドレスまたは別のプリンシパル ID。フォークされた実行の場合、フォークしたユーザー。
  • start_time(機密情報ではない): インスタンスが作成された日時。
  • duration(機密情報ではない): start_time から実行が完了するまでの時間(一時停止していた時間を含む)。
  • input_token_count(機密情報以外): インスタンスがすべての実行で使用した入力トークン。これは使用量であり、料金ではありません。Cloud Billing で支出を調整してください。
  • output_token_count(機密情報以外): インスタンスがすべての実行で使用した出力トークン。

使用状況の監査ログにアクセスする

Gemini Enterprise のすべての使用状況の監査ログにアクセスして表示する手順は次のとおりです。

  1. Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。

    [ログ エクスプローラ] に移動

  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 バケットに送信します。次の IAM ロールは、このバケットへのアクセスを制御します。

きめ細かいアクセス制御

プロジェクトにさまざまな機密レベルのログが含まれている場合は、いくつかの Google Cloud ツールと Cloud Logging ツールを使用して、よりきめ細かいアクセス制御を構成できます。

きめ細かいアクセス制御は、次のオプションを使用して構成できます。

オプション 説明
IAM 条件 IAM 条件を使用してきめ細かいアクセス制御を設定する。詳細については、Logging のロールをご覧ください。
ログビュー ログビューを使用して、ログバケット内のログのサブセットへのユーザー アクセスを制限します。詳細については、ログバケットのログビューを構成するをご覧ください。
ログシンク ログシンクを使用して、機密性の高いログを、より制限の厳しい IAM アクセス権を持つ別のプロジェクトに転送します。詳細については、サポートされている宛先にログをルーティングするをご覧ください。
タグ タグを使用して、プロジェクト内の個々のログバケットへの IAM アクセスを管理します。詳細については、タグを使用してログバケットへのアクセスを管理するをご覧ください。
フィールド レベルのアクセス制御 フィールド レベルのアクセス制御を使用して、ログエントリ内の特定のフィールドへのアクセスを非表示または制限します。詳細については、フィールド レベルのアクセスを構成するをご覧ください。

次のステップ