Audit logging di Agent Registry

Questo documento elenca i metodi sottoposti ad audit per Agent Registry.I servizi Google Cloud generano audit log che registrano le attività amministrative e di accesso all'interno delle tue risorse Google Cloud . Per ulteriori informazioni su Cloud Audit Logs, consulta quanto segue:

Nome servizio

Per visualizzare gli audit log di Agent Registry:

  1. Nella console Google Cloud , vai alla pagina Esplora log:

    Vai a Esplora log

  2. Copia e incolla la seguente query nel campo Query di Esplora log, quindi fai clic su Esegui query.

        protoPayload.serviceName="agentregistry.googleapis.com"

Metodi per tipo di autorizzazione

Ogni autorizzazione IAM ha una proprietà type, il cui valore è un enum che può essere uno dei quattro valori: ADMIN_READ, ADMIN_WRITE, DATA_READ o DATA_WRITE. Quando chiami un metodo, Agent Registry genera un audit log la cui categoria dipende dalla proprietà type dell'autorizzazione richiesta per eseguire il metodo. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type corrispondente a DATA_READ, DATA_WRITE o ADMIN_READ generano audit log degli accessi ai dati. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type corrispondente a ADMIN_WRITE generano audit log delle attività di amministrazione.

I metodi API nel seguente elenco contrassegnati con (LRO) sono operazioni a lunga esecuzione (LRO). Questi metodi di solito generano due voci dell'audit log: una all'inizio dell'operazione e un'altra al termine. Per saperne di più, consulta Audit log per le operazioni a lunga esecuzione.
Tipo di autorizzazione Metodi
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)

Audit log dell'interfaccia API

Per informazioni su come e quali autorizzazioni vengono valutate per ogni metodo, consulta la documentazione di Identity and Access Management per Agent Registry.

google.cloud.agentregistry.v1alpha.AgentRegistry

I seguenti audit log sono associati ai metodi appartenenti a google.cloud.agentregistry.v1alpha.AgentRegistry.

CreateBinding

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.CreateBinding
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • agentregistry.bindings.create - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.CreateBinding"

CreateService

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.CreateService
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • agentregistry.services.create - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.CreateService"

DeleteBinding

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.DeleteBinding
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • agentregistry.bindings.delete - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.DeleteBinding"

DeleteService

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.DeleteService
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • agentregistry.services.delete - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.DeleteService"

FetchAvailableBindings

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.FetchAvailableBindings
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • agentregistry.bindings.fetchAvailable - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.FetchAvailableBindings"

GetAgent

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.GetAgent
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • agentregistry.agents.get - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetAgent"

GetBinding

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.GetBinding
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • agentregistry.bindings.get - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetBinding"

GetEndpoint

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.GetEndpoint
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • agentregistry.endpoints.get - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetEndpoint"

GetMcpServer

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.GetMcpServer
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • agentregistry.mcpServers.get - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetMcpServer"

GetService

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.GetService
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • agentregistry.services.get - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetService"

ListAgents

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.ListAgents
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • agentregistry.agents.list - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListAgents"

ListBindings

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.ListBindings
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • agentregistry.bindings.list - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListBindings"

ListEndpoints

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.ListEndpoints
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • agentregistry.endpoints.list - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListEndpoints"

ListMcpServers

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.ListMcpServers
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • agentregistry.mcpServers.list - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListMcpServers"

ListServices

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.ListServices
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • agentregistry.services.list - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListServices"

SearchMcpServers

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.SearchMcpServers
  • Tipo di audit log: accesso ai dati
  • Autorizzazioni:
    • agentregistry.mcpServers.search - ADMIN_READ
  • Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.SearchMcpServers"

UpdateBinding

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.UpdateBinding
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • agentregistry.bindings.update - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.UpdateBinding"

UpdateService

  • Metodo: google.cloud.agentregistry.v1alpha.AgentRegistry.UpdateService
  • Tipo di audit log: attività di amministrazione
  • Autorizzazioni:
    • agentregistry.services.update - ADMIN_WRITE
  • Il metodo è un'operazione a lunga esecuzione o in streaming: Operazione a lunga esecuzione
  • Filtra per questo metodo: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.UpdateService"

Metodi che non generano audit log

Un metodo potrebbe non generare audit log per uno o più dei seguenti motivi:

  • Si tratta di un metodo ad alto volume che comporta costi significativi per la generazione e l'archiviazione dei log.
  • Ha un valore di auditing basso.
  • Un altro audit log o log della piattaforma fornisce già la copertura del metodo.

I seguenti metodi non generano audit log:

  • 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