Audit-Logging von Agent Registry

In diesem Dokument werden die geprüften Methoden für Agent Registry aufgeführt. Google Cloud Dienste generieren Audit-Logs, in denen Verwaltungs- und Zugriffsaktivitäten in Ihren Google Cloud Ressourcen aufgezeichnet werden. Weitere Informationen zu Cloud-Audit-Logs finden Sie unter den folgenden Links:

• Typen von Audit-Logs
• Struktur von Audit-Logeinträgen
• Audit-Logs speichern und weiterleiten
• Preisübersicht für Cloud Logging
• Audit-Logs zum Datenzugriff aktivieren

Dienstname

So rufen Sie die Audit-Logs für Agent Registry auf:

1. Rufen Sie in der Google Cloud Console die Seite „Log-Explorer“ auf:

   Zum Log-Explorer

2. Kopieren Sie die folgende Abfrage und fügen Sie sie in das Feld Abfrage des Log-Explorers ein. Klicken Sie dann auf Abfrage ausführen.

       protoPayload.serviceName="agentregistry.googleapis.com"
     

Methoden nach Berechtigungstyp

Jede IAM-Berechtigung hat ein type-Attribut, das ein „enum“ ist und einen der folgenden vier Werte haben kann: ADMIN_READ, ADMIN_WRITE, DATA_READ oder DATA_WRITE. Wenn Sie eine Methode aufrufen, generiert Agent Registry ein Audit-Log, dessen Kategorie vom type-Attribut der Berechtigung abhängt, die für die Ausführung der Methode erforderlich ist. Methoden, die eine IAM-Berechtigung mit dem type-Attributwert von DATA_READ, DATA_WRITE oder ADMIN_READ erfordern, generieren Audit-Logs zum Datenzugriff. Methoden, die eine IAM-Berechtigung mit dem type-Attributwert ADMIN_WRITE erfordern, generieren Audit-Logs zur Administratoraktivität.

API-Methoden in der folgenden Liste, die mit (LRO) gekennzeichnet sind, sind Vorgänge mit langer Ausführungszeit. Diese Methoden generieren in der Regel zwei Audit-Log-Einträge: einen beim Starten und einen beim Beenden des Vorgangs. Weitere Informationen finden Sie unter Audit-Logs für Vorgänge mit langer Ausführungszeit.

Berechtigungstyp	Methoden
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-Logs der API-Schnittstelle

Informationen dazu, wie und welche Berechtigungen für die einzelnen Methoden evaluiert werden, finden Sie in der Dokumentation zu Identity and Access Management für Agent Registry.

google.cloud.agentregistry.v1alpha.AgentRegistry

Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.cloud.agentregistry.v1alpha.AgentRegistry gehören.

CreateBinding

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.CreateBinding
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • agentregistry.bindings.create - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Vorgang mit langer Ausführungszeit
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.CreateBinding"
  

CreateService

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.CreateService
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • agentregistry.services.create - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Vorgang mit langer Ausführungszeit
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.CreateService"
  

DeleteBinding

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.DeleteBinding
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • agentregistry.bindings.delete - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Vorgang mit langer Ausführungszeit
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.DeleteBinding"
  

DeleteService

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.DeleteService
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • agentregistry.services.delete - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Vorgang mit langer Ausführungszeit
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.DeleteService"
  

FetchAvailableBindings

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.FetchAvailableBindings
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • agentregistry.bindings.fetchAvailable - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.FetchAvailableBindings"
  

GetAgent

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.GetAgent
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • agentregistry.agents.get - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetAgent"
  

GetBinding

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.GetBinding
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • agentregistry.bindings.get - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetBinding"
  

GetEndpoint

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.GetEndpoint
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • agentregistry.endpoints.get - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetEndpoint"
  

GetMcpServer

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.GetMcpServer
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • agentregistry.mcpServers.get - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetMcpServer"
  

GetService

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.GetService
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • agentregistry.services.get - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.GetService"
  

ListAgents

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.ListAgents
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • agentregistry.agents.list - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListAgents"
  

ListBindings

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.ListBindings
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • agentregistry.bindings.list - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListBindings"
  

ListEndpoints

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.ListEndpoints
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • agentregistry.endpoints.list - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListEndpoints"
  

ListMcpServers

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.ListMcpServers
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • agentregistry.mcpServers.list - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListMcpServers"
  

ListServices

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.ListServices
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • agentregistry.services.list - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.ListServices"
  

SearchMcpServers

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.SearchMcpServers
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • agentregistry.mcpServers.search - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.SearchMcpServers"
  

UpdateBinding

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.UpdateBinding
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • agentregistry.bindings.update - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Vorgang mit langer Ausführungszeit
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.UpdateBinding"
  

UpdateService

• Methode: google.cloud.agentregistry.v1alpha.AgentRegistry.UpdateService
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • agentregistry.services.update - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Vorgang mit langer Ausführungszeit
  
• Filter für diese Methode: protoPayload.methodName="google.cloud.agentregistry.v1alpha.AgentRegistry.UpdateService"
  

Methoden, die keine Audit-Logs generieren

Folgende Gründe können dazu führen, dass eine Methode möglicherweise keine Audit-Logs generiert:

• Es ist eine Methode mit hohem Volumen, die erhebliche Kosten für die Generierung und Speicherung von Logs erzeugt.
• Die Methode hat einen geringen Audit-Wert.
• Die Methode wird bereits von einem anderen Audit- oder Plattformlog abgedeckt.

Die folgenden Methoden generieren keine Audit-Logs:

• 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