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:

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

DeleteIndex

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

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

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

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