Audit-Logging für Datastore

In diesem Dokument wird das Audit-Logging für Datastore beschrieben. Google Cloud-Dienste generieren Audit-Logs, die Verwaltungs- und Zugriffsaktivitäten in Ihren Google Cloud-Ressourcen aufzeichnen. Weitere Informationen zu Cloud-Audit-Logs finden Sie hier:

• Arten 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 Protokollierung konfigurieren, werden mit dem Dienstnamen datastore.googleapis.com Protokolle sowohl für datastore.googleapis.com- als auch für 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 im metadata-Objekt einer AuditLog. processing_duration gibt an, wie lange die Datenbank für die tatsächliche Verarbeitung einer Anfrage benötigt hat. Dieser Wert ist kleiner als die Latenz des Endnutzers. Insbesondere ist darin kein Netzwerkoverhead enthalten.

Dienstname

Für Datastore-Audit-Logs wird der Dienstname datastore.googleapis.com verwendet. Nach diesem Dienst filtern:

    protoPayload.serviceName="datastore.googleapis.com"
  

Methoden nach Berechtigungstyp

Jede IAM-Berechtigung hat ein type-Attribut, dessen Wert ein Enum ist, der einen der folgenden vier Werte haben kann: 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.

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 google.datastore.admin.v1.DatastoreAdmin.DeleteIndex google.datastore.admin.v1.DatastoreAdmin.ExportEntities google.datastore.admin.v1.DatastoreAdmin.ImportEntities google.datastore.admin.v1beta1.DatastoreAdmin.ExportEntities google.datastore.admin.v1beta1.DatastoreAdmin.ImportEntities 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 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 Streamingvorgang: Vorgang mit langer Ausführungszeit
  
• 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 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 Streamingvorgang: Nr.
  
• 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 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 Streamingvorgang: Nr.
  
• 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 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 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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.databases.get - DATA_READ
  • datastore.entities.allocateIds - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• Filter für diese Methode: protoPayload.methodName="google.datastore.v1beta3.Datastore.Lookup"
  

ReserveIds

• Methode: google.datastore.v1beta3.Datastore.ReserveIds
  
• Audit-Logtyp: Datenzugriff
  
• Berechtigungen:
  • datastore.databases.get - DATA_READ
  • datastore.entities.allocateIds - DATA_WRITE
• Methode ist ein Vorgang mit langer Ausführungszeit oder Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• 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 Streamingvorgang: Nr.
  
• Filter für diese Methode: protoPayload.methodName="google.longrunning.Operations.ListOperations"
  

Methoden, die keine Audit-Logs generieren

Eine Methode kann aus folgenden Gründen keine Audit-Logs erstellen:

• Dies ist eine Methode mit hohem Volumen, die erhebliche Loggenerierungs- und Speicherkosten mit sich bringt.
• Sie hat einen geringen Prüfwert.
• Ein anderes Audit- oder Plattformlog bietet bereits eine Methodenabdeckung.

Die folgenden Methoden generieren keine Audit-Logs:

• google.longrunning.Operations.WaitOperation