Agent Registry 审核日志记录

本文档列出了 Agent Registry 的受审核方法。 Google Cloud 服务会生成审核日志，以记录 Google Cloud 资源中的管理和访问活动。如需详细了解 Cloud Audit Logs，请参阅以下内容：

服务名称

如需查看代理注册表审核日志，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 Logs Explorer 页面：

    转到日志浏览器

  2. 将以下查询复制并粘贴到Logs Explorer的查询字段中，然后点击运行查询。

        protoPayload.serviceName="agentregistry.googleapis.com"

方法（按权限类型）

每个 IAM 权限都有一个 type 属性，该属性的值是一个枚举，可以是以下四个值之一：ADMIN_READ、ADMIN_WRITE、DATA_READ 或 DATA_WRITE。当您调用某个方法时，Agent Registry 会生成一个审核日志，其类别取决于执行该方法所需权限的 type 属性。需要 IAM 权限且 type 属性值为 DATA_READ、DATA_WRITE 或 ADMIN_READ 的方法会生成数据访问审核日志。需要 IAM 权限且 type 属性值为 ADMIN_WRITE 的方法会生成管理员活动审核日志。

以下列表中标记为 (LRO) 的 API 方法是长时间运行的操作 (LRO)。 这些方法通常会生成两个审核日志条目：一个在操作开始时生成，另一个在操作结束时生成。如需了解详情，请参阅长时间运行的操作的审核日志。
权限类型 方法
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 接口审核日志

如需了解如何评估每种方法的权限以及评估哪些权限，请参阅 Agent Registry 的 Identity and Access Management 文档。

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