Partage via

Azure Service Bus - Expiration (durée de vie) des messages

  • Article

La charge utile dans un message, ou une commande ou demande transmise par un message à un destinataire, est presque toujours soumise à une forme de délai d’expiration au niveau de l’application. Passé ce délai, le contenu n’est plus remis, ou l’opération demandée n’est plus exécutée.

Dans les environnements de développement et de test où les files d’attente et les rubriques sont souvent utilisées dans le contexte d’exécutions partielles d’applications ou de parties d’application, il est également préférable que les messages de test abandonnés soient automatiquement nettoyés de la mémoire pour permettre à la prochaine série de tests de démarrer le nettoyage.

Notes

Si vous n’êtes pas encore familiarisé avec les concepts de Service Bus, consultez Concepts de Service Bus et Files d’attente, rubriques et abonnements Service Bus.

L’expiration d’un message peut être contrôlé à l’aide de la propriété système time-to-live qui définit une durée relative. Ce délai devient un instant absolu quand le message est mis en file d’attente dans l’entité. À ce moment, la propriété expires-at-utc prend la valeur enqueued-time-utc + time-to-live. Le paramètre time-to-live (TTL) sur un message réparti n’est pas appliqué quand aucun client n’écoute activement.

Une fois l’instant expires-at-utc passé, les messages ne sont plus éligibles pour la récupération. L’expiration n’affecte pas les messages actuellement verrouillés pour la remise. Ces messages sont traités gérés normalement. Si le verrou expire ou si le message est abandonné, le délai d’expiration prend effet immédiatement. Lorsque le message est verrouillé, l’application peut être en possession d’un message qui a expiré. L’application peut alors poursuivre le traitement ou choisir d’abandonner le message. C’est au responsable de l’implémentation d’en décider.

Une durée de vie extrêmement faible de l’ordre de quelques millisecondes ou secondes, peut entraîner l’expiration des messages avant que les applications destinataires les reçoivent. Considérez la TTL la plus élevée qui fonctionne pour votre application.

Notes

Pour les messages planifiés, vous spécifiez l’heure de mise en file d’attente à laquelle vous souhaitez que le message se matérialise dans la file d’attente pour récupération. L’heure à laquelle le message est envoyé à Service Bus est différente de l’heure à laquelle le message est mis en file d’attente. Le délai d’expiration du message dépend de l’heure de mise en file d’attente, et non de l’heure à laquelle le message est envoyé à Service Bus. Par conséquent, expires-at-utc est toujours mis en file d’attente + durée de vie.

Par exemple, si vous définissez sur ScheduledEnqueueTimeUtc 5 minutes à partir de UtcNow, et TimeToLive sur 10 minutes, le message expirera après 5 + 10 = 15 minutes à partir de maintenant. Le message se matérialise dans la file d’attente après 5 minutes et le compteur de 10 minutes commence à partir de là.

Expiration au niveau de l’entité

Tous les messages envoyés vers une file d’attente ou une rubrique sont soumis à un délai d’expiration par défaut qui est défini au niveau de l’entité. Ce délai peut également être défini dans le portail lors de la création, puis ajusté ultérieurement. Le délai d’expiration par défaut est utilisé pour tous les messages envoyés à l’entité où la propriété time-to-live n’est pas définie explicitement. Le délai d’expiration par défaut fait également office de plafond pour la valeur time-to-live. Les messages qui ont un délai d’expiration time-to-live plus long que le délai par défaut sont ajustés silencieusement à la valeur time-to-live de message par défaut avant d’être mis en file attente.

Notes

  • La valeur par défaut de la durée de vie d’un message réparti correspond à la plus grande valeur possible d’un entier signé de 64 bits, sauf indication contraire.
  • Pour les entités de message (files d’attente et rubriques), le délai d’expiration par défaut est également égal à la valeur la plus grande possible d’un entier signé de 64 bits pour les niveaux Standard et Premium de Service Bus. Pour le niveau de base, le délai d’expiration par défaut est de 14 jours (qui est également le délai d’expiration maximal).
  • Si la rubrique spécifie une durée de vie inférieure à celle spécifiée dans l'abonnement, la durée de vie de la rubrique est appliquée.

Les messages expirés peuvent être envoyés vers une file d’attente de lettres mortes. Vous pouvez configurer ce paramètre par programmation ou à l’aide du portail Azure. Si l’option reste désélectionnée, les messages expirés sont supprimés. La distinction entre les messages expirés déplacés vers la file d’attente de lettres mortes et les autres messages de lettres mortes est possible en évaluant la propriété motif de lettres mortes que le répartiteur stocke dans la section des propriétés utilisateur.

Le message n’est pas soumis au délai d’expiration tant qu’il est verrouillé et, si l’indicateur est défini sur l’entité, le message est déplacé dans la file d’attente de lettres mortes aussitôt après l’abandon ou l’expiration du verrou. Toutefois, le message n’est pas déplacé s’il s’agit d’un message réglé, ce qui suppose que l’application a pu le traiter, en dépit du délai d’expiration nominal. Pour plus d’informations sur les verrous et le règlement des messages, consultez Transferts, verrouillages et règlement des messages.

L’utilisation combinée de la propriété time-to-live et du déplacement automatique (et transactionnel) vers la file d’attente de lettres mortes à l’expiration est une solution efficace pour garantir qu’un travail donné à un gestionnaire ou un groupe de gestionnaires avec un délai d’expiration sera bien récupéré pour être traité avant la fin du délai d’expiration.

Prenons l’exemple d’un site web qui doit exécuter des travaux de manière fiable sur un serveur principal avec des contraintes de mise à l’échelle, et qui connaît parfois des pics de trafic ou doit être isolé pendant les périodes de disponibilité de ce serveur principal. En situation normale, le gestionnaire côté serveur envoie (push) les données transmises par l’utilisateur dans une file d’attente et reçoit par la suite une réponse qui confirme le traitement réussi de la transaction dans une file d’attente de réponse. En présence d’un pic de trafic, si le gestionnaire du serveur principal ne peut pas traiter ses éléments de backlog dans le temps imparti, les travaux expirés sont renvoyés dans la file d’attente de lettres mortes. L’utilisateur interactif peut être averti que l’opération demandée va nécessiter un peu plus de temps que d’habitude, et la demande peut ensuite être placée dans une autre file d’attente pour un chemin de traitement où le résultat éventuel du traitement est envoyé à l'utilisateur par e-mail.

Expiration des entités prenant en charge la session

Pour les files d’attente ou les abonnements aux rubriques activés pour la session, les messages sont verrouillés au niveau de la session. Si la durée de vie de l’un des messages expire, tous les messages liés à cette session sont supprimés ou annulés en fonction du paramètre défini pour les lettres mortes à l’expiration de la messagerie de l’entité. En d’autres termes, s’il existe un seul message dans la session qui a passé la durée de vie, tous les messages de la session sont expirés. Les messages expirent uniquement s’il existe un écouteur actif.

Entités temporaires

Des files d’attente, rubriques et abonnements Service Bus peuvent être créés en tant qu’entités temporaires, qui sont automatiquement supprimées quand elles n’ont pas été utilisées pendant une période spécifiée.

Le nettoyage automatique est utile dans les scénarios de développement et de test où les entités sont créées de façon dynamique et ne sont pas nettoyées après leur utilisation, en raison d’une interruption de la série de tests ou d’un débogage. Il est également utile quand une application crée des entités dynamiques, telles qu’une file d’attente de réponse, pour recevoir des réponses dans un processus de serveur web ou dans un autre objet relativement éphémère. En effet, dans ce cas, il est difficile de nettoyer correctement ces entités quand l’instance de l’objet disparaît.

La fonctionnalité est activée à l’aide de la propriété suppression automatique inactive sur l’espace de noms. La propriété est définie sur la durée pendant laquelle une entité peut rester inactive (non utilisée) avant d’être automatiquement supprimée. La valeur minimale de cette propriété est 5 minutes.

Important

Le fait de définir le niveau de verrouillage d’Azure Resource Manager sur CanNotDelete, sur l’espace de noms ou à un niveau supérieur, n’empêche pas la suppression d’entités avec AutoDeleteOnIdle. Si vous ne souhaitez pas que l’entité soit supprimée, définissez la propriété AutoDeleteOnIdle sur DataTime.MaxValue.

Inactivité

Voici ce qui considéré comme inactivité d’entités (files d’attente, rubriques et abonnements) :

Entité Ce qui est considéré comme inactif
File d'attente
  • Aucun envoi
  • Aucune réception
  • Aucune mise à jour de la file d’attente
  • Aucun message planifié
  • Aucun parcours/affichage d’aperçu
Rubrique
  • Aucun envoi
  • Aucune mise à jour de la rubrique
  • Aucun message planifié
  • Aucune opération sur les abonnements de la rubrique (voir la ligne suivante)
Abonnement
  • Aucune réception
  • Aucune mise à jour de l’abonnement
  • Aucune nouvelle règle ajoutée à l’abonnement
  • Aucun parcours/affichage d’aperçu

Important

Si vous avez configuré le transfert automatique sur la file d’attente ou l’abonnement, ce qui équivaut à faire recevoir un récepteur dans la file d’attente ou l’abonnement et ils ne vont pas rester inactifs.

SDK

Étapes suivantes

Pour en savoir plus sur la messagerie Service Bus, consultez les articles suivants :