このページでは、Gemini Enterprise の使用状況の監査ログを設定してアクセスする方法について説明します。
主なコンセプト
このセクションでは、Gemini Enterprise のオブザーバビリティに関連する主なコンセプトについて説明します。
| コンセプト | 説明 |
|---|---|
| 使用状況の監査ログ | 使用状況の監査ログは、 Google Cloud リソース内の管理アクティビティとアクセスの記録です。誰が、いつ、どこから、どのような操作を行ったかに関する詳細な情報が提供されます。これらのログは、セキュリティ監査、コンプライアンス、リソースの使用状況の把握に不可欠です。 |
始める前に
監査ログを構成する前に、次のものがあることを確認してください。
- オブザーバビリティの設定を有効にします。詳細については、オブザーバビリティ設定を有効にするをご覧ください。
- 監査ロギングを有効にするには、Gemini Enterprise 管理者 IAM ロール(
roles/discoveryengine.agentspaceAdmin)が必要です。 - Cloud Logging にアクセスするには、ログビューアの IAM ロール(
roles/logging.viewer)が必要です。 - Gemini Enterprise app が作成されていることを確認します。作成するには、アプリを作成するをご覧ください。
ログに記録される情報
次の表に、Gemini Enterprise によってログに記録される使用状況データの概要を示します。各フィールドには、次のようにラベルが付けられます。
- 機密: フィールドには、プロンプト、レスポンス、その他の顧客コンテンツが含まれる場合があります。これは、[プロンプト入力とレスポンス出力のロギングを有効にする] 設定がオンになっている場合にのみログに記録されます。この設定をオフにすると、テキスト値は
<elided>に置き換えられ、他の値は省略されます。詳細については、オブザーバビリティ設定を有効にするをご覧ください。 - 機密でない: 設定がオンになっているかどうかにかかわらず、フィールドがログに記録されます。
- 部分的に機密: リストされているサブフィールドのみが機密です。他のサブフィールドは機密情報ではありません。
| サービスパス | ログデータ |
|---|---|
SearchService.Search |
グラウンディングに使用されるソースまたは LLM 入力として使用されるソースのデータをログに記録します。 リクエスト:
レスポンス:
|
AssistantService.Assist |
Gemini Enterprise アシスタントからのリクエストとレスポンスをログに記録します。 リクエスト:
レスポンス:
|
AssistantService.StreamAssist |
リクエスト:
レスポンス:
ターンは、別のモデルを実行する専門のエージェントにハンドオフできます。 |
ConversationSearchService.AnswerQuery |
リクエスト:
レスポンス:
|
EngineService.CreateEngine |
リクエスト:
レスポンス:
|
EngineService.UpdateEngine |
リクエスト:
レスポンス:
|
AgentService.SetIamPolicy |
リクエスト:
レスポンス:
|
AgentService.CreateAgent |
リクエスト:
レスポンス:
|
AgentService.UpdateAgent |
リクエスト:
レスポンス:
|
AgentService.DeleteAgent |
リクエスト:
レスポンス:
|
GroundedGenerationService.GenerateGroundedContent |
リクエスト:
レスポンス:
|
DataConnectorService.UpdateDataConnector |
リクエスト:
レスポンス:
|
AssistantService.AddContextFile |
リクエスト:
レスポンス:
|
AssistantService.UploadSessionFile |
リクエスト:
レスポンス:
|
UserEventService.WriteUserEvent |
リクエスト:
レスポンス:
|
CoscientistService.CoscientistRunCompletion |
Co-Scientist の実行が正常に完了すると、1 回記録されます。他の行とは異なり、このエントリは API リクエストのログではありません。 coscientist_run_info:
|
使用状況の監査ログにアクセスする
Gemini Enterprise のすべての使用状況の監査ログにアクセスして表示する手順は次のとおりです。
Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。
監査ロギングを有効にした Google Cloud プロジェクトを選択します。
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 ロールは、このバケットへのアクセスを制御します。
ログビューア ロール(
roles/logging.viewer)プライベート ログビューアロール(
roles/logging.privateLogViewer)ログ表示アクセス者ロール(
roles/logging.viewAccessor)
きめ細かいアクセス制御
プロジェクトにさまざまな機密レベルのログが含まれている場合は、いくつかの Google Cloud ツールと Cloud Logging ツールを使用して、よりきめ細かいアクセス制御を構成できます。
きめ細かいアクセス制御は、次のオプションを使用して構成できます。
| オプション | 説明 |
|---|---|
| IAM 条件 | IAM 条件を使用してきめ細かいアクセス制御を設定する。詳細については、Logging のロールをご覧ください。 |
| ログビュー | ログビューを使用して、ログバケット内のログのサブセットへのユーザー アクセスを制限します。詳細については、ログバケットのログビューを構成するをご覧ください。 |
| ログシンク | ログシンクを使用して、機密性の高いログを、より制限の厳しい IAM アクセス権を持つ別のプロジェクトに転送します。詳細については、サポートされている宛先にログをルーティングするをご覧ください。 |
| タグ | タグを使用して、プロジェクト内の個々のログバケットへの IAM アクセスを管理します。詳細については、タグを使用してログバケットへのアクセスを管理するをご覧ください。 |
| フィールド レベルのアクセス制御 | フィールド レベルのアクセス制御を使用して、ログエントリ内の特定のフィールドへのアクセスを非表示または制限します。詳細については、フィールド レベルのアクセスを構成するをご覧ください。 |
次のステップ
- プロンプト入力とレスポンス出力のロギングをオフにするには、オブザーバビリティ設定をオフにするをご覧ください。