Exceptions de messagerie Event Hubs : .NET (hérité)

  • Article

Cette section liste les exceptions .NET générées par les API .NET Framework.

Important

Certaines des exceptions énumérées dans l’article s’appliquent uniquement à l’ancienne bibliothèque .NET Event Hubs. Par exemple : les exceptions Microsoft.ServiceBus.*.

Pour plus d’informations sur l’exception EventHubsException déclenchée par la nouvelle bibliothèque .NET, consultez EventHubsException : .NET.

Le 30 septembre 2026, nous retirerons les bibliothèques WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus et com.microsoft.azure.servicebus du kit de développement logiciel (SDK) Azure Service Bus, qui ne sont pas conformes aux directives du kit de développement logiciel (SDK) Azure. Nous mettrons également fin à la prise en charge du protocole SBMP. Vous ne pourrez donc plus utiliser ce protocole après le 30 septembre 2026. Migrez vers les dernières bibliothèques du kit de développement logiciel (SDK) Azure, qui offre des correctifs de sécurité critiques et des fonctionnalités améliorées, avant cette date.

Bien que les anciennes bibliothèques puissent toujours être utilisées au-delà du 30 septembre 2026, elles ne seront plus prises en charge officiellement et mises à jour par Microsoft. Pour plus d’informations, consultez l’annonce concernant l’arrêt de la prise en charge.

Catégories d'exceptions

Les API .NET Event Hubs génèrent des exceptions qui peuvent être classées dans les catégories suivantes, accompagnées de l’action associée que vous pouvez mettre en place pour les résoudre :

Types d'exceptions

Le tableau suivant répertorie les types d'exceptions de la messagerie, leurs causes et les propositions d'actions que vous pouvez effectuer.

Type d'exception Description/Cause/Exemples Action suggérée Remarques sur la nouvelle tentative automatique/immédiate
TimeoutException Le serveur n’a pas répondu à l’opération demandée dans le délai spécifié, qui est contrôlé par le paramètre OperationTimeout. Le serveur peut avoir terminé l'opération demandée. Cette exception peut être levée à cause des délais observés sur le réseau ou une autre infrastructure. Vérifiez la cohérence de l'état du système et réessayez si nécessaire.
Consultez TimeoutException.		 Dans certains cas, l'exécution d'une nouvelle tentative peut aider ; ajouter une logique de nouvelle tentative au code.
InvalidOperationException L’opération utilisateur demandée n’est pas autorisée sur le serveur ou le service. Consultez le message de l'exception pour obtenir plus d'informations. Par exemple, le paramètre Complete génère cette exception si le message a été reçu en mode ReceiveAndDelete . Vérifiez le code et consultez la documentation. Assurez-vous que l'opération demandée est valide. Une nouvelle tentative est inutile.
OperationCanceledException Une tentative est effectuée pour appeler une opération sur un objet qui a déjà été fermé, abandonné ou supprimé. Dans de rares cas, la transaction ambiante est déjà supprimée. Vérifiez le code et veillez à ce qu’il n’appelle pas d’opérations sur un objet supprimé. Une nouvelle tentative est inutile.
UnauthorizedAccessException L’objet TokenProvider n’a pas pu obtenir de jeton, le jeton n’est pas valide ou le jeton ne contient pas les revendications nécessaires pour exécuter l’opération. Assurez-vous que le fournisseur de jetons est créé avec les valeurs correctes. Vérifiez la configuration du service ACS (Access Control Service). Dans certains cas, l'exécution d'une nouvelle tentative peut aider ; ajouter une logique de nouvelle tentative au code.
ArgumentException
ArgumentNullException
ArgumentOutOfRangeException		 Un ou plusieurs des arguments fournis à la méthode ne sont pas valides. L’URI fourni à NamespaceManager ou Ceate contient un ou plusieurs segments de chemin d’accès. Le schéma d’URI fourni à NamespaceManager ou Ceate n’est pas valide. La valeur de la propriété est supérieure à 32 ko. Vérifiez le code appelant et assurez-vous que les arguments sont corrects. Une nouvelle tentative ne sera pas bénéfique.
Microsoft.ServiceBus.Messaging MessagingEntityNotFoundException

Microsoft.Azure.EventHubs MessagingEntityNotFoundException		 L'entité associée à l'opération n'existe pas ou a été supprimée. Assurez-vous que l'entité existe. Une nouvelle tentative ne sera pas bénéfique.
MessagingCommunicationException Le client ne parvient pas à établir une connexion à Event Hubs. Assurez-vous que le nom d'hôte fourni est correct et que l'hôte est accessible. Une nouvelle tentative peut aider en cas de problèmes de connectivité intermittents.
Microsoft.ServiceBus.Messaging ServerBusyException

Microsoft.Azure.EventHubs ServerBusyException		 Le service n'est pas en mesure de traiter la demande pour l'instant. Le client peut attendre pendant une période de temps, puis recommencer l'opération.
Consultez ServerBusyException.		 Le client peut réessayer après un certain temps. Si une nouvelle tentative provoque une exception différente, vérifiez le comportement de nouvelle tentative de cette exception.
MessagingException Exception de messagerie générique qui peut être levée dans les cas suivants : une tentative est effectuée pour créer un QueueClient à l’aide d’un nom ou d’un chemin d’accès qui appartient à un autre type d’entité (par exemple, une rubrique). Une tentative est effectuée pour envoyer un message de taille supérieure à 1 Mo. Le serveur ou le service a rencontré une erreur lors du traitement de la demande. Consultez le message de l'exception pour obtenir plus d'informations. Cette exception est généralement temporaire. Vérifiez le code et assurez-vous que seuls les objets sérialisables sont utilisés dans le corps du message (ou utilisez un sérialiseur personnalisé). Consultez la documentation pour connaître les types de valeurs des propriétés pris en charge et utilisez uniquement les types pris en charge. Vérifiez la propriété IsTransient . Si sa valeur est true, vous pouvez réessayer d’effectuer l’opération. Le comportement de la nouvelle tentative n'est pas défini et peut ne pas être utile.
MessagingEntityAlreadyExistsException Tentative de création d'une entité dont le nom est déjà utilisé par une autre entité de l'espace de noms de ce service. Supprimez l'entité existante ou choisissez un autre nom pour l'entité à créer. Une nouvelle tentative ne sera pas bénéfique.
QuotaExceededException L'entité de messagerie a atteint sa taille maximale autorisée. Cette exception peut être levée si le nombre maximal de destinataires (c’est-à-dire 5) a déjà été ouvert sur un niveau de regroupement par consommateur. Créez de l’espace dans l’entité en recevant des messages à partir de l’entité ou de ses files d’attente secondaires.
Consultez QuotaExceededException.		 Une nouvelle tentative peut aider si des messages ont été supprimés entre-temps.
MessagingEntityDisabledException Demande d'une opération d'exécution sur une entité désactivée. Activez l'entité. Une nouvelle tentative peut aider si l'entité a été activée entre-temps.
Microsoft.ServiceBus.Messaging MessageSizeExceededException

Microsoft.Azure.EventHubs MessageSizeExceededException		 Une charge utile de message dépasse la limite de 1 Mo. Cette limite de 1 Mo correspond à l’intégralité du message, qui peut inclure des propriétés système et une surcharge .NET. Réduisez la taille de la charge utile de message, puis recommencez l'opération. Une nouvelle tentative ne sera pas bénéfique.

QuotaExceededException

QuotaExceededException indique que le quota d’une entité spécifique a été dépassé.

Cette exception peut être levée si le nombre maximal de destinataires (5) a déjà été ouvert sur un niveau de regroupement par consommateur.

Event Hubs

Event Hubs a une limite de 20 groupes de consommateurs par hub d’événements. Lorsque vous essayez d’en créer plus, vous recevez une QuotaExceededException.

TimeoutException

Une TimeoutException indique qu’une opération lancée par l’utilisateur dépasse le délai d’expiration de l’opération.

Pour Event Hubs, le délai d'attente est spécifié au sein de la chaîne de connexion ou par ServiceBusConnectionStringBuilder. Le message d'erreur peut varier, mais il contient toujours la valeur du délai d'attente spécifiée pour l'opération en cours.

Des expirations de délai sont à prévoir pendant ou entre les opérations de maintenance telles que les mises à jour de service Event Hubs (ou) les mises à jour de système d’exploitation sur les ressources qui exécutent le service. Pendant les mises à jour du système d’exploitation, les entités sont déplacées et les nœuds sont mis à jour ou redémarrés, ce qui peut entraîner des expirations de délai. Pour plus d’informations sur les contrats de niveau de service (SLA) pour le service Azure Event Hubs, consultez les SLA pour Event Hubs.

Causes courantes

Il existe deux causes communes pour cette erreur : une configuration incorrecte ou une erreur de service temporaire.

  • Configuration incorrecte Le délai d’expiration de l’opération est peut-être trop court pour un bon fonctionnement. La valeur par défaut du délai d'expiration de l'opération dans le Kit de développement logiciel (SDK) client est de 60 secondes. Vérifiez si votre code définit une valeur trop petite. Selon la condition du réseau et l’utilisation du processeur, la réalisation d’une opération peut prendre plus ou moins de temps. Le délai d’expiration de l’opération ne doit donc pas être défini à une valeur trop basse.
  • Erreur de service temporaire Parfois, le service Event Hubs peut rencontrer des retards de traitement des requêtes, par exemple pendant les périodes de trafic élevé. Dans ce cas, vous pouvez réessayer l'opération après un certain délai, jusqu'à ce que l'opération réussisse. Si la même opération échoue encore après plusieurs tentatives, consultez le Site d’état des services Azure pour voir s’il existe des interruptions de service connues.

ServerBusyException

Une exception Microsoft.ServiceBus.Messaging.ServerBusyException ou Microsoft.Azure.EventHubs.ServerBusyException indique qu’un serveur est surchargé. Il existe deux codes d’erreur pertinents pour cette exception.

Code d’erreur 50002

Cette erreur peut se produire pour deux raisons :

  • La charge n’est pas répartie de manière égale entre toutes les partitions du hub d’événements et une partition atteint la limite d’unité de débit locale.

    Résolution : Passez en revue la stratégie de distribution de partition ou essayez EventHubClient.Send(eventDataWithOutPartitionKey).

  • L’espace de noms Event Hubs n’a pas suffisamment d’unités de débit (pour le vérifier, consultez l’écran Métriques dans la fenêtre de l’espace de noms Event Hubs du portail Azure). Le portail affiche des informations agrégées (1 minute), mais nous mesurons le débit en temps réel. Cette valeur n’est donc qu’une estimation.

    Résolution : Augmentez les unités de débit sur l’espace de noms.

    Vous pouvez configurer des unités de débit sur la page Mettre à l’échelle ou la page Vue d’ensemble de votre page Espace de noms Event Hubs dans le Portail Azure. Vous pouvez également utiliser Majoration automatique, qui augmente automatiquement la taille des instances en augmentant le nombre d’unités de débit pour répondre aux besoins d’utilisation.

    Les unités de débit s’appliquent à tous les Event Hubs d’un espace de noms Event Hubs. Cela signifie que vous achetez des unités de débit au niveau de l’espace de noms et que vous les partagez entre les Event Hubs sous cet espace de noms. Chaque TU donne accès à l’espace de noms pour les fonctionnalités suivantes :

    • Jusqu’à 1 Mo par seconde d’événements d’entrée (événements envoyés à un concentrateur d’événements), mais pas plus de 1 000 événements d’entrée, opérations de gestion ou appels d’API de contrôle par seconde.
    • Jusqu’à 2 Mo par seconde d’événements de sortie (événements consommés à partir d’un hub d’événements), mais pas plus de 4 096 événements de sortie.
    • Jusqu’à 84 Go de stockage d’événements (suffisant pour la période de conservation par défaut de 1 heure).

    Sur la page Vue d’ensemble, dans la section Afficher les métriques, accédez à l’onglet Débit. Sélectionnez le graphique pour l’ouvrir dans une fenêtre plus grande avec des intervalles de 1 minute sur l’axe X. Examinez les valeurs de pic et divisez-les par 60 pour obtenir les octets entrants/s ou sortants/s. Utilisez une approche similaire pour calculer le nombre de demandes par seconde aux heures de pointe sous l’onglet Requêtes.

    Si vous constatez une valeur supérieure au nombre limite d’unités * (1 Mo par seconde pour les entrées ou 1 000 requêtes pour les entrées/seconde, 2 Mo par seconde pour la sortie), augmentez le nombre d’unités à l’aide de la page Mettre à l’échelle (dans le menu gauche) d’un espace de noms Event Hubs pour une mise à l’échelle manuelle supérieure ou pour utiliser la fonctionnalité Majoration automatique d’Event Hubs. Vous pouvez effectuer un scale-up jusqu’à 40 UNITÉS lorsque vous mettez à l’échelle manuellement ou automatiquement l’espace de noms.

Code d'erreur 50008

Cette erreur survient rarement. Elle se présente lorsque le conteneur exécutant le code pour votre espace de noms n’a pas suffisamment de ressources d’UC ; pas plus de quelques secondes avant que l’équilibrage de charge des Event Hubs commence.

Résolution : Limiter les appels à la méthode GetRuntimeInformation. Azure Event Hubs prend en charge jusqu'à 50 appels par seconde et par groupe de consommateurs à l'instance GetRuntimeInfo. Une fois la limite atteinte; vous pouvez recevoir une exception semblable à ce qui suit :

ExceptionId: 00000000000-00000-0000-a48a-9c908fbe84f6-ServerBusyException: The request was terminated because the namespace 75248:aaa-default-eventhub-ns-prodb2b is being throttled. Error code : 50008. Please wait 10 seconds and try again.

Étapes suivantes

Vous pouvez en apprendre plus sur Event Hubs en consultant les liens suivants :