Cómo solucionar problemas relacionados con una suscripción de envío
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Los suscriptores de envío son un tipo de suscriptor de Pub/Sub en el que los mensajes se envían de Pub/Sub a un extremo HTTPS especificado por el usuario. El usuario confirma un mensaje enviado de esta manera devolviendo una respuesta HTTP 200 a la solicitud del servidor de notificaciones push. En este documento, se proporcionan algunas sugerencias comunes para solucionar problemas de las suscripciones de Pub/Sub de envío. Obtén más información sobre las suscripciones de envío en la guía del suscriptor de envío.
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 Métricas de Cloud clasifica las respuestas del extremo de envío por response_code y response_class. Las respuestas son útiles para identificar posibles fallas de los extremos. Si esta métrica tiene datos con un response_class que no sea ack, significa que el extremo de envío muestra errores en Pub/Sub. Estos son algunos de los errores más comunes:
Una clase de respuesta deadline_exceeded indica que el extremo de push 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 acuse de recibo de push.
Una clase de respuesta invalid indica que el extremo envió una respuesta que Pub/Sub no pudo entender o procesar correctamente.
Por lo general, una clase de respuesta remote_server_4xx indica problemas de autenticación o permisos. Estos son códigos de respuesta HTTP que muestra el extremo, así que observa 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 de extremos. Verifica que la URL del extremo no tenga errores tipográficos.
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 push 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 push. Las suscripciones push existentes siguen funcionando, pero cuando creas una nueva, ves el error Request is prohibited by organization's policy. Específicamente, 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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[],[],null,["# Troubleshooting a push subscription\n\nPush subscribers are a type of Pub/Sub subscriber where messages are sent from Pub/Sub to a user-specified HTTPS endpoint. The user acknowledges a pushed message by returning an HTTP 200 response to the push server's request. This document provides some common troubleshooting tips for Pub/Sub push subscriptions. Read more about push subscriptions in the [Push subscriber guide](/pubsub/docs/push).\n\nTo effectively monitor your Pub/Sub subscription, it is recommended to first look at the [delivery latency health score](/pubsub/docs/monitoring#delivery_latency_health) ([`subscription/delivery_latency_health_score`](/monitoring/api/metrics_gcp_p_z#pubsub/subscription/delivery_latency_health_score)) to check which factors could be contributing to an unexpected latency.\n\nFailing or slow push endpoints\n------------------------------\n\nIf the endpoint returns an error response code, then the message delivery is considered to have failed and is retried later. This can potentially lead to the endpoint receiving duplicate messages.\n\nThere are multiple metrics that you can use to [monitor push subscriptions](/pubsub/docs/monitoring#monitoring_push_subscriptions). The [`subscription/push_request_count`](/monitoring/api/metrics_gcp_p_z#pubsub/subscription/push_request_count) metric in Cloud Metrics categorizes responses from the push endpoint by `response_code` and `response_class`. The responses are useful for the identification of potential endpoint malfunctions. If this metric has data with a `response_class` other than `ack`, this indicates that the push endpoint is returning errors to Pub/Sub. Some of the most common errors include:\n\n- A `deadline_exceeded` response class indicates that the push endpoint didn't respond within the required acknowledgment (ack) deadline. The [`subscription/push_request_latencies`](/monitoring/api/metrics_gcp_p_z#pubsub/subscription/push_request_latencies) metric helps to track push ack latency.\n\n- An `invalid` response class indicates that the endpoint sent back a response that Pub/Sub couldn't understand or process correctly.\n\n- A `remote_server_4xx` response class usually indicates authentication or permission issues. These are HTTP response codes returned by the endpoint, so look at the scenarios under which this response code is returned. If authentication is enabled, confirm your account has the right permission on the endpoint. Learn more about how [authentication](/pubsub/docs/create-push-subscription#authentication) works in push subscriptions.\n\n- A `remote_server_5xx` response class indicates a server-side problem on the endpoint side. The endpoint is unable to process the request. This might be due to an ongoing maintenance or outage. Review the status of the server hosting the endpoint.\n\n- An `unreachable` response class indicates that the endpoint server cannot be reached at all. Verify the endpoint URL for typos.\n\nLearn more about the most common [error codes](/pubsub/docs/reference/error-codes) of the Pub/Sub API.\n\nRestrictions on push subscriptions inside a VPC-SC perimeter\n------------------------------------------------------------\n\nIf VPC Service Controls (VPC-SC) protection is enabled in a project, there are limitations on creating push subscriptions. Existing push subscriptions continue to work, but when you create a new push subscription, you see the error: `Request is prohibited by organization's policy`. Specifically, new push subscriptions can only be created if the push endpoint is a Cloud Run service using the default `run.app` URL. For more details and specific limitations, see [Pub/Sub documentation](/pubsub/docs/create-push-subscription#vpc-service-control) and [VPC-SC documentation](/vpc-service-controls/docs/supported-products#table_pubsub)."]]
