Problemen met berichtroutering onderzoeken
Deze pagina bevat richtlijnen voor bewaking en probleemoplossing voor veelvoorkomende problemen en oplossing voor ioT Hub-berichtroutering.
Berichtroutering bewaken
We raden u aan om metrische Gegevens van IoT Hub te controleren die betrekking hebben op berichtroutering en eindpunten , zodat u een overzicht krijgt van de verzonden berichten. U kunt ook een diagnostische instelling maken voor het verzenden van bewerkingen voor routes in IoT Hub-resourcelogboeken naar Azure Monitor-logboeken, Event Hubs of Azure Storage voor aangepaste verwerking.
U wordt ook aangeraden de terugvalroute in te schakelen als u berichten wilt onderhouden die niet overeenkomen met de query op een van de routes. Deze berichten kunnen worden bewaard in het ingebouwde eindpunt voor het aantal geconfigureerde bewaardagen.
Belangrijkste problemen
Hier volgen de meest voorkomende problemen met berichtroutering.
- Berichten van mijn apparaten worden niet gerouteerd zoals verwacht
- Ik ben plotseling gestopt met het ontvangen van berichten op het ingebouwde Event Hubs-eindpunt
Berichten van mijn apparaten worden niet gerouteerd zoals verwacht
Als u dit probleem wilt oplossen, analyseert u de volgende gebieden:
De metrische routeringsgegevens voor dit eindpunt
Alle metrische IoT Hub-gegevens met betrekking tot routering worden voorafgegaan door Routering. U kunt informatie uit meerdere metrische gegevens combineren om de hoofdoorzaak voor problemen te identificeren. Gebruik bijvoorbeeld metrische routeringsleveringen om het aantal berichten te identificeren dat aan een eindpunt is bezorgd of verwijderd wanneer ze niet overeenkomen met query's op een van de routes en terugvalroute is uitgeschakeld. Controleer de metrische gegevens voor routeringslatentie om te controleren of de latentie voor berichtbezorging stabiel is of toeneemt. Een groeiende latentie kan duiden op een probleem met een specifiek eindpunt en we raden u aan de status van het eindpunt te controleren. Deze metrische routeringsgegevens hebben ook dimensies die details bevatten over de metrische gegevens, zoals het eindpunttype, een specifieke eindpuntnaam en een reden waarom het bericht niet is bezorgd.
De resourcelogboeken voor operationele problemen
Bekijk de resourcelogboeken voor routes voor meer informatie over de routerings- en eindpuntbewerkingen of identificeer fouten en relevante foutcode om het probleem verder te begrijpen. De bewerkingsnaam RouteEvaluationError in het logboek geeft bijvoorbeeld aan dat de route niet kan worden geëvalueerd vanwege een probleem met de berichtindeling. Gebruik de tips voor de specifieke bewerkingsnamen om het probleem te verhelpen. Wanneer een gebeurtenis wordt geregistreerd als een fout, geeft het logboek ook meer informatie over waarom de evaluatie is mislukt. Als de naam van de bewerking bijvoorbeeld EndpointUnhealthy is, geeft een foutcode van 403004 aan dat het eindpunt onvoldoende ruimte heeft.
De status van het eindpunt
Gebruik de REST API Get Endpoint Health om de status van de eindpunten op te halen. De Get Endpoint Health-API biedt ook:
- informatie over de laatste keer dat een bericht naar het eindpunt is verzonden
- de laatst bekende fout
- de laatst bekende fouttijd en de laatste keer dat er een verzendpoging is uitgevoerd voor dit eindpunt. Gebruik de mogelijke beperking die is opgegeven voor de specifieke laatst bekende fout.
Ik ben plotseling gestopt met het ontvangen van berichten op het ingebouwde eindpunt
Als u dit probleem wilt oplossen, analyseert u de volgende gebieden:
Is er een nieuwe route gemaakt?
Zodra een route is gemaakt, worden gegevens niet meer naar het ingebouwde eindpunt gestroomd, tenzij er een route naar dat eindpunt wordt gemaakt. Om ervoor te zorgen dat berichten blijven stromen naar het ingebouwde eindpunt als er een nieuwe route wordt toegevoegd, configureert u een route naar het eindpunt van de gebeurtenis.
Is de terugvalroute uitgeschakeld?
De terugvalroute verzendt alle berichten die niet voldoen aan een van de queryvoorwaarden op een van de bestaande routes naar de ingebouwde Event Hubs (berichten en gebeurtenissen), die compatibel zijn met Event Hubs. Als berichtroutering is ingeschakeld, kunt u de mogelijkheid voor terugvalroute inschakelen. Als er geen routes naar het ingebouwde eindpunt zijn en er een terugvalroute is ingeschakeld, worden alleen berichten die niet overeenkomen met queryvoorwaarden voor routes verzonden naar het ingebouwde eindpunt. Als alle bestaande routes worden verwijderd, moet de terugvalroute ook worden ingeschakeld om alle gegevens op het ingebouwde eindpunt te ontvangen.
U kunt de terugvalroute in- of uitschakelen in Azure Portal met behulp van de blade Berichtroutering voor de IoT-hub. U kunt ook Azure Resource Manager voor FallbackRouteProperties gebruiken om een aangepast eindpunt te gebruiken voor een terugvalroute.
Laatst bekende fouten voor IoT Hub-routeringseindpunten
Eindpuntstatus ophalen in de REST API biedt de status van de eindpunten en de laatst bekende fout om te achterhalen waarom een eindpunt niet in orde is. De tabel Laatst bekende fouten bevat de meest voorkomende fouten.
Resourcelogboeken routeren
De tabel Bewerkingsnamen en foutcodes bevat informatieve en foutberichten die zijn vastgelegd in de resourcelogboeken van de routes.