Uitzonde ringen voor Event Hubs berichten-.NET (verouderd)

In deze sectie vindt u de .NET-uitzonde ringen die worden gegenereerd door .NET Framework-Api's.

Belangrijk

Enkele van de uitzonde ringen die in het artikel worden vermeld, zijn alleen van toepassing op verouderde Event Hubs .NET-bibliotheek. Bijvoorbeeld: micro soft. ServiceBus. * uitzonde ringen.

Voor informatie over de EventHubsException die wordt gegenereerd door de nieuwe .NET-bibliotheek, Zie EventHubsException-.net

Uitzonderings Categorieën

De Event Hubs .NET-Api's genereren uitzonde ringen die kunnen vallen in de volgende categorieën, samen met de bijbehorende actie die u kunt uitvoeren om ze te herstellen:

Uitzonderings typen

De volgende tabel bevat een lijst met uitzonderings typen van berichten, en de oorzaken ervan, en de aanbevolen actie voor notities die u kunt uitvoeren.

Uitzonderings type Beschrijving/oorzaak/voor beelden Aanbevolen actie Opmerking over automatische/directe nieuwe poging
TimeoutException De server heeft niet gereageerd op de aangevraagde bewerking binnen de opgegeven tijd, die wordt beheerd door OperationTimeout. De server heeft de aangevraagde bewerking mogelijk voltooid. Deze uitzonde ring kan zich voordoen als gevolg van vertragingen in het netwerk of andere infra structuur. Controleer de systeem status op consistentie en probeer het opnieuw als dat nodig is.
Zie TimeoutException.		 In sommige gevallen kan het nodig zijn om het opnieuw te proberen. Voeg logica voor opnieuw proberen toe aan code.
InvalidOperationException De aangevraagde gebruikers bewerking is niet toegestaan binnen de server of service. Zie het uitzonderings bericht voor meer informatie. Als u bijvoorbeeld volt ooien , wordt deze uitzonde ring gegenereerd als het bericht in de ReceiveAndDelete -modus is ontvangen. Controleer de code en de documentatie. Controleer of de aangevraagde bewerking geldig is. Opnieuw proberen wordt niet geholpen.
OperationCanceledException Er wordt geprobeerd een bewerking aan te roepen voor een object dat al is gesloten, afgebroken of verwijderd. In zeldzame gevallen is de ambient trans actie al verwijderd. Controleer de code en zorg ervoor dat deze geen bewerkingen aanroept op een verwijderd object. Opnieuw proberen wordt niet geholpen.
UnauthorizedAccessException Het token provider -object kan geen token verkrijgen, het token is ongeldig of het token bevat niet de claims die vereist zijn om de bewerking uit te voeren. Zorg ervoor dat de token provider is gemaakt met de juiste waarden. Controleer de configuratie van de Access Control Service. In sommige gevallen kan het nodig zijn om het opnieuw te proberen. Voeg logica voor opnieuw proberen toe aan code.
ArgumentException
ArgumentNullException
ArgumentOutOfRangeException		 Een of meer argumenten die zijn opgegeven voor de methode, zijn ongeldig. De URI die is geleverd aan NamespaceManager of Create bevat een of meer paden. Het URI-schema dat is opgegeven aan NamespaceManager of Create , is ongeldig. De waarde van de eigenschap is groter dan 32 KB. Controleer de aanroepende code en controleer of de argumenten juist zijn. Opnieuw proberen wordt niet geholpen.
Micro soft. ServiceBus. Messa ging MessagingEntityNotFoundException

Micro soft. Azure. Event hubs MessagingEntityNotFoundException		 De entiteit die aan de bewerking is gekoppeld, bestaat niet of is verwijderd. Controleer of de entiteit bestaat. Opnieuw proberen wordt niet geholpen.
MessagingCommunicationException De client kan geen verbinding maken met Event hub. Controleer of de opgegeven hostnaam juist is en of de host bereikbaar is. Opnieuw proberen kan helpen als er onregelmatige verbindings problemen zijn.
Micro soft. ServiceBus. Messa ging ServerBusyException

Micro soft. Azure. Event hubs ServerBusyException		 De aanvraag kan op dit moment niet door de service worden verwerkt. De client kan gedurende een bepaalde tijd wachten en vervolgens de bewerking opnieuw uitvoeren.
Zie ServerBusyException.		 Client kan na een bepaald interval opnieuw proberen. Als een nieuwe poging resulteert in een andere uitzonde ring, controleert u het gedrag voor opnieuw proberen van deze uitzonde ring.
MessagingException Generieke Messa ging-uitzonde ring die kan worden gegenereerd in de volgende gevallen: er wordt geprobeerd een QueueClient te maken met een naam of pad dat tot een ander type entiteit behoort (bijvoorbeeld een onderwerp). Er is een poging gedaan om een bericht te verzenden dat groter is dan 1 MB. Er is een fout opgetreden op de server of service tijdens het verwerken van de aanvraag. Zie het uitzonderings bericht voor meer informatie. Deze uitzonde ring is doorgaans een tijdelijke uitzonde ring. Controleer de code en zorg ervoor dat alleen serialiseerbare objecten worden gebruikt voor de hoofd tekst van het bericht (of een aangepaste serialisatiefunctie te gebruiken). Raadpleeg de documentatie voor de ondersteunde typen waarden van de eigenschappen en gebruik alleen ondersteunde typen. Controleer de eigenschap IsTransient . Als dit het geval is, kunt u de bewerking opnieuw proberen. Het gedrag voor opnieuw proberen is niet gedefinieerd en kan mogelijk niet worden geholpen.
MessagingEntityAlreadyExistsException Poging een entiteit te maken met een naam die al wordt gebruikt door een andere entiteit in die service naam ruimte. Verwijder de bestaande entiteit of kies een andere naam voor de entiteit die u wilt maken. Opnieuw proberen wordt niet geholpen.
QuotaExceededException De bericht entiteit heeft de Maxi maal toegestane grootte bereikt. Deze uitzonde ring kan zich voordoen als het maximum aantal ontvangers (5) al is geopend op een groeps niveau per gebruiker. Maak ruimte in de entiteit door berichten van de entiteit of de bijbehorende subwachtrijen te ontvangen.
Zie QuotaExceededException		 Opnieuw proberen kan helpen als er in de tussen tijd berichten zijn verwijderd.
MessagingEntityDisabledException Aanvraag voor een runtime-bewerking op een uitgeschakelde entiteit. Activeer de entiteit. Opnieuw proberen kan helpen als de entiteit is geactiveerd in de tussentijds.
Micro soft. ServiceBus. Messa ging MessageSizeExceededException

Micro soft. Azure. Event hubs MessageSizeExceededException		 Een bericht lading overschrijdt de limiet van 1 MB. Deze limiet van 1 MB is voor het totale bericht, dat systeem eigenschappen en eventuele .NET-overhead kan bevatten. Verminder de grootte van de bericht lading en voer de bewerking opnieuw uit. Opnieuw proberen wordt niet geholpen.

QuotaExceededException

QuotaExceededException geeft aan dat een quotum voor een bepaalde entiteit is overschreden.

Deze uitzonde ring kan zich voordoen als het maximum aantal ontvangers (5) al is geopend op een groeps niveau per gebruiker.

Event Hubs

Event Hubs heeft een limiet van 20 consumenten groepen per Event hub. Wanneer u probeert meer te maken, ontvangt u een QuotaExceededException.

TimeoutException

Een TimeoutException geeft aan dat een door de gebruiker geïnitieerde bewerking langer duurt dan de time-out van de bewerking.

Voor Event Hubs wordt de time-out opgegeven als onderdeel van de connection string of via ServiceBusConnectionStringBuilder. Het fout bericht zelf kan variëren, maar het bevat altijd de time-outwaarde die voor de huidige bewerking is opgegeven.

Er wordt verwacht dat er time-outs optreden tijdens of tussen onderhouds bewerkingen, zoals Event Hubs service-updates (of) updates van het besturings systeem op resources die de service uitvoeren. Tijdens updates van het besturings systeem worden de entiteiten verplaatst en worden de knoop punten bijgewerkt of opnieuw opgestart. Dit kan leiden tot time-outs. Zie Sla voor Event hubsvoor Service Level Agreement Sla-gegevens voor de Azure Event hubs-service.

Veelvoorkomende oorzaken

Er zijn twee veelvoorkomende oorzaken voor deze fout: onjuiste configuratie of een tijdelijke service fout.

  • Onjuiste configuratie De time-out van de bewerking is mogelijk te klein voor de operationele voor waarde. De standaard waarde voor de time-out van de bewerking in de client-SDK is 60 seconden. Controleer of de waarde is ingesteld op een te klein nummer. De voor waarde van het netwerk en het CPU-gebruik kan van invloed zijn op de tijd die nodig is om een bepaalde bewerking te volt ooien. Daarom moet de time-out van de bewerking niet worden ingesteld op een kleine waarde.
  • Tijdelijke service fout Soms kan de Event Hubs-service vertraging ondervinden bij het verwerken van aanvragen. bijvoorbeeld tijdens peri Oden met veel verkeer. In dergelijke gevallen kunt u de bewerking na een vertraging opnieuw proberen totdat de bewerking is voltooid. Als dezelfde bewerking na meerdere pogingen nog steeds mislukt, gaat u naar de Azure-service status site om te zien of er sprake is van bekende service storingen.

ServerBusyException

Een micro soft. ServiceBus. Messa ging. ServerBusyException of micro soft. Azure. Event hubs. ServerBusyException geeft aan dat een server overbelast is. Er zijn twee relevante fout codes voor deze uitzonde ring.

Fout code 50002

Deze fout kan een van de volgende twee oorzaken hebben:

  • De belasting wordt niet gelijkmatig verdeeld over alle partities op het Event Hub en de ene partitie is afhankelijk van de limiet van de lokale doorvoer eenheid.

    Oplossing: als u de strategie voor partitie distributie wijzigt of als u probeert EventHubClient. send (eventDataWithOutPartitionKey) te gebruiken, kan dit helpen.

  • De Event Hubs naam ruimte heeft onvoldoende doorvoer eenheden (u kunt het scherm metrische gegevens controleren in het venster Event hubs naam ruimte in de Azure Portal om te bevestigen). In de portal wordt een samengevoegde (1 minuut) informatie weer gegeven, maar we meten de door Voer in realtime, zodat het slechts een schatting is.

    Oplossing: het verhogen van de doorvoer eenheden van de naam ruimte kan helpen.

    U kunt doorvoer eenheden configureren op de pagina Scale of overzicht van de pagina Event Hubs naam ruimte in de Azure Portal. U kunt ook automatisch verg Rotengebruiken, dat automatisch wordt geschaald door het aantal doorvoer eenheden te verhogen om te voldoen aan de behoeften van het gebruik.

    Doorvoer eenheden (TUs) zijn van toepassing op alle Event hubs in een Event Hubs naam ruimte. Dit betekent dat u TUs op het niveau van de naam ruimte koopt en dat wordt gedeeld tussen de Event hubs onder die naam ruimte. Elke di geeft de naam ruimte aan de volgende mogelijkheden:

    • Maxi maal 1 MB per seconde aan ingangs gebeurtenissen (gebeurtenissen die worden verzonden naar een Event Hub), maar niet meer dan 1000 ingangs gebeurtenissen, beheer bewerkingen of besturings-API-aanroepen per seconde.
    • Maxi maal 2 MB per seconde voor afwijkings gebeurtenissen (gebeurtenissen die worden verbruikt van een Event Hub), maar niet meer dan 4096 uitwijkings gebeurtenissen.
    • Maxi maal 84 GB gebeurtenis opslag (voldoende voor de standaard Bewaar periode van 24 uur).

    Ga op de pagina overzicht naar de sectie metrische gegevens weer geven en schakel over naar het tabblad door Voer . Selecteer de grafiek om deze te openen in een groter venster met intervallen van 1 minuut op de x-as. Bekijk de piek waarden en deel ze met 60 om binnenkomende bytes/seconde of uitgaande bytes per seconde te verkrijgen. Gebruik een soort gelijke benadering om het aantal aanvragen per seconde op piek tijden te berekenen op het tabblad aanvragen .

    Als u waarden ziet die hoger zijn dan het aantal TUs * limieten (1 MB per seconde voor ingangen of 1000 aanvragen voor binnenkomend/seconde, 2 MB per seconde voor uitgaand verkeer), verg root u het aantal TUs met behulp van de schaal (in de menu balk links van een naam ruimte) om event hubs een hogere waarde hand matig te schalen of om de Event hubs functie voor automatisch Houd er rekening mee dat automatisch verg Roten kan Maxi maal 20 TUS verhogen. Dien een ondersteunings aanvraagin om het te verheffen naar precies 40 TUs.

Fout code 50008

Deze fout moet zelden optreden. Het gebeurt wanneer de container code voor uw naam ruimte op de CPU laag is, niet meer dan een paar seconden voordat de Event Hubs load balancer begint.

Oplossing: Beperk aanroepen naar de methode GetRuntimeInformation. Azure Event Hubs ondersteunt Maxi maal 50 oproepen per seconde per Consumer groep naar de GetRuntimeInfo per seconde. Er wordt een uitzonde ring weer gegeven die vergelijkbaar is met de volgende wanneer de limiet is bereikt:

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.

Volgende stappen

U kunt meer informatie over Event Hubs vinden via de volgende koppelingen: