Auf dieser Seite finden Sie einige allgemeine Tipps zur Fehlerbehebung bei Cloud Storage-Abos.
Status eines Cloud Storage-Abos prüfen
So prüfen Sie den Status eines Abos:
Rufen Sie in der Google Cloud Console die Pub/Sub-Aboseite auf.
Überprüfen Sie das Symbol für Status Ihres Cloud Storage-Abos.
Wenn das Symbol ein grünes Häkchen ist, ist das Abo fehlerfrei.
Wenn das Symbol ein rotes Ausrufezeichen ist, wird für das Abo ein Fehler angezeigt.
Klicken Sie auf das Cloud Storage-Abo.
Die Seite mit den Abodetails wird geöffnet.
Suchen Sie im Abostatus nach der Fehlermeldung.
Informationen zur Fehlerbehebung finden Sie je nach Fehlermeldung im entsprechenden Abschnitt auf dieser Seite.
Nachdem das Problem behoben wurde, kehrt das Abo schließlich wieder in einen fehlerfreien Zustand zurück.
Abo kann nicht erstellt oder aktualisiert werden
Dies sind einige der häufigsten Probleme, die auftreten können, wenn Sie Probleme beim Erstellen oder Aktualisieren eines Cloud Storage-Abos haben.
Fehler: Bucket nicht gefunden
Wenn der Bucket, den Sie im Workflow zum Erstellen oder Aktualisieren von Abos angeben, nicht vorhanden ist, gibt der Workflow den Fehler bucket not found zurück.
In der Google Cloud Console sieht die Meldung in etwa so aus:
The Cloud Storage bucket specified cannot be found.
Erstellen Sie den Bucket oder aktualisieren Sie Ihr Cloud Storage-Abo, um das Problem zu beheben.
Dienstkontofehler
Wenn Sie das Pub/Sub-Dienstkonto nicht mit den richtigen Berechtigungen konfiguriert haben, gibt der Workflow zum Erstellen oder Aktualisieren von Abos einen Fehler zurück. In der Google Cloud Console sieht die Meldung in etwa so aus:
Cloud Pub/Sub did not have the necessary permissions configured to access
the provided bucket my-bucket (or the bucket may not exist).
Please verify that the service account
service-112233445566@gcp-sa-pubsub.iam.gserviceaccount.com
was granted the Storage Legacy Bucket Reader and Storage Object Creator
roles for the provided bucket.
Prüfen Sie, ob das Dienstkonto die richtigen Berechtigungen hat, um das Problem zu beheben.
Der Abostatus zeigt ein rotes Ausrufezeichen
Wenn Sie den Bucket nach dem Erstellen eines Abos bearbeiten, kann sich dies darauf auswirken, wie Pub/Sub Nachrichten in den Bucket schreibt. Wenn eine Änderung zu einem Problem führt, wird das Statusfeld des Abos auf einen Fehlerstatus gesetzt.
Prüfen Sie auf der Seite mit den Abodetails den Status des Felds Subscription state.
Das Feld Subscription state enthält einen spezifischeren Fehler, z. B. einen der folgenden:
Bucket nicht gefunden: Der Bucket wurde gelöscht. Erstellen Sie den Bucket noch einmal oder aktualisieren Sie das Abo, um einen vorhandenen Bucket zu verwenden.
Bucket-Berechtigung verweigert: Das Pub/Sub-Dienstkonto hat keine Berechtigung mehr zum Schreiben in den Bucket. Prüfen Sie, ob das Dienstkonto die richtigen Berechtigungen hat.
Solange ein Pub/Sub-Abo den Fehlerstatus hat, werden Nachrichten nicht in den Bucket geschrieben und verbleiben im Rückstand des Abos. Beachten Sie, dass Nachrichten nicht an ein angehängtes Thema für unzustellbare Nachrichten zugestellt werden, sofern dies konfiguriert ist. Nicht bestätigte Nachrichten werden für den in message_retention_duration festgelegten Zeitraum aufbewahrt (standardmäßig 7 Tage).
Das Abo verarbeitet Nachrichten nur sehr langsam
Einige Aboeinstellungen können die Nachrichtenverarbeitung verlangsamen.
Wenn Sie beispielsweise die Nachrichtenreihenfolge in Ihrem Cloud Storage-Abo aktivieren, kann es passieren, dass Nachrichten zwar in Cloud Storage geschrieben, aber nicht abgeschlossen werden, um nachfolgende Nachrichten mit demselben Sortierungsschlüssel zu verzögern. Um die Leistung zu verbessern, sollten Sie beim Veröffentlichen von Nachrichten ein breiteres Spektrum an Sortierschlüsseln verwenden oder die Nachrichtenreihenfolge deaktivieren, wenn dies in Ihrem Anwendungsfall nicht erforderlich ist.
Eine zu niedrige maximale Dateigröße für Ihr Cloud Storage-Abo kann sich auch negativ auf die Leistung auswirken. Eine zu niedrige maximale Dateigröße kann dazu führen, dass Pub/Sub viele Cloud Storage-Objekte mit nur einer kleinen Anzahl von Nachrichten in jedem Objekt erstellt. Der zusätzliche Aufwand für das Erstellen und Abschließen von Objekten verlangsamt die Nachrichtenverarbeitung. Sie können eine bessere Leistung erzielen, wenn Sie die Einstellung für die maximale Dateigröße für Ihr Cloud Storage-Abo erhöhen oder die Dateigrößenbeschränkung aufheben.
Kontingentbeschränkungen
Eine weitere Möglichkeit besteht darin, dass Ihr Projekt das Pub/Sub-Push-Durchsatzkontingent (pubsub.googleapis.com/regionalpushsubscriber) erreicht hat. Prüfen Sie den Messwert für Push-Anfragen (subscription/push_request_count) auf resource_exhausted-Fehler, um zu prüfen, ob Kontingentbeschränkungen auftreten.
Überprüfen Sie die Kontingente Ihres Projekts und ob noch genügend Kontingente vorhanden sind. Rufen Sie in dem Projekt, das Ihr Pub/Sub-Abo enthält, IAM und Verwaltung > Kontingente auf. Suchen Sie nach dem Kontingent pubsub.googleapis.com/regionalpushsubscriber. Wenn Sie das Kontingentlimit erreichen, können Sie ein höheres Kontingent anfordern.
Durch das Abo werden mehr Dateien als erwartet erstellt
Für eine bessere Skalierbarkeit kann Ihr Cloud Storage-Abo von mehreren Pub/Sub-Back-Ends verarbeitet werden. Jedes Back-End schreibt in eine separate Cloud Storage-Datei. Daher kann es vorkommen, dass Cloud Storage mehr Dateien als erwartet erstellt, insbesondere bei Arbeitslasten mit niedrigem Durchsatz.
Das ist ganz normal. Wenn Sie die Anzahl der vom Abo erstellten Dateien reduzieren möchten, können Sie die Einstellungen für die Datei-Batchverarbeitung in Ihrem Abo erhöhen, um größere Dateien zu ermöglichen. Sie können die Dateien auch nachbearbeiten, indem Sie sie in einer kleineren Anzahl größerer Dateien zusammenstellen.
Nächste Schritte
- Falls weiterhin Probleme mit Ihrem Cloud Storage-Abo auftreten, lesen Sie den Artikel Support anfordern.