Los errores de publicación suelen deberse a cuellos de botella del lado del cliente, como CPUs de servicio insuficientes, un estado incorrecto de los hilos o congestión de la red. La política de reintentos del editor define el número de veces que Pub/Sub intenta entregar un mensaje y el tiempo que transcurre entre cada intento.
En este documento se proporciona información sobre cómo usar las solicitudes de reintento con mensajes publicados en un tema.
Antes de empezar
Antes de configurar el flujo de trabajo de publicación, asegúrate de que has completado las siguientes tareas:
- Consulta información sobre los temas y el flujo de trabajo de publicación.
- Crea un tema.
Roles obligatorios
Para obtener los permisos que necesitas para volver a intentar enviar solicitudes de mensajes a un tema, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Editor de Pub/Sub (roles/pubsub.publisher
) en el tema.
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.
También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.
Necesitas permisos adicionales para crear o actualizar temas y suscripciones.
Acerca de las solicitudes de reintento
La configuración de reintentos controla cómo reintentan las bibliotecas de cliente de Pub/Sub las solicitudes de publicación. Las bibliotecas de cliente tienen alguno de los siguientes ajustes de reintento:
- Tiempo de espera de la solicitud inicial: el tiempo que transcurre antes de que una biblioteca de cliente deje de esperar a que se complete la solicitud de publicación inicial.
- Retraso de reintento: el tiempo que espera una biblioteca de cliente después de que se agote el tiempo de espera de una solicitud para volver a intentarla.
- Tiempo de espera total: tiempo transcurrido después de que una biblioteca de cliente deje de reintentar las solicitudes de publicación.
Para reintentar las solicitudes de publicación, el tiempo de espera inicial debe ser inferior al tiempo de espera total. Por ejemplo, si usas un tiempo de espera exponencial, las bibliotecas cliente calculan el tiempo de espera de la solicitud y el retraso de reintento de la siguiente manera:
- Después de cada solicitud de publicación, el tiempo de espera de la solicitud aumenta en función del multiplicador del tiempo de espera de la solicitud hasta alcanzar el tiempo de espera máximo de la solicitud.
- Después de cada reintento, el tiempo de espera aumenta en función del multiplicador de tiempo de espera, hasta alcanzar el tiempo de espera máximo.
Volver a intentar enviar una solicitud de mensaje
Durante el proceso de publicación, es posible que se produzcan errores de publicación transitorios o permanentes. En el caso de los errores transitorios, normalmente no es necesario que hagas nada, ya que Pub/Sub vuelve a intentar enviar los mensajes automáticamente.
También puede producirse un error cuando una operación de publicación se realiza correctamente, pero el cliente del editor no recibe la respuesta de publicación a tiempo. En este caso, también se vuelve a intentar la operación de publicación. Por lo tanto, puede tener dos mensajes idénticos con IDs de mensaje diferentes.
En caso de que se produzcan errores persistentes, considera la posibilidad de implementar las acciones adecuadas fuera del proceso de publicación para evitar sobrecargar Pub/Sub.
Los errores de publicación se vuelven a intentar automáticamente, excepto los que no justifican que se vuelva a intentar. Este código de muestra muestra cómo crear un editor con ajustes de reintento personalizados (ten en cuenta que no todas las bibliotecas de cliente admiten ajustes de reintento personalizados; consulta la documentación de referencia de la API para el lenguaje que hayas elegido):
C++
Antes de probar este ejemplo, sigue las instrucciones de configuración de C++ que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de C++ de Pub/Sub.
C#
Antes de probar este ejemplo, sigue las instrucciones de configuración de C# que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de C# de Pub/Sub.
Go
En el siguiente ejemplo se usa la versión principal de la biblioteca de cliente de Pub/Sub de Go (v2). Si sigues usando la biblioteca v1, consulta la guía de migración a la versión 2. Para ver una lista de ejemplos de código de la versión 1, consulta los ejemplos de código obsoletos.
Antes de probar este ejemplo, sigue las instrucciones de configuración de Go que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Go de Pub/Sub.
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración de Java que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de Java de Pub/Sub.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración de Node.js que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de Node.js de Pub/Sub.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración de Node.js que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de Node.js de Pub/Sub.
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración de Python que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de Python de Pub/Sub.
Reintentar solicitudes con claves de ordenación
Supongamos que tiene un solo cliente editor. Estás usando las bibliotecas de cliente de Pub/Sub para publicar los mensajes 1, 2 y 3 con la misma clave de ordenación A. Ahora, supongamos que el cliente del editor no recibe la respuesta publicada del mensaje 1 antes de que caduque el plazo de la llamada a procedimiento remoto. El mensaje 1 debe volver a publicarse. La secuencia de mensajes recibidos por el cliente suscriptor será 1, 1, 2 y 3 si se supone que el mensaje 2 se publica solo después de que el mensaje 1 se haya completado correctamente. Cada mensaje publicado tiene su propio ID de mensaje. Desde el punto de vista del cliente suscriptor, se han publicado cuatro mensajes, y los dos primeros tienen el mismo contenido.
Volver a intentar publicar solicitudes con claves de ordenación también puede ser complicado debido a los ajustes de los lotes. La biblioteca de cliente agrupa los mensajes en lotes para que la publicación sea más eficiente. Siguiendo con el ejemplo anterior, supongamos que los mensajes 1 y 2 se agrupan en un lote. Este lote se envía al servidor como una sola solicitud. Si el servidor no devuelve una respuesta a tiempo, el cliente del editor vuelve a intentar enviar este lote de dos mensajes. Por lo tanto, es posible que el cliente suscriptor reciba los mensajes 1, 2, 1, 2 y 3. Si usas una biblioteca de cliente de Pub/Sub para publicar mensajes en orden y falla una operación de publicación, el servicio falla las operaciones de publicación de todos los mensajes restantes de la misma clave de ordenación. Un cliente editor puede decidir seguir cualquiera de las siguientes operaciones:
Vuelve a publicar todos los mensajes fallidos en orden
Volver a publicar un subconjunto de los mensajes que no se han podido migrar en orden
Publicar un nuevo conjunto de mensajes
Si se produce un error que no se puede volver a intentar, la biblioteca cliente no publica el mensaje y deja de publicar otros mensajes con la misma clave de ordenación. Por ejemplo, cuando un editor envía un mensaje a un tema que no existe, se produce un error no reintentable. Para seguir publicando mensajes con la misma clave de ordenación, llama a un método para reanudar la publicación y, a continuación, vuelve a publicar.
En el siguiente ejemplo se muestra cómo reanudar la publicación de mensajes con la misma clave de ordenación.
C++
Antes de probar este ejemplo, sigue las instrucciones de configuración de C++ que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de C++ de Pub/Sub.
C#
Antes de probar este ejemplo, sigue las instrucciones de configuración de C# que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de C# de Pub/Sub.
Go
En el siguiente ejemplo se usa la versión principal de la biblioteca de cliente de Pub/Sub de Go (v2). Si sigues usando la biblioteca v1, consulta la guía de migración a la versión 2. Para ver una lista de ejemplos de código de la versión 1, consulta los ejemplos de código obsoletos.
Antes de probar este ejemplo, sigue las instrucciones de configuración de Go que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Go de Pub/Sub.
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración de Java que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de Java de Pub/Sub.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración de Node.js que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de Node.js de Pub/Sub.
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración de Python que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de Python de Pub/Sub.
Ruby
En el siguiente ejemplo se usa la biblioteca de cliente de Ruby Pub/Sub v3. Si sigues usando la biblioteca v2, consulta la guía de migración a la versión 3. Para ver una lista de ejemplos de código de Ruby v2, consulta los ejemplos de código obsoletos.
Antes de probar este ejemplo, sigue las instrucciones de configuración de Ruby que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de Ruby de Pub/Sub.
Siguientes pasos
Para saber cómo configurar las opciones de publicación avanzadas, consulta lo siguiente: