Cloud Firestore-Aktivitäten überwachen

Auf dieser Seite wird beschrieben, wie Sie die Cloud Firestore-Nutzung überwachen und potenzielle Probleme in Ihrer App erkennen können.

Nutzungs-Dashboard

In den Nutzungs-Dashboards in der Google Cloud Console und in der Firebase Console können Sie sich Lese-, Schreib- und Löschvorgänge von Dokumenten im Zeitverlauf ansehen.

Zugriffssteuerung

Für die Nutzungs-Dashboards ist die Cloud IAM-Berechtigung monitoring.timeSeries.list erforderlich. Diese Berechtigung ist in den Rollen "Projektinhaber", "Bearbeiter" und "Betrachter" enthalten. Sie können diese Berechtigung auch über eine Cloud Monitoring-Rolle oder eine benutzerdefinierte Rolle gewähren.

Dashboard zur Datenbanknutzung

Wenn Sie Nutzungsmesswerte für eine Cloud Firestore-Datenbank aufrufen möchten, öffnen Sie in der Google Cloud Console die Seite Nutzung der Datenbank.

  1. Rufen Sie in der Google Cloud Console die Seite Datenbanken auf.

    Zur Seite „Datenbanken“

  2. Wählen Sie die benötigte Datenbank aus der Liste der Datenbanken aus.

  3. Klicken Sie im Navigationsmenü auf Nutzung.

  4. Klicken Sie auf den Link in der Nachricht auf der Seite, um Ihre Datenbanknutzung aufzurufen.

    Das <span class=Dashboard zur Cloud Firestore-Datenbanknutzung in der Google Cloud Console."/>

Dashboard für die zusammengefasste Nutzung

Wenn Ihr Projekt mehrere Cloud Firestore-Datenbanken hat, können Sie zusammengefasste Nutzungsmesswerte in der Google Cloud Console oder in der Firebase-Konsole aufrufen.

Google Cloud Console

Rufen Sie in der Google Cloud Console die Seite Projektnutzung auf.

Google Cloud-Projektnutzung aufrufen

Das Dashboard zur Projektnutzung zeigt die Dokumentvorgänge im Zeitverlauf so an:

Das <span class=Dashboard zur Cloud Firestore-Nutzung in der Google Cloud Console."/>

Firebase-Konsole

Zur Seite zur Cloud Firestore-Nutzung (Firebase Console)

Das <span class=Dashboard zur Cloud Firestore-Nutzung in der Firebase Console."/>

Nutzungs-Dashboard und Abrechnungsberichte

Die Cloud Firestore-Nutzungsdashboards in der Firebase Console und der Cloud Console liefern eine Schätzung der Nutzung. Sie helfen Ihnen, Nutzungsspitzen zu erkennen. Das Dashboard bietet jedoch keine genaue Ansicht der abgerechneten Vorgänge. Die abgerechnete Nutzung ist wahrscheinlich höher. In allen Fällen einer Abweichung hat der Abrechnungsbericht Vorrang vor dem Nutzungs-Dashboard.

Folgende Vorgänge können Abweichungen zwischen dem Nutzungs-Dashboard und der abgerechneten Nutzung bedingen:

  • Import- und Exportvorgänge: Lese- und Schreibvorgänge, die von diesen Vorgängen ausgeführt werden, werden nicht im Nutzungs-Dashboard angezeigt.
  • Managementfreie Schreibvorgänge, die nur zur Bestätigung dienen. Schreibvorgänge, bei denen nur geprüft wird, ob ein Dokument vorhanden ist oder nicht, werden zu den in Rechnung gestellten Lesevorgängen gezählt. Im Dashboard für die Schreibnutzung werden sie jedoch als „UPDATE_NOOP“ bzw. „DELETE_NOOP“ angezeigt.
  • Managementfreie Schreibvorgänge. Vorgänge, die nicht zu einer Änderung der Datenbank führen, z. B. eine Aktualisierung, die keine Feldwerte oder einen Schreibvorgang in ein gelöschtes Dokument ändert, werden im Dashboard zur Nutzung möglicherweise als „UPDATE_NOOP“ oder „DELETE_NOOP“ angezeigt. Auch wenn sie als „NOOP“ angezeigt werden, tragen sie zu den abgerechneten Vorgängen bei.
  • Minimierte Schreibvorgänge. Wenn mehrere Schreibvorgänge in dasselbe Dokument schnell hintereinander sind, kann das Nutzungs-Dashboard mehrere Schreibvorgänge zusammenfassen und als einer zählen. Bei der Abrechnungsnutzung wird jeder Schreibvorgang trotzdem separat gezählt.

    Das Nutzungs-Dashboard minimiert auch Schreibvorgänge für Feldtransformationen wie Server-Zeitstempel, numerische Inkremente und Array-Union-Vorgänge. Bei Feldtransformationen kann das Nutzungs-Dashboard mehrere Vorgänge als einen Vorgang zählen.

  • Abfragen, die keine Ergebnisse zurückgeben Für Abfragen ohne Ergebnisse fallen Kosten für einen Lesevorgang an. Diese Nutzung wird in Rechnung gestellt, aber nicht im Nutzungs-Dashboard angezeigt.
  • Lesevorgänge aus Indexeinträge gelesen Diese Nutzung wird in Rechnung gestellt, aber nicht im Nutzungs-Dashboard angezeigt. Bei Aggregationsabfragen werden beispielsweise Indexeinträge in Rechnung gestellt, diese Nutzung wird jedoch nicht im Nutzungs-Dashboard angezeigt.

Im Dashboard zur Datennutzung für Löschvorgänge werden keine automatischen Ablaufvorgänge erfasst, die durch Richtlinien zur Gültigkeitsdauer (Time-to-Live, TTL) ausgeführt werden. Weitere Informationen finden Sie in den TTL-Messwerten unter Cloud Monitoring.

Sicherheitsregeln anwenden

Die Firebase Console enthält auch ein Dashboard zur Evaluierung von Sicherheitsregeln. Dieses bietet eine hilfreiche Übersicht über Regelaufrufe. Sie können dieses Dashboard durch eine detaillierte Analyse in Cloud Monitoring ergänzen.

Zu den Regeln

<span class=Dashboard zum Monitoring von Cloud Firestore-Regeln in der Firebase Console."/>

Cloud Monitoring Messwerte

Cloud Monitoring erfasst Messwerte, Ereignisse und Metadaten aus Google Cloud-Produkten. Diese Messwertdaten sind auch im Nutzungs-Dashboard der Cloud Firestore Console aufgeführt. Mit Cloud Monitoring können Sie benutzerdefinierte Dashboards und Nutzungsbenachrichtigungen einrichten.

Cloud Monitoring enthält die folgenden Cloud Firestore-Messwerte:

Name des Messwerts Beschreibung
Lesevorgänge für das Dokument

Die Anzahl der erfolgreichen Dokumentlesevorgänge. Sie können diesen Messwert nach Art des Lesevorgangs aufschlüsseln: LOOKUP oder QUERY.

Dieser Messwert enthält keine Lesevorgänge aus verwalteten Export- oder Bulk-Löschvorgängen.

Schreibvorgänge für das Dokument

Die Anzahl der erfolgreichen Dokumentschreibvorgänge. Sie können den Messwert nach der Art des Schreibvorgangs aufschlüsseln: CREATE oder UPDATE.

Dieser Messwert enthält keine Schreibvorgänge aus verwalteten Importvorgängen.

Löschvorgänge für das Dokument Die Anzahl der erfolgreichen Dokumentlöschvorgänge.
Aktive Verbindungen

Die Anzahl der aktiven Verbindungen zu Ihrer Datenbank.

Jedes aktive mobile und Web-SDK hält eine einzelne Verbindung, die für mehrere Snapshot-Listener freigegeben werden kann. Die Server-Client-Bibliotheken erstellen eine Verbindung pro Snapshot-Listener.

Snapshot-Listener

Die Anzahl der Snapshot-Listener für alle aktiven Verbindungen.

Anzahl der Löschungen aufgrund der Gültigkeitsdauer

Gesamtzahl der Dokumente, die gemäß Richtlinien zur Gültigkeitsdauer (TTL) gelöscht wurden.

Verzögerungen zwischen Ablauf der Gültigkeitsdauer und dem Löschen

Zeitspanne zwischen dem Ablauf eines Dokuments gemäß einer Richtlinie zur Gültigkeitsdauer (TTL) und dem tatsächlichen Löschen.

Nutzung bei Echtzeit-Update

Mithilfe der Messwerte für aktive Verbindungen und Snapshot-Listener können Sie die Nutzung von Echtzeit-Updates messen.

Angenommen, ein Nutzer öffnet Ihre App auf seinem Smartphone. Die App stellt dann eine Verbindung zu Cloud Firestore her und abonniert zehn Abfragen. Dadurch werden Ihre Messwerte um 1 aktive Verbindung und 10 Snapshot-Listener erhöht.

Abtastrate

Die Cloud Firestore-Messwerte werden jede Minute erfasst. Es kann jedoch bis zu vier Minuten dauern, bis Updates in Ihren Dashboards angezeigt werden.

Latenzmesswerte

Messwerte zur Backend-Latenz sind über gängige Google Cloud Firestore-Messwerte verfügbar.

In der Metrics Explorer-Ansicht der Cloud Console finden Sie beispielsweise ein Diagramm der p50-Latenz.

Cloud Monitoring-Dashboard einrichten

Informationen zum Aufrufen eines vordefinierten Dashboards oder zum Einrichten eines Dashboards finden Sie unter Monitoring-Dashboard verwenden.

Nächste Schritte