Agent Registry 稽核記錄

本文列出 Agent Registry 的稽核方法。 Google Cloud 服務會產生稽核記錄，用以記錄 Google Cloud 資源中的管理和存取活動。如要進一步瞭解 Cloud 稽核記錄，請參閱以下內容：

服務名稱

如要查看代理程式登錄稽核記錄，請執行下列操作：

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

    前往 Logs Explorer

  2. 複製下列查詢並貼到「Logs Explorer」的「Query」欄位，然後點選「Run query」。

        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，則會產生管理員活動稽核記錄。

下表列出的 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