Probleme bei der Pull-Zustellung beheben

Mit dem Tool gcpdiag kannst du potenzielle Probleme bei der Auslieferung von Pull-Abos erkennen und beheben.

gcpdiag-Tool verwenden

gcpdiag ist ein Open-Source-Tool. Es ist kein offiziell unterstütztes Google Cloud-Produkt. Mit dem Tool gcpdiag können Sie Probleme mit Google Cloud-Projekten identifizieren und beheben. Weitere Informationen finden Sie im gcpdiag-Projekt auf GitHub.

Mit dem gcpdiag-Tool kannst du Probleme bei der Pub/Sub-Pull-Zustellung erkennen. Dazu führt das Tool die folgenden Prüfungen durch:

  • Kontingentfehler:In den Logs Explorer-Logs werden Kontingentfehler in Regionen und Zonen geprüft.
  • Durchsatzqualifikation:Es werden Prüfungen der Integrität der Zustellungslatenz eines Abos durchgeführt.

Eine Liste der Schritte zur Bewertung der gcpdiag-Pull-Übermittlung findest du unter Mögliche Schritte.

Befehl gcpdiag ausführen

Sie können den Befehl gcpdiag über die Google Cloud CLI oder in einem Docker-Container ausführen.

Google Cloud Console

  1. Führen Sie den folgenden Befehl aus und kopieren Sie ihn. 
    2. gcpdiag runbook pubsub/pull-subscription-delivery \
  --project=PROJECT_ID \
  --parameter subscription_name=SUBSCRIPTION_NAME
  2. Öffnen Sie die Google Cloud Console und aktivieren Sie Cloud Shell.
    3. Cloud Console öffnen
  3. Fügen Sie den kopierten Befehl ein.
  4. Führen Sie den Befehl gcpdiag aus, um das Docker-Image gcpdiag herunterzuladen und dann Diagnoseprüfungen durchzuführen. Folgen Sie gegebenenfalls der Anleitung für die Ausgabe, um fehlgeschlagene Prüfungen zu beheben.

Docker

Sie können gcpdiag mit einem Wrapper ausführen, der gcpdiag in einem Docker-Container startet. Docker oder Podman muss installiert sein.

  1. Kopieren Sie den folgenden Befehl und führen Sie ihn auf Ihrer lokalen Workstation aus.
    curl https://gcpdiag.dev/gcpdiag.sh >gcpdiag && chmod +x gcpdiag
  2. Führen Sie den Befehl gcpdiag aus. 
    ./gcpdiag runbook pubsub/pull-subscription-delivery \
  --project=PROJECT_ID \
  --parameter subscription_name=SUBSCRIPTION_NAME

Verfügbare Parameter für dieses Runbook ansehen

Ersetzen Sie Folgendes:

    • PROJECT_ID: Die ID des zu bewertenden Projekts
    • SUBSCRIPTION_NAME: Der Name des Abos, das in Ihrem Projekt ausgewertet werden soll

Nützliche Flags:

Eine Liste und Beschreibung aller gcpdiag-Tool-Flags finden Sie in der gcpdiag-Nutzungsanleitung.