Les pipelines de données enregistrent parfois des pics de trafic publié. Les pics de trafic peuvent submerger les abonnés si vous n'y êtes pas préparé. Une solution simple pour éviter les pics de trafic consiste à augmenter dynamiquement les ressources des abonnés Pub/Sub afin de traiter davantage de messages. Toutefois, cette solution peut augmenter les coûts ou ne pas fonctionner instantanément. Par exemple, vous pouvez avoir besoin de nombreuses VM.
Le contrôle de flux côté abonné permet à l'abonné de réguler le débit d'ingestion des messages. Le contrôle du flux gère ainsi les pics de trafic sans augmenter les coûts ni jusqu'à ce que l'abonné soit mis à l'échelle.
Le contrôle du flux est une fonctionnalité disponible dans la bibliothèque cliente de haut niveau Pub/Sub. Vous pouvez également implémenter votre propre programmation de contrôle de flux lorsque vous utilisez une bibliothèque cliente de bas niveau.
La nécessité de contrôler le flux indique que les messages sont publiés plus rapidement qu'ils ne sont consultés. S'il s'agit d'un état persistant plutôt que d'une augmentation transitoire du volume de messages, envisagez d'augmenter le nombre d'instances du client abonné.
Configuration du contrôle de flux
Le contrôle du flux vous permet de configurer le nombre maximal d'octets alloués pour les requêtes en attente et le nombre maximal de messages en attente autorisés. Définissez ces limites en fonction de la capacité de débit de vos machines clientes.
Les valeurs par défaut des variables de contrôle de flux et les noms des variables peuvent varier d'une bibliothèque cliente à l'autre. Par exemple, dans la bibliothèque cliente Java, les variables suivantes configurent le contrôle du flux :
setMaxOutstandingElementCount() : définit le nombre maximal de messages pour lesquels Pub/Sub n'a pas reçu d'accusé de réception ni d'accusé de non-réception.
setMaxOutstandingRequestBytes() : définit la taille maximale des messages pour lesquels Pub/Sub n'a pas reçu d'accusé de réception ni d'accusé de réception négatif.
Si la limite pour setMaxOutstandingElementCount()
ou setMaxOutstandingRequestBytes()
est dépassée, le client abonné ne récupère plus de messages. Ce comportement se poursuit jusqu'à ce que les messages déjà extraits soient confirmés ou refusés.
Nous pouvons ainsi aligner le débit sur le coût associé à l'exécution de plusieurs abonnés.
Exemples de code pour le contrôle du flux
Pour contrôler le débit de réception des messages par le client abonné, utilisez les fonctionnalités de contrôle de flux de l'abonné. Ces fonctionnalités sont illustrées dans les exemples suivants :
C++
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage C++ qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour C++.
C#
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage C# qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour C#.
Go
L'exemple suivant utilise la version majeure de la bibliothèque cliente Go Pub/Sub (v2). Si vous utilisez toujours la bibliothèque v1, consultez le guide de migration vers la v2. Pour consulter la liste des exemples de code de la version 1, consultez les exemples de code obsolètes.
Avant d'essayer cet exemple, suivez les instructions de configuration pour Go du guide de démarrage rapide : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Go.
Java
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Java qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Java.
Node.js
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Node.js qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Node.js.
Node.js
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Node.js qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Node.js.
Python
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Python qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Python.
Ruby
L'exemple suivant utilise la bibliothèque cliente Ruby Pub/Sub v3. Si vous utilisez toujours la bibliothèque v2, consultez le guide de migration vers la v3. Pour afficher la liste des exemples de code Ruby v2, consultez les exemples de code obsolètes.
Avant d'essayer cet exemple, suivez les instructions de configuration pour Ruby du guide de démarrage rapide : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Ruby.
Étapes suivantes
Découvrez les autres options de diffusion que vous pouvez configurer pour un abonnement :
Gérer les échecs de messages avec une règle de réessai d'abonnement
Transférer les messages non distribués vers un sujet de lettres mortes
Rouvrir des messages déjà confirmés ou supprimer définitivement des messages
Prolonger le délai d'accusé de réception avec la gestion des baux
Recevoir et accuser réception des messages exactement une fois
Traiter plus de messages grâce au contrôle de la simultanéité