En esta página, se proporcionan algunas sugerencias comunes para solucionar problemas de las 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 suscripciones de Pub/Sub.
Comprueba el ícono de Estado de 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 es un signo de exclamación rojo, 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.
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 óptimo.
No se puede 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 a Cloud Storage.
Error de bucket no encontrado
Si el bucket que especificas en el flujo de trabajo de creación o actualización de 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.
Para 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, es posible que afecte cómo Pub/Sub escribe mensajes en el bucket. Si un cambio genera un problema, el campo de estado de la suscripción se configura 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 uno 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 esté en estado de error,
los mensajes no se escribirán en el bucket y permanecerán 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 retienen 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 los 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 para retrasar los mensajes posteriores con la misma clave de orden. Para obtener un mejor rendimiento, considera usar un espectro más amplio de claves de orden cuando publiques mensajes o inhabilites el orden de los 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. 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 uno. 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 de archivo máximo para tu suscripción a Cloud Storage o quitar la restricción de tamaño de archivo.
Limitaciones de la cuota
Otra posibilidad es que tu proyecto haya alcanzado su cuota de rendimiento de las solicitudes push de Pub/Sub (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 resource_exhausted.
Revisa las cuotas de tu proyecto y verifica que tengas suficiente cuota disponible. 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 una cuota más alta.
La suscripción crea más archivos de lo esperado
Para permitir una escalabilidad mejorada, es posible que varios backends 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 lo esperado, en especial para cargas de trabajo de baja productividad.
Este es un comportamiento normal. Si deseas 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 postprocesar los archivos compilándolos en una cantidad menor de archivos más grandes.
¿Qué sigue?
- Si los problemas persisten con tu suscripción a Cloud Storage, consulta Cómo obtener asistencia.