Event Hubs meddelande undantag – .NET (bakåtkompatibelt)

I det här avsnittet listas de .NET-undantag som genereras av .NET Framework API: er.

Viktigt

Några av undantagen som anges i artikeln gäller endast äldre Event Hubs .NET-bibliotek. Till exempel: Microsoft. Service Bus. * undantag.

Information om EventHubsException som skapats av det nya .NET-biblioteket finns i EventHubsException-.net

Undantags kategorier

Event Hubs .NET-API: er genererar undantag som kan ingå i följande kategorier, tillsammans med den associerade åtgärden som du kan vidta för att försöka åtgärda dem:

Undantags typer

I följande tabell visas meddelande undantags typer och deras orsaker, samt förslag på åtgärder som du kan vidta.

Undantags typ Beskrivning/orsak/exempel Föreslagen åtgärd Observera vid automatisk/omedelbar återförsök
TimeoutException Servern svarade inte på den begärda åtgärden inom den angivna tiden, vilken styrs av OperationTimeout. Servern kan ha slutfört den begärda åtgärden. Detta undantag kan inträffa på grund av fördröjningar i nätverket eller andra infrastrukturer. Kontrol lera system tillstånd för konsekvens och försök igen om det behövs.
Se TimeoutException.		 Försök kan i vissa fall hjälpa dig. Lägg till logik för omprövning till kod.
InvalidOperationException Den begärda användar åtgärden tillåts inte i servern eller tjänsten. Mer information finns i undantags meddelandet. Till exempel genererar detta undantag om meddelandet togs emot i ReceiveAndDelete -läge. Kontrol lera koden och dokumentationen. Se till att den begärda åtgärden är giltig. Det går inte att göra ett nytt försök.
OperationCanceledException Ett försök gjordes att anropa en åtgärd för ett objekt som redan har stängts, avbrutits eller tagits bort. I sällsynta fall tas den omgivande transaktionen redan bort. Kontrol lera koden och se till att den inte anropar åtgärder på ett borttaget objekt. Det går inte att göra ett nytt försök.
UnauthorizedAccessException TokenProvider -objektet kunde inte hämta en token, token är ogiltig eller så innehåller token inte de anspråk som krävs för att utföra åtgärden. Kontrol lera att token-providern har skapats med rätt värden. Kontrol lera konfigurationen av Access Control Service. Försök kan i vissa fall hjälpa dig. Lägg till logik för omprövning till kod.
ArgumentException
ArgumentNullException
ArgumentOutOfRangeException		 Ett eller flera argument som angavs för metoden är ogiltiga. URI: n som angavs för NamespaceManager eller skapa innehåller Sök vägs segment (n). URI-schemat som angavs för NamespaceManager eller create är ogiltigt. Egenskap svärdet är större än 32 KB. Kontrol lera anrops koden och se till att argumenten är korrekta. Det går inte att göra ett nytt försök.
Microsoft. Service Bus. Messaging MessagingEntityNotFoundException

Microsoft. Azure. EventHubs MessagingEntityNotFoundException		 Entiteten som är kopplad till åtgärden finns inte eller har tagits bort. Kontrol lera att entiteten finns. Det går inte att göra ett nytt försök.
MessagingCommunicationException Klienten kan inte upprätta en anslutning till Event Hub. Kontrol lera att det angivna värd namnet är rätt och att värden kan kontaktas. Försök igen kan vara till hjälp om det finns tillfälliga anslutnings problem.
Microsoft. Service Bus. Messaging ServerBusyException

Microsoft. Azure. EventHubs ServerBusyException		 Tjänsten kan för närvarande inte bearbeta begäran. Klienten kan vänta en stund och sedan försöka igen.
Se ServerBusyException.		 Klienten kan försöka igen efter ett visst intervall. Om ett återförsök resulterar i ett annat undantag, kontrol lera beteendet för återförsök i detta undantag.
MessagingException Allmänt meddelande undantag som kan uppstå i följande fall: ett försök görs att skapa en QueueClient med ett namn eller en sökväg som tillhör en annan entitetstyp (till exempel ett ämne). Ett försök görs att skicka ett meddelande som är större än 1 MB. Ett fel påträffades av servern eller tjänsten under bearbetningen av begäran. Mer information finns i undantags meddelandet. Detta undantag är vanligt vis ett tillfälligt undantag. Kontrol lera koden och se till att endast serialiserbara objekt används för meddelande texten (eller Använd en anpassad serialiserare). Kontrol lera dokumentationen för de värde typer som stöds och Använd endast typer som stöds. Kontrol lera egenskapen IsTransient . Om det är Sant kan du försöka igen. Beteendet för återförsök är odefinierat och kanske inte kan hjälpa dig.
MessagingEntityAlreadyExistsException Försök att skapa en entitet med ett namn som redan används av en annan entitet i tjänstens namnrymd. Ta bort den befintliga entiteten eller Välj ett annat namn för entiteten som ska skapas. Det går inte att göra ett nytt försök.
QuotaExceededException Meddelande enheten har uppnått maximalt tillåten storlek. Detta undantag kan inträffa om det maximala antalet mottagare (som är 5) redan har öppnats på en grupp per konsument nivå. Skapa utrymme i entiteten genom att ta emot meddelanden från entiteten eller dess under köer.
Se QuotaExceededException		 Försök igen kan hjälpa om meddelanden har tagits bort under tiden.
MessagingEntityDisabledException Begäran om körnings åtgärder på en inaktive rad entitet. Aktivera entiteten. Försök igen kan hjälpa om entiteten har Aktiver ATS i Interim.
Microsoft. Service Bus. Messaging MessageSizeExceededException

Microsoft. Azure. EventHubs MessageSizeExceededException		 En meddelande nytto Last överskrider gränsen på 1 MB. Den här gränsen för 1 MB är för det totala meddelandet, som kan innehålla system egenskaper och alla .NET-kostnader. Minska storleken på meddelandets nytto last och försök sedan igen. Det går inte att göra ett nytt försök.

QuotaExceededException

QuotaExceededException anger att en kvot för en specifik enhet har överskridits.

Detta undantag kan inträffa om det maximala antalet mottagare (5) redan har öppnats på en grupp nivå per konsument.

Event Hubs

Event Hubs har en gräns på 20 konsument grupper per Event Hub. När du försöker skapa fler får du en QuotaExceededException.

TimeoutException

En TimeoutException anger att en åtgärd som initierats av användaren tar längre tid än tids gränsen för åtgärden.

För Event Hubs anges tids gränsen antingen som en del av anslutnings strängen eller via ServiceBusConnectionStringBuilder. Själva fel meddelandet kan variera, men det innehåller alltid det timeout-värde som har angetts för den aktuella åtgärden.

Tids gränser förväntas inträffa under eller mellan underhålls åtgärder, till exempel Event Hubs tjänst uppdateringar (eller) operativ system uppdateringar på resurser som kör tjänsten. Vid uppdateringar av operativ systemet flyttas entiteter och noderna uppdateras eller startas om, vilket kan orsaka timeout. Information om service nivå avtal (SLA) för Azure Event Hubs-tjänsten finns i SLA för Event Hubs.

Vanliga orsaker

Det finns två vanliga orsaker till det här felet: felaktig konfiguration eller tillfälligt tjänst fel.

  • Felaktig konfiguration Åtgärdens tids gräns kan vara för liten för drifts villkoret. Standardvärdet för åtgärds tids gränsen i klient-SDK är 60 sekunder. Kontrol lera om din kod har värdet inställt på för litet. Villkoret för nätverket och CPU-användningen kan påverka hur lång tid det tar för en viss åtgärd att slutföras, så tids gränsen för åtgärden bör inte anges till ett litet värde.
  • Tillfälligt tjänst fel Ibland kan Event Hubs tjänsten uppleva fördröjningar i bearbetnings begär Anden. till exempel under perioder med hög trafik. I sådana fall kan du försöka utföra åtgärden igen efter en fördröjning tills åtgärden har slutförts. Om samma åtgärd fortfarande Miss lyckas efter flera försök kan du gå till Azure-tjänstens status webbplats för att se om det finns några kända drift avbrott.

ServerBusyException

En Microsoft. Service Bus. Messaging. ServerBusyException eller Microsoft. Azure. EventHubs. ServerBusyException anger att en server är överbelastad. Det finns två relevanta fel koder för det här undantaget.

Felkod 50002

Felet kan bero på en av följande orsaker:

  • Belastningen fördelas inte jämnt över alla partitioner i händelsehubben, och en partition träffar den lokala begränsningen för data flödet.

    Lösning: att ändra distributions strategin för partitionen eller testa EventHubClient. send (eventDataWithOutPartitionKey) kan hjälpa dig.

  • Event Hubs-namnrymden har inte tillräckligt med data flödes enheter (du kan kontrol lera måtten på skärmen i Event Hubs namn områdes fönstret i Azure Portal för att bekräfta). Portalen visar sammanställd (1 minut) information, men vi mäter data flödet i real tid – så det är bara en uppskattning.

    Lösning: att öka data flödes enheterna i namn området kan hjälpa dig.

    Du kan konfigurera data flödes enheter på sidan skalnings sida eller översikt på sidan Event Hubs namn område i Azure Portal. Du kan också använda Automatiskökning, som automatiskt skalar upp genom att öka antalet data flödes enheter för att möta användnings behoven.

    Data flödes enheter (antal) gäller för alla Event Hub i ett Event Hubs-namnområde. Det innebär att du köper antal på namn områdes nivån och delas mellan händelse hubbarna under denna namnrymd. Varje data flödes enheter bevarar namn området till följande funktioner:

    • Upp till 1 MB ingångs händelser per sekund (händelser som skickats till en händelsehubben), men högst 1000 ingress händelser, hanterings åtgärder eller kontroll-API-anrop per sekund.
    • Upp till 2 MB utgångs händelser per sekund (händelser som konsumeras från en händelsehubben), men högst 4096 utgående händelser.
    • Upp till 84 GB händelse lagring (tillräckligt för standard lagrings perioden på 24 timmar).

    På sidan Översikt i avsnittet Visa mått växlar du till fliken data flöde . Välj diagrammet för att öppna det i ett större fönster med intervall på 1 minut på x-axeln. Titta på de högsta värdena och dela upp dem med 60 för att få inkommande byte/sekund eller utgående byte/sekund. Använd liknande metod för att beräkna antalet begär Anden per sekund vid hög belastnings tider på fliken förfrågningar .

    Om du ser värden som är högre än antalet antal * gränser (1 MB per sekund för ingångs-eller 1000-begäranden för ingångar/sekund, 2 MB per sekund för utgående trafik) ökar du antalet antal genom att använda skalan (på den vänstra menyn) i ett Event Hubs namn område för att skala högre eller använda funktionen för automatisk ökning i Event Hubs. Observera att automatisk ökning bara kan öka upp till 20 antal. Skicka en supportbegäranför att öka den till exakt 40 antal.

Felkod 50008

Det här felet bör sällan uppstå. Det inträffar när behållaren som kör kod för namn området har ont om CPU – inte mer än några sekunder innan den Event Hubs belastningsutjämnaren börjar.

Lösning: begränsa anrop till GetRuntimeInformation-metoden. Azure Event Hubs stöder upp till 50 anrop per sekund per konsument grupp till GetRuntimeInfo per sekund. Du kan få ett undantag som liknar följande när gränsen nås:

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.

Nästa steg

Du kan lära dig mer om Event Hubs genom att gå till följande länkar: