Stay organized with collections
Save and categorize content based on your preferences.
This document provides some common troubleshooting tips for
Cloud Storage import topics.
After you configure the import topic and start ingesting messages, you can
check the relevant Cloud Monitoring metrics to see
if data is ingested. Perform the following steps:
Here is a list of errors that you might encounter:
Error Code
Description
Fix
CLOUD_STORAGE_PERMISSION_DENIED
Error consuming
Cloud Storage data due to permission issues.
Verify that the Pub/Sub service account
has the necessary permissions to access the Cloud Storage
bucket. Ensure the service account has the following permissions:
storage.objects.list: To list the objects in a bucket.
storage.objects.get: To read the objects in a bucket.
storage.buckets.get: To obtain the bucket location
and that the bucket exists.
The specified Cloud Storage bucket cannot be found.
Verify the bucket name for accuracy.
TOO_MANY_OBJECTS
The Cloud Storage bucket has too
many objects, ingestion is paused. Ingestion is resumed after the number
of objects in the bucket is fewer than 50 million.
The limit for the objects is 50 million.
Reduce the number of objects in the bucket or contact
Google Cloud support for assistance.
You can also enable platform logs for a
Cloud Storage import topic. These logs help you troubleshoot issues
when you have issues ingesting objects into Pub/Sub import topics.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Troubleshooting a Cloud Storage import topic\n\nThis document provides some common troubleshooting tips for\nCloud Storage import topics.\n\nAfter you configure the import topic and start ingesting messages, you can\ncheck the relevant Cloud Monitoring metrics to see\nif data is ingested. Perform the following steps:\n\n1. In the console, go to the **Topics** page.\n\n [Go to Topics](https://console.cloud.google.com/cloudpubsub/topic/list)\n2. Click the Cloud Storage import topic that you want to troubleshoot.\n\n3. In the topic details page, click the **Metrics** tab.\n\n4. Check the chart for the metric **Ingestion byte count**.\n\n5. If no data is being ingested, in the topic details page,\n check to see if there is an error and a red exclamation mark for the\n **Topic state** field.\n\n6. You can also check the metric **Ingestion data source state** .\n To do so, in the topic details page, click the **Metrics** tab.\n\n For more information about these metrics, see\n [Metrics to monitor import topics](/pubsub/docs/monitor-topic#metrics-monitor-topic).\n7. Here is a list of errors that you might encounter:\n\nIf there are no errors till this point, check the best practices in\n[Maintain a healthy publisher](/pubsub/docs/monitoring#keeping_publishers_healthy).\n\nYou can also enable [platform logs](/pubsub/docs/platform-logs-pubsub) for a\nCloud Storage import topic. These logs help you troubleshoot issues\nwhen you have issues ingesting objects into Pub/Sub import topics."]]
