Agent Registry の監査ロギング

このドキュメントでは、Agent Registry の監査対象メソッドを一覧表示します。 Google Cloud サービスは、 Google Cloud リソース内の管理アクティビティとアクセス アクティビティを記録する監査ログを生成します。Cloud Audit Logs の詳細については、以下をご覧ください。

サービス名

エージェント レジストリの監査ログを表示する手順は次のとおりです。

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

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

  2. 次のクエリをコピーして、ログ エクスプローラの [クエリ] フィールドに貼り付け、[クエリを実行] をクリックします。

        protoPayload.serviceName="agentregistry.googleapis.com"

メソッド（権限タイプ別）

各 IAM 権限には type プロパティがあります。このプロパティの値は列挙型で、ADMIN_READ、ADMIN_WRITE、DATA_READ、DATA_WRITE のいずれかになります。メソッドを呼び出すと、Agent Registry は監査ログを生成します。このログのカテゴリは、メソッドの実行に必要な権限の type プロパティによって異なります。type プロパティ値が DATA_READ、DATA_WRITE、または ADMIN_READ の IAM 権限を必要とするメソッドは、データアクセス監査ログを生成します。type プロパティ値が ADMIN_WRITE の IAM 権限を必要とするメソッドは、管理アクティビティ監査ログを生成します。

次のリスト中の（LRO）と付記されている API メソッドは、長時間実行オペレーション（LRO）です。これらのメソッドは、通常、2 つの監査ログエントリを生成します。一つはオペレーションの開始時、もう一つは終了時に生成されます。詳細については、長時間実行オペレーションの監査ログをご覧ください。
権限タイプ メソッド
ADMIN_READ google.cloud.agentregistry.v1alpha.AgentRegistry.FetchAvailableBindings
google.cloud.agentregistry.v1alpha.AgentRegistry.GetAgent
google.cloud.agentregistry.v1alpha.AgentRegistry.GetBinding
google.cloud.agentregistry.v1alpha.AgentRegistry.GetEndpoint
google.cloud.agentregistry.v1alpha.AgentRegistry.GetMcpServer
google.cloud.agentregistry.v1alpha.AgentRegistry.GetService
google.cloud.agentregistry.v1alpha.AgentRegistry.ListAgents
google.cloud.agentregistry.v1alpha.AgentRegistry.ListBindings
google.cloud.agentregistry.v1alpha.AgentRegistry.ListEndpoints
google.cloud.agentregistry.v1alpha.AgentRegistry.ListMcpServers
google.cloud.agentregistry.v1alpha.AgentRegistry.ListServices
google.cloud.agentregistry.v1alpha.AgentRegistry.SearchMcpServers
ADMIN_WRITE google.cloud.agentregistry.v1alpha.AgentRegistry.CreateBinding（LRO）
google.cloud.agentregistry.v1alpha.AgentRegistry.CreateService（LRO）
google.cloud.agentregistry.v1alpha.AgentRegistry.DeleteBinding（LRO）
google.cloud.agentregistry.v1alpha.AgentRegistry.DeleteService（LRO）
google.cloud.agentregistry.v1alpha.AgentRegistry.UpdateBinding（LRO）
google.cloud.agentregistry.v1alpha.AgentRegistry.UpdateService（LRO）

API インターフェースの監査ログ

各メソッドで評価される権限と評価方法については、Identity and Access Management のドキュメントで Agent Registry の情報をご覧ください。

google.cloud.agentregistry.v1alpha.AgentRegistry

次の監査ログは、google.cloud.agentregistry.v1alpha.AgentRegistry に属するメソッドに関連付けられています。

CreateBinding

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.CreateBinding
  • 監査ログのタイプ: 管理アクティビティ
  • 権限:
    • agentregistry.bindings.create - ADMIN_WRITE
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: 長時間実行オペレーション
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.CreateBinding"

CreateService

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.CreateService
  • 監査ログのタイプ: 管理アクティビティ
  • 権限:
    • agentregistry.services.create - ADMIN_WRITE
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: 長時間実行オペレーション
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.CreateService"

DeleteBinding

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.DeleteBinding
  • 監査ログのタイプ: 管理アクティビティ
  • 権限:
    • agentregistry.bindings.delete - ADMIN_WRITE
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: 長時間実行オペレーション
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.DeleteBinding"

DeleteService

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.DeleteService
  • 監査ログのタイプ: 管理アクティビティ
  • 権限:
    • agentregistry.services.delete - ADMIN_WRITE
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: 長時間実行オペレーション
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.DeleteService"

FetchAvailableBindings

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.FetchAvailableBindings
  • 監査ログのタイプ: データアクセス
  • 権限:
    • agentregistry.bindings.fetchAvailable - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.FetchAvailableBindings"

GetAgent

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.GetAgent
  • 監査ログのタイプ: データアクセス
  • 権限:
    • agentregistry.agents.get - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetAgent"

GetBinding

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.GetBinding
  • 監査ログのタイプ: データアクセス
  • 権限:
    • agentregistry.bindings.get - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetBinding"

GetEndpoint

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.GetEndpoint
  • 監査ログのタイプ: データアクセス
  • 権限:
    • agentregistry.endpoints.get - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetEndpoint"

GetMcpServer

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.GetMcpServer
  • 監査ログのタイプ: データアクセス
  • 権限:
    • agentregistry.mcpServers.get - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetMcpServer"

GetService

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.GetService
  • 監査ログのタイプ: データアクセス
  • 権限:
    • agentregistry.services.get - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetService"

ListAgents

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.ListAgents
  • 監査ログのタイプ: データアクセス
  • 権限:
    • agentregistry.agents.list - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListAgents"

ListBindings

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.ListBindings
  • 監査ログのタイプ: データアクセス
  • 権限:
    • agentregistry.bindings.list - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListBindings"

ListEndpoints

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.ListEndpoints
  • 監査ログのタイプ: データアクセス
  • 権限:
    • agentregistry.endpoints.list - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListEndpoints"

ListMcpServers

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.ListMcpServers
  • 監査ログのタイプ: データアクセス
  • 権限:
    • agentregistry.mcpServers.list - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListMcpServers"

ListServices

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.ListServices
  • 監査ログのタイプ: データアクセス
  • 権限:
    • agentregistry.services.list - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListServices"

SearchMcpServers

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.SearchMcpServers
  • 監査ログのタイプ: データアクセス
  • 権限:
    • agentregistry.mcpServers.search - ADMIN_READ
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: どちらでもない。
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.SearchMcpServers"

UpdateBinding

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.UpdateBinding
  • 監査ログのタイプ: 管理アクティビティ
  • 権限:
    • agentregistry.bindings.update - ADMIN_WRITE
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: 長時間実行オペレーション
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.UpdateBinding"

UpdateService

  • メソッド: google.cloud.agentregistry.v1alpha.AgentRegistry.UpdateService
  • 監査ログのタイプ: 管理アクティビティ
  • 権限:
    • agentregistry.services.update - ADMIN_WRITE
  • メソッドが長時間実行オペレーションまたはストリーミング オペレーションのどちらであるか: 長時間実行オペレーション
  • このメソッドのフィルタ: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.UpdateService"

監査ログを生成しないメソッド

メソッドが監査ログを生成しない理由としては、次のいずれかが考えられます。

  • ログを大量に生成し、かなりのストレージ費用が発生するメソッドである。
  • 監査価値が低い。
  • 別の監査ログまたはプラットフォーム ログでメソッド カバレッジがすでに提供されている。

次のメソッドは監査ログを生成しません。

  • google.cloud.agentregistry.v1alpha.AgentRegistry.SearchAgents
  • google.cloud.location.Locations.GetLocation
  • google.cloud.location.Locations.ListLocations
  • google.longrunning.Operations.CancelOperation
  • google.longrunning.Operations.DeleteOperation
  • google.longrunning.Operations.GetOperation
  • google.longrunning.Operations.ListOperations
  • google.longrunning.Operations.WaitOperation