Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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 wird nach Kontingentfehlern in Regionen und Zonen gesucht.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-04 (UTC)."],[],[],null,["# Troubleshoot pull delivery issues\n\n\u003cbr /\u003e\n\nUse the `gcpdiag` tool to discover and fix potential\ndelivery issues for pull subscriptions.\n\nUse the `gcpdiag` tool\n----------------------\n\n[`gcpdiag`](https://gcpdiag.dev)\nis an open source tool. It is not an officially supported Google Cloud product.\nYou can use the `gcpdiag` tool to help you identify and fix Google Cloud\nproject issues. For more information, see the\n[gcpdiag project on GitHub](https://github.com/GoogleCloudPlatform/gcpdiag/#gcpdiag---diagnostics-for-google-cloud-platform). \nThe `gcpdiag` tool helps you discover Pub/Sub\npull delivery issues by performing the following checks:\n\n- **Quota errors:** Evaluates Logs Explorer logs to check for any quota errors in regions and zones.\n- **Throughput qualification:** Performs checks on the [delivery latency health](/pubsub/docs/monitoring#delivery_latency_health) of a subscription.\n\nFor a list of `gcpdiag` pull delivery evaluation steps, see\n[Potential steps](https://gcpdiag.dev/runbook/diagnostic-trees/pubsub/pull-subscription-delivery/#potential-steps).\n\n### Run the `gcpdiag` command\n\nYou can run the `gcpdiag` command from Google Cloud CLI or within\na [Docker](https://www.docker.com/) container.\n\nGoogle Cloud console\n--------------------\n\n1. Complete and then copy the following command. \n\n gcpdiag runbook pubsub/pull-subscription-delivery \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --parameter subscription_name=\u003cvar translate=\"no\"\u003eSUBSCRIPTION_NAME\u003c/var\u003e\n\n2. Open the Google Cloud console and activate Cloud Shell.\n[Open Cloud console](https://console.cloud.google.com/cloudpubsub/topic/list?cloudshell=true ?cloudshell=true)\n3. Paste the copied command.\n4. Run the `gcpdiag` command, which downloads the `gcpdiag` docker image, and then performs diagnostic checks. If applicable, follow the output instructions to fix failed checks.\n\nDocker\n------\n\nYou can [run `gcpdiag` using a wrapper](https://github.com/GoogleCloudPlatform/gcpdiag?tab=readme-ov-file#installation) that starts `gcpdiag` in a\n[Docker](https://www.docker.com/) container. Docker or\n[Podman](https://podman.io/) must be installed.\n\n1. Copy and run the following command on your local workstation. \n\n ```console\n curl https://gcpdiag.dev/gcpdiag.sh \u003egcpdiag && chmod +x gcpdiag\n ```\n2. Execute the `gcpdiag` command. \n\n ./gcpdiag runbook pubsub/pull-subscription-delivery \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --parameter subscription_name=\u003cvar translate=\"no\"\u003eSUBSCRIPTION_NAME\u003c/var\u003e\n\nView [available parameters](https://gcpdiag.dev/runbook/diagnostic-trees/pubsub/pull-subscription-delivery/#parameters) for this runbook.\n\nReplace the following:\n\n- \u003cvar class=\"readonly\" translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: The ID of the project to evaluate\n- \u003cvar class=\"readonly\" translate=\"no\"\u003eSUBSCRIPTION_NAME\u003c/var\u003e: The name of the subscription to evaluate in your project\n\nUseful flags:\n\n- `--universe-domain`: If applicable, the [Trusted Partner Sovereign Cloud](https://cloud.google.com/blog/products/identity-security/new-sovereign-controls-for-gcp-via-assured-workloads) domain hosting the resource\n- `--parameter` or `-p`: Runbook parameters\n\nFor a list and description of all `gcpdiag` tool flags, see the\n[`gcpdiag` usage instructions](https://github.com/GoogleCloudPlatform/gcpdiag?tab=readme-ov-file#usage).\n\nRead related information\n------------------------\n\n- [Pub/Sub pull subscription common issues](/pubsub/docs/pull-troubleshooting)"]]
