Mit dem Tool gcpdiag können Sie potenzielle Probleme bei der Zustellung 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 können Sie Probleme bei der Pub/Sub-Pull-Zustellung ermitteln. Dazu werden die folgenden Prüfungen durchgeführt:
- Kontingentfehler:Untersucht Logs Explorer-Logs auf Kontingentfehler in Regionen und Zonen.
- Durchsatzqualifizierung:Führt Prüfungen der Integrität der Zustellungslatenz eines Abos durch.
Eine Liste der gcpdiag-Pull-Zustellungsschritte finden Sie 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
- Führen Sie den folgenden Befehl aus und kopieren Sie ihn.
- Öffnen Sie die Google Cloud Console und aktivieren Sie Cloud Shell. Cloud Console öffnen
- Fügen Sie den kopierten Befehl ein.
- Führen Sie den Befehl
gcpdiagaus, um das Docker-Imagegcpdiagherunterzuladen und dann Diagnoseprüfungen durchzuführen. Folgen Sie gegebenenfalls der Anleitung für die Ausgabe, um fehlgeschlagene Prüfungen zu beheben.
gcpdiag runbook pubsub/pull-subscription-delivery \
--project=PROJECT_ID \
--parameter subscription_name=SUBSCRIPTION_NAMEDocker
Sie können
gcpdiag mit einem Wrapper ausführen, der gcpdiag in einem Docker-Container startet. Docker oder Podman muss installiert sein.
- 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
- Führen Sie den Befehl
gcpdiagaus../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 Projekts, das ausgewertet werden soll.
- SUBSCRIPTION_NAME: Der Name des Abos, das in Ihrem Projekt ausgewertet werden soll.
Nützliche Flags:
--universe-domain: Die Domain Trusted Partner Sovereign Cloud, auf der die Ressource gehostet wird--parameteroder-p: Runbook-Parameter
Eine Liste und Beschreibung aller gcpdiag-Tool-Flags finden Sie in der gcpdiag-Nutzungsanleitung.