Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Gunakan alat gcpdiag untuk menemukan dan memperbaiki potensi masalah pengiriman untuk langganan pull.
Menggunakan alat gcpdiag
gcpdiag
adalah alat open source. Ini bukan produk Google Cloud yang didukung secara resmi.
Anda dapat menggunakan alat gcpdiag untuk membantu mengidentifikasi dan memperbaiki masalah project Google Cloud. Untuk mengetahui informasi selengkapnya, lihat
project gcpdiag di GitHub.
Alat gcpdiag membantu Anda menemukan masalah pengiriman pull Pub/Sub dengan melakukan pemeriksaan berikut:
Error kuota: Mengevaluasi log Logs Explorer untuk memeriksa error kuota di wilayah dan zona.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-03 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)"]]
