Cómo solucionar problemas relacionados con una suscripción de envío

Los suscriptores de envío son un tipo de suscriptor de Pub/Sub en el que los mensajes se envían desde Pub/Sub a un extremo HTTPS especificado por el usuario. El usuario reconoce un mensaje enviado mostrando una respuesta HTTP 200 a la solicitud del servidor de envío. En este documento, se proporcionan algunas sugerencias comunes para solucionar problemas de las suscripciones de envío de Pub/Sub. Obtén más información sobre las suscripciones de envío en la guía para suscriptores de envío.

Para supervisar de manera eficaz tu suscripción de Pub/Sub, te recomendamos que primero observes la puntuación de estado de la latencia de entrega (subscription/delivery_latency_health_score) para verificar qué factores podrían contribuir a una latencia inesperada.

Extremos de envío lentos o con errores

Si el extremo muestra un código de respuesta de error, se considera que la entrega del mensaje falló y se vuelve a intentar más tarde. Esto puede provocar que el extremo reciba mensajes duplicados.

Existen varias métricas que puedes usar para supervisar las suscripciones de envío. La métrica subscription/push_request_count en Cloud Metrics categoriza las respuestas del extremo de envío por response_code y response_class. Las respuestas son útiles para identificar posibles fallas en el extremo. Si esta métrica tiene datos con una response_class que no sea ack, indica que el extremo de envío muestra errores en Pub/Sub. Algunos de los errores más comunes incluyen los siguientes:

• Una clase de respuesta deadline_exceeded indica que el extremo de envío no respondió dentro del plazo de confirmación (ack) requerido. La métrica subscription/push_request_latencies ayuda a hacer un seguimiento de la latencia de confirmación de envío.

• Una clase de respuesta invalid indica que el extremo envió una respuesta que Pub/Sub no pudo comprender ni procesar correctamente.

• Una clase de respuesta remote_server_4xx suele indicar problemas de autenticación o permisos. Estos son códigos de respuesta HTTP que muestra el extremo, por lo que debes observar las situaciones en las que se muestra este código de respuesta. Si la autenticación está habilitada, confirma que tu cuenta tenga el permiso correcto en el extremo. Obtén más información sobre cómo funciona la autenticación en las suscripciones de envío.

• Una clase de respuesta remote_server_5xx indica un problema del servidor en el extremo. El extremo no puede procesar la solicitud. Esto puede deberse a un mantenimiento o una interrupción en curso. Revisa el estado del servidor que aloja el extremo.

• Una clase de respuesta unreachable indica que no se puede acceder al servidor del extremo. Verifica que la URL del extremo esté bien escrita.

Obtén más información sobre los códigos de error más comunes de la API de Pub/Sub.

Restricciones en las suscripciones de envío dentro de un perímetro de VPC-SC

Si la protección de los Controles del servicio de VPC (VPC-SC) está habilitada en un proyecto, existen limitaciones para crear suscripciones de envío. Las suscripciones de envío existentes siguen funcionando, pero cuando creas una nueva, ves el error: Request is prohibited by organization's policy. En particular, solo se pueden crear suscripciones de envío nuevas si el extremo de envío es un servicio de Cloud Run que usa la URL run.app predeterminada. Para obtener más detalles y limitaciones específicas, consulta la documentación de Pub/Sub y la documentación de VPC-SC.