En esta página, se proporcionan algunas sugerencias habituales para solucionar problemas relacionados con las suscripciones de Cloud Storage.
Verifica el estado de una suscripción de 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 suscripciones de Pub/Sub.
Verifica el ícono de Estado de tu suscripción de Cloud Storage.
Si el ícono es una marca de verificación verde, la suscripción está en buen estado.
Si el ícono es un signo de exclamación rojo, la suscripción está en estado de error.
Haz clic en la suscripción de Cloud Storage.
Se abrirá la página de detalles de la suscripción.
Verifica el Estado de la suscripción para ver el mensaje de error.
Según el mensaje de error, ve a la sección pertinente 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 pudo crear ni actualizar la suscripción
Estos son algunos de los problemas habituales que podrías tener si tienes dificultades para crear o actualizar una suscripción de Cloud Storage.
Error de bucket no encontrado
Si el bucket que especificas en el flujo de trabajo de creación o actualización de la suscripción no existe, el flujo de trabajo muestra un error bucket not found.
En la Google Cloud consola, el mensaje es similar al siguiente:
The Cloud Storage bucket specified cannot be found.
Para resolver el problema, crea el bucket o actualiza tu suscripción de 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 de creación o actualización de la suscripción devolverá un error. En la Google Cloud consola, 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 de nuevo o actualiza la suscripción para usar un bucket existente.
Se denegó el permiso del bucket: 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 de 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 se configuró. Los mensajes no confirmados se retienen durante el período establecido en message_retention_duration (7 días de forma predeterminada).
El proceso de suscripción es muy lento
Algunos parámetros de configuración de la suscripción pueden ralentizar el procesamiento de mensajes.
Por ejemplo, habilitar el orden de los mensajes en tu suscripción a Cloud Storage puede hacer que los mensajes se escriban en Cloud Storage, pero no se finalicen, lo que retrasa 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 inhabilita el ordenamiento de mensajes si tu caso de uso no lo requiere.
Establecer un tamaño máximo de archivo demasiado bajo para tu suscripción a Cloud Storage también puede afectar negativamente el rendimiento. Si el tamaño máximo del archivo es demasiado bajo, es posible 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 el parámetro de configuración de tamaño máximo de archivo para tu suscripción de Cloud Storage o quitar la restricción de tamaño de archivo.
Limitaciones de cuota
Otra posibilidad es que tu proyecto haya alcanzado su cuota de capacidad de procesamiento de Pub/Sub push (pubsub.googleapis.com/regionalpushsubscriber). Para verificar si tienes limitaciones de cuota, examina la métrica de solicitudes push (subscription/push_request_count) en busca de errores de resource_exhausted.
Revisa las cuotas de tu proyecto y verifica que te quede suficiente cuota. Navega a IAM y administración > Cuotas en el proyecto que contiene tu suscripción a Pub/Sub. Busca la cuota de pubsub.googleapis.com/regionalpushsubscriber. Si estás alcanzando el límite de la cuota, puedes solicitar un ajuste de cuota.
La suscripción crea más archivos de los esperados
Para permitir una mayor escalabilidad, es posible que varios back-ends de Pub/Sub controlen tu suscripción a Cloud Storage. 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 los esperados, en especial para las cargas de trabajo de baja capacidad de procesamiento.
Es normal que eso suceda. Si deseas reducir la cantidad de archivos que crea la suscripción, puedes considerar aumentar la configuración de procesamiento por lotes de archivos en tu suscripción para permitir archivos más grandes. También puedes realizar un procesamiento posterior de los archivos componiéndolos en una cantidad menor de archivos más grandes.
¿Qué sigue?
- Si aún tienes problemas con tu suscripción a Cloud Storage, consulta Cómo obtener asistencia.