En esta página se ofrecen algunos consejos habituales para solucionar problemas con las suscripciones de Cloud Storage.
Consultar el estado de una suscripción a Cloud Storage
Para comprobar el estado de una suscripción, sigue estos pasos:
En la Google Cloud consola, ve a la página de suscripciones de Pub/Sub.
Consulta el icono de Estado de tu suscripción a Cloud Storage.
Si el icono es una marca de verificación verde, significa que la suscripción está en buen estado.
Si el icono es un signo de exclamación rojo, significa que la suscripción está en un estado de error.
Haz clic en la suscripción a Cloud Storage.
Se abrirá la página de detalles de la suscripción.
Consulta el estado de la suscripción para ver el mensaje de error.
En función del mensaje de error, ve a la sección correspondiente de esta página para solucionar el problema.
Una vez que se haya resuelto el problema, la suscripción volverá a estar en buen estado.
No se puede crear ni actualizar la suscripción
Estos son algunos de los problemas habituales que puedes tener si no consigues crear o actualizar una suscripción a Cloud Storage.
Error de segmento no encontrado
Si el segmento que especifiques en el flujo de trabajo de creación o actualización de suscripciones no existe, el flujo de trabajo devolverá un error bucket not found.
En la consola Google Cloud , el mensaje es similar al siguiente:
The Cloud Storage bucket specified cannot be found.
Para resolver el problema, crea el segmento o actualiza tu suscripción a Cloud Storage para usar un segmento que ya tengas.
Error de cuenta de servicio
Si no has configurado la cuenta de servicio de Pub/Sub con los permisos adecuados, el flujo de trabajo de creación o actualización de la suscripción devolverá un error. En la consola 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 solucionar el problema, comprueba 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, puede afectar a la forma en que Pub/Sub escribe mensajes en el bucket. Si un cambio provoca 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, comprueba 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 ha encontrado el segmento: se ha eliminado el segmento. Cree el segmento de nuevo o actualice la suscripción para usar un segmento que ya tenga.
Permiso de segmento denegado: la cuenta de servicio de Pub/Sub ya no tiene permiso para escribir en el segmento. Comprueba si la cuenta de servicio tiene los permisos correctos.
Mientras una suscripción de Pub/Sub esté en estado de error, los mensajes no se escribirán en el segmento y permanecerán en el backlog de la suscripción. Ten en cuenta que los mensajes no se envían a un tema de mensajes fallidos adjunto, si se ha configurado. Los mensajes sin confirmar se conservan durante el periodo establecido en message_retention_duration (7 días de forma predeterminada).
La suscripción procesa los mensajes muy lentamente
Algunos ajustes de suscripción pueden ralentizar el procesamiento de los mensajes.
Por ejemplo, si habilitas la ordenación de mensajes en tu suscripción de 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 ordenación. Para mejorar el rendimiento, considera usar un espectro más amplio de claves de ordenación al publicar mensajes o inhabilitar la ordenación de mensajes si tu caso práctico no lo requiere.
Si el tamaño máximo de archivo de tu suscripción a Cloud Storage es demasiado bajo, también puede afectar negativamente al rendimiento. Si el tamaño máximo de archivo es demasiado pequeño, Pub/Sub podría crear muchos objetos de Cloud Storage con solo un pequeño número de mensajes en cada objeto. La sobrecarga adicional de crear y finalizar objetos ralentiza el procesamiento de mensajes. Para mejorar el rendimiento, puede aumentar el tamaño máximo de archivo de su suscripción a Cloud Storage o eliminar la restricción de tamaño de archivo.
Limitaciones de cuota
Otra posibilidad es que tu proyecto haya alcanzado su cuota de rendimiento de inserción de Pub/Sub (pubsub.googleapis.com/regionalpushsubscriber).
Para comprobar si tienes limitaciones de cuota, examina la métrica de solicitudes de inserción (subscription/push_request_count)
para detectar errores resource_exhausted.
Revisa las cuotas de tu proyecto y comprueba que te queda suficiente. Ve a Gestión de identidades y accesos y administración > Cuotas en el proyecto que contiene tu suscripción a Pub/Sub. Busca la cuota pubsub.googleapis.com/regionalpushsubscriber. Si te estás acercando al límite de cuota, puedes solicitar un ajuste de cuota.
La suscripción crea más archivos de los esperados
Para mejorar la escalabilidad, es posible que tu suscripción a Cloud Storage se gestione mediante varios back-ends de Pub/Sub. Cada backend escribe en un archivo de Cloud Storage independiente, por lo que es posible que Cloud Storage cree más archivos de los esperados, sobre todo en cargas de trabajo de bajo rendimiento.
Es un comportamiento normal. Si quieres reducir el número de archivos creados por la suscripción, puedes aumentar los ajustes de procesamiento por lotes de archivos de tu suscripción para permitir archivos de mayor tamaño. También puedes posprocesar los archivos componiéndolos en un número menor de archivos más grandes.
Siguientes pasos
- Si sigues teniendo problemas con tu suscripción a Cloud Storage, consulta Obtener asistencia.