Audit-Logging für Datastore

In diesem Dokument wird das Audit-Logging für Datastore beschrieben. 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

Hinweise

Wenn Sie die Audit-Protokollierung konfigurieren, werden mit dem Dienstnamen datastore.googleapis.com Protokolle für datastore.googleapis.com- und firestore.googleapis.com-API-Aufrufe konfiguriert.

Die Zeit, die für die Verarbeitung einer DATA_READ- oder DATA_WRITE-Anfrage benötigt wurde, finden Sie im Feld processing_duration des metadata-Objekts eines AuditLog. processing_duration gibt die Zeit an, die die Datenbank für die Verarbeitung einer Anfrage benötigt hat. Sie ist geringer als die Endnutzerlatenz. Insbesondere ist kein Netzwerk-Overhead enthalten.

Dienstname

Für Datastore-Audit-Logs wird der Dienstname datastore.googleapis.com verwendet. Filter für diesen Dienst:

    protoPayload.serviceName="datastore.googleapis.com"
  

Methoden nach Berechtigungstyp

Jede IAM-Berechtigung hat ein type-Attribut, dessen Wert „enum“ ist. Er kann einen der folgenden vier Werte haben: ADMIN_READ, ADMIN_WRITE, DATA_READ oder DATA_WRITE. Wenn Sie eine Methode aufrufen, generiert Datastore ein Audit-Log, dessen Kategorie vom Attribut type der Berechtigung abhängt, die für die Ausführung der Methode erforderlich ist. Methoden, die eine IAM-Berechtigung mit dem type-Attributwert 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 Start und einen beim Ende des Vorgangs. Weitere Informationen finden Sie unter Audit-Logs für Vorgänge mit langer Ausführungszeit.

Berechtigungstyp	Methoden
ADMIN_READ	google.datastore.admin.v1.DatastoreAdmin.GetIndex google.datastore.admin.v1.DatastoreAdmin.ListIndexes google.longrunning.Operations.GetOperation google.longrunning.Operations.ListOperations
ADMIN_WRITE	google.datastore.admin.v1.DatastoreAdmin.CreateIndex (LRO) google.datastore.admin.v1.DatastoreAdmin.DeleteIndex google.datastore.admin.v1.DatastoreAdmin.ExportEntities (LRO) google.datastore.admin.v1.DatastoreAdmin.ImportEntities (LRO) google.datastore.admin.v1beta1.DatastoreAdmin.ExportEntities (LRO) google.datastore.admin.v1beta1.DatastoreAdmin.ImportEntities (LRO) google.longrunning.Operations.CancelOperation google.longrunning.Operations.DeleteOperation
DATA_READ	google.datastore.v1.Datastore.BeginTransaction google.datastore.v1.Datastore.Lookup google.datastore.v1.Datastore.Rollback google.datastore.v1.Datastore.RunAggregationQuery google.datastore.v1.Datastore.RunQuery google.datastore.v1beta3.Datastore.BeginTransaction google.datastore.v1beta3.Datastore.Lookup google.datastore.v1beta3.Datastore.Rollback google.datastore.v1beta3.Datastore.RunAggregationQuery google.datastore.v1beta3.Datastore.RunQuery
DATA_WRITE	google.datastore.v1.Datastore.AllocateIds google.datastore.v1.Datastore.Commit google.datastore.v1.Datastore.ReserveIds google.datastore.v1beta3.Datastore.AllocateIds google.datastore.v1beta3.Datastore.Commit google.datastore.v1beta3.Datastore.ReserveIds

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 Datastore.

google.datastore.admin.v1.DatastoreAdmin

Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.datastore.admin.v1.DatastoreAdmin gehören.

CreateIndex

• Methode: google.datastore.admin.v1.DatastoreAdmin.CreateIndex
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • datastore.indexes.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.datastore.admin.v1.DatastoreAdmin.CreateIndex"
  

DeleteIndex

• Methode: google.datastore.admin.v1.DatastoreAdmin.DeleteIndex
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • datastore.indexes.delete - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.admin.v1.DatastoreAdmin.DeleteIndex"
  

ExportEntities

• Methode: google.datastore.admin.v1.DatastoreAdmin.ExportEntities
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • datastore.databases.export - 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.datastore.admin.v1.DatastoreAdmin.ExportEntities"
  

GetIndex

• Methode: google.datastore.admin.v1.DatastoreAdmin.GetIndex
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.indexes.get - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.admin.v1.DatastoreAdmin.GetIndex"
  

ImportEntities

• Methode: google.datastore.admin.v1.DatastoreAdmin.ImportEntities
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • datastore.databases.import - 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.datastore.admin.v1.DatastoreAdmin.ImportEntities"
  

ListIndexes

• Methode: google.datastore.admin.v1.DatastoreAdmin.ListIndexes
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.indexes.list - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.admin.v1.DatastoreAdmin.ListIndexes"
  

google.datastore.admin.v1beta1.DatastoreAdmin

Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.datastore.admin.v1beta1.DatastoreAdmin gehören.

ExportEntities

• Methode: google.datastore.admin.v1beta1.DatastoreAdmin.ExportEntities
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • datastore.databases.export - 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.datastore.admin.v1beta1.DatastoreAdmin.ExportEntities"
  

ImportEntities

• Methode: google.datastore.admin.v1beta1.DatastoreAdmin.ImportEntities
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • datastore.databases.import - 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.datastore.admin.v1beta1.DatastoreAdmin.ImportEntities"
  

google.datastore.v1.Datastore

Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.datastore.v1.Datastore gehören.

AllocateIds

• Methode: google.datastore.v1.Datastore.AllocateIds
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.entities.allocateIds - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1.Datastore.AllocateIds"
  

BeginTransaction

• Methode: google.datastore.v1.Datastore.BeginTransaction
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.databases.get - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1.Datastore.BeginTransaction"
  

Commit

• Methode: google.datastore.v1.Datastore.Commit
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.databases.get - DATA_READ
  • datastore.entities.create - DATA_WRITE
  • datastore.entities.delete - DATA_WRITE
  • datastore.entities.update - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1.Datastore.Commit"
  

Lookup

• Methode: google.datastore.v1.Datastore.Lookup
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.entities.get - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1.Datastore.Lookup"
  

ReserveIds

• Methode: google.datastore.v1.Datastore.ReserveIds
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.entities.allocateIds - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1.Datastore.ReserveIds"
  

Rollback

• Methode: google.datastore.v1.Datastore.Rollback
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.databases.get - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1.Datastore.Rollback"
  

RunAggregationQuery

• Methode: google.datastore.v1.Datastore.RunAggregationQuery
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.entities.get - DATA_READ
  • datastore.entities.list - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1.Datastore.RunAggregationQuery"
  

RunQuery

• Methode: google.datastore.v1.Datastore.RunQuery
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.entities.get - DATA_READ
  • datastore.entities.list - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1.Datastore.RunQuery"
  

google.datastore.v1beta3.Datastore

Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.datastore.v1beta3.Datastore gehören.

AllocateIds

• Methode: google.datastore.v1beta3.Datastore.AllocateIds
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.entities.allocateIds - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1beta3.Datastore.AllocateIds"
  

BeginTransaction

• Methode: google.datastore.v1beta3.Datastore.BeginTransaction
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.databases.get - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1beta3.Datastore.BeginTransaction"
  

Commit

• Methode: google.datastore.v1beta3.Datastore.Commit
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.entities.create - DATA_WRITE
  • datastore.entities.delete - DATA_WRITE
  • datastore.entities.update - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1beta3.Datastore.Commit"
  

Lookup

• Methode: google.datastore.v1beta3.Datastore.Lookup
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.entities.get - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1beta3.Datastore.Lookup"
  

ReserveIds

• Methode: google.datastore.v1beta3.Datastore.ReserveIds
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.entities.allocateIds - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1beta3.Datastore.ReserveIds"
  

Rollback

• Methode: google.datastore.v1beta3.Datastore.Rollback
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.databases.get - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1beta3.Datastore.Rollback"
  

RunAggregationQuery

• Methode: google.datastore.v1beta3.Datastore.RunAggregationQuery
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.entities.get - DATA_READ
  • datastore.entities.list - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1beta3.Datastore.RunAggregationQuery"
  

RunQuery

• Methode: google.datastore.v1beta3.Datastore.RunQuery
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.entities.get - DATA_READ
  • datastore.entities.list - DATA_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1beta3.Datastore.RunQuery"
  

google.longrunning.Operations

Die folgenden Audit-Logs sind Methoden zugeordnet, die zu google.longrunning.Operations gehören.

CancelOperation

• Methode: google.longrunning.Operations.CancelOperation
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • datastore.operations.cancel - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.longrunning.Operations.CancelOperation"
  

DeleteOperation

• Methode: google.longrunning.Operations.DeleteOperation
  
• Audit-Logtyp: Administratoraktivität
  
• Berechtigungen:
  • datastore.operations.delete - ADMIN_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.longrunning.Operations.DeleteOperation"
  

GetOperation

• Methode: google.longrunning.Operations.GetOperation
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.operations.get - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.longrunning.Operations.GetOperation"
  

ListOperations

• Methode: google.longrunning.Operations.ListOperations
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.operations.list - ADMIN_READ
• Methode ist ein Vorgang mit langer Ausführungszeit oder ein Streamingvorgang: Nein.
  
• Filter für diese Methode: protoPayload.methodName="google.longrunning.Operations.ListOperations"
  

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.longrunning.Operations.WaitOperation