En esta página, se proporcionan algunas sugerencias comunes para solucionar problemas de suscripciones a Cloud Storage.
Verifica el estado de una suscripción a Cloud Storage
Para verificar el estado de una suscripción, sigue estos pasos:
En la consola de Google Cloud, ve a la página de suscripción a Pub/Sub.
Busca el ícono de Estado para tu suscripción a Cloud Storage.
Si el ícono es una marca de verificación verde, la suscripción está en buen estado.
Si el ícono tiene un signo de exclamación rojo, la suscripción tiene un estado de error.
Haz clic en la suscripción a Cloud Storage.
Se abrirá la página de detalles de la suscripción.
Revisa el Estado de la suscripción para ver el mensaje de error.
Según el mensaje de error, ve a la sección relevante de esta página para solucionar el problema.
Una vez que se resuelve el problema, la suscripción vuelve a un estado correcto.
No se puede crear ni actualizar la suscripción
Estos son algunos de los problemas habituales que puedes encontrar si tienes dificultades para crear o actualizar una suscripción a Cloud Storage.
Error de bucket no encontrado
Si el bucket que especificas en el flujo de trabajo para crear o actualizar suscripciones no existe, el flujo de trabajo mostrará un error bucket not found.
En la consola de Google Cloud, el mensaje es similar al siguiente:
The Cloud Storage bucket specified cannot be found.
A fin de resolver el problema, crea el bucket o actualiza tu suscripción a Cloud Storage para usar un bucket existente.
Error de la cuenta de servicio
Si no configuraste la cuenta de servicio de Pub/Sub con los permisos correctos, el flujo de trabajo para crear o actualizar suscripciones muestra un error. En la consola de Google Cloud, el mensaje es similar al siguiente:
Cloud Pub/Sub did not have the necessary permissions configured to access
the provided bucket my-bucket (or the bucket may not exist).
Please verify that the service account
service-112233445566@gcp-sa-pubsub.iam.gserviceaccount.com
was granted the Storage Legacy Bucket Reader and Storage Object Creator
roles for the provided bucket.
Para resolver el problema, verifica si la cuenta de servicio tiene los permisos correctos.
El estado de la suscripción muestra un signo de exclamación rojo
Si editas el bucket después de crear una suscripción, esto puede afectar la forma en que Pub/Sub escribe mensajes en el bucket. Si un cambio genera un problema, el campo de estado de la suscripción se establece en un estado de error.
En la página de detalles de la suscripción, verifica el estado del campo Subscription state.
El campo Subscription state proporciona un error más específico, que puede ser uno de los siguientes:
No se encontró el bucket: Se borró el bucket. Crea el bucket nuevamente o actualiza la suscripción para usar un bucket existente.
Permiso del bucket denegado: La cuenta de servicio de Pub/Sub ya no tiene permiso para escribir en el bucket. Verifica si la cuenta de servicio tiene los permisos correctos.
Mientras una suscripción a Pub/Sub se encuentra en estado de error, los mensajes no se escriben en el bucket y permanecen en las tareas pendientes de la suscripción. Ten en cuenta que los mensajes no se entregan a un tema de mensajes no entregados adjunto, si está configurado. Los mensajes no confirmados se conservan durante el período establecido en message_retention_duration (7 días de forma predeterminada).
La suscripción procesa los mensajes con mucha lentitud
Algunos parámetros de configuración de la suscripción pueden ralentizar el procesamiento de mensajes.
Por ejemplo, si habilitas el ordenamiento de los mensajes en tu suscripción a Cloud Storage, es posible que los mensajes se escriban en Cloud Storage, pero no se finalicen para retrasar los mensajes posteriores con la misma clave de ordenamiento. Para obtener un mejor rendimiento, considera usar un espectro más amplio de claves de ordenamiento cuando publiques mensajes o inhabilitar la ordenación de mensajes si tu caso de uso no lo requiere.
Configurar un tamaño de archivo máximo demasiado bajo para tu suscripción a Cloud Storage también puede afectar negativamente el rendimiento. Un tamaño de archivo máximo demasiado bajo podría hacer que Pub/Sub cree muchos objetos de Cloud Storage con solo una pequeña cantidad de mensajes en cada objeto. La sobrecarga adicional de crear y finalizar objetos ralentiza el procesamiento de mensajes. Para obtener un mejor rendimiento, considera aumentar la configuración del tamaño máximo del archivo para tu suscripción a Cloud Storage o quitar la restricción de tamaño del archivo.
Limitaciones de cuota
Otra posibilidad es que tu proyecto haya alcanzado su cuota de capacidad de procesamiento push de Pub/Sub (pubsub.googleapis.com/regionalpushsubscriber). Para verificar si te encuentras con limitaciones de cuota, examina la métrica de solicitudes de envío (subscription/push_request_count) en busca de errores resource_exhausted.
Revisa las cuotas de tu proyecto y verifica que tengas suficiente cuota restante. Navega a IAM y administración > Cuotas dentro del proyecto que contiene tu suscripción a Pub/Sub. Busca la cuota pubsub.googleapis.com/regionalpushsubscriber. Si estás alcanzando el límite de cuota, puedes solicitar una cuota más alta.
La suscripción crea más archivos de lo esperado
Para permitir una mejor escalabilidad, tu suscripción a Cloud Storage podría estar controlada por varios backends de Pub/Sub. Cada backend escribe en un archivo de Cloud Storage independiente, por lo que es posible que observes que Cloud Storage crea más archivos de lo esperado, en especial para cargas de trabajo de baja capacidad de procesamiento.
Este es un comportamiento normal. Si quieres reducir la cantidad de archivos que crea la suscripción, puedes aumentar la configuración de lotes de archivos en tu suscripción para permitir archivos más grandes. También puedes procesar posteriormente los archivos si los compones en una cantidad menor de archivos más grandes.
¿Qué sigue?
- Si aún tienes problemas con tu suscripción a Cloud Storage, consulta Obtén asistencia.