Problemen met Azure Stream Analytics oplossen met behulp van resourcelogboeken
Soms wordt een Azure Stream Analytics-taak onverwacht beëindigd. Het is belangrijk om dit type gebeurtenissen te kunnen oplossen. Mislukte taken kunnen worden veroorzaakt door een onverwacht queryresultaat, door storing in de verbinding met apparaten of door een onverwachte serviceonderbreking. De resourcelogboeken in Stream Analytics kunnen u helpen bij het identificeren van de oorzaak van problemen wanneer ze optreden en de hersteltijd te verminderen.
Het wordt ten zeerste aanbevolen om resourcelogboeken in te schakelen voor alle taken, omdat dit aanzienlijk helpt bij foutopsporing en bewaking.
Logboektypen
Stream Analytics biedt twee soorten logboeken:
Activiteitenlogboeken (altijd ingeschakeld), die inzicht geven in bewerkingen die worden uitgevoerd op taken.
Resourcelogboeken (configureerbaar), die uitgebreidere inzichten bieden in alles wat er met een taak gebeurt. Resourcelogboeken beginnen wanneer de taak wordt gemaakt en eindigen wanneer de taak wordt verwijderd. Ze hebben betrekking op gebeurtenissen wanneer de taak wordt bijgewerkt en terwijl deze wordt uitgevoerd.
Notitie
U kunt services zoals Azure Storage, Azure Event Hubs en Azure Monitor-logboeken gebruiken om niet-conforme gegevens te analyseren. Er worden kosten in rekening gebracht op basis van het prijsmodel voor deze services.
Notitie
Dit artikel is onlangs bijgewerkt waarbij Log Analytics is vervangen door de term Azure Monitor-logboeken. Logboekgegevens worden nog steeds opgeslagen in een Log Analytics-werkruimte, en worden nog steeds verzameld en geanalyseerd met dezelfde Log Analytics-service. De terminologie wordt bijgewerkt om de rol van logboeken in Azure Monitor beter te weerspiegelen. Zie Wijzigingen in Azure Monitor-terminologie voor meer informatie.
Foutopsporing met behulp van activiteitenlogboeken
Activiteitenlogboeken zijn standaard ingeschakeld en bieden op hoog niveau inzicht in bewerkingen die door uw Stream Analytics-taak worden uitgevoerd. Informatie in activiteitenlogboeken kan helpen de hoofdoorzaak te vinden van de problemen die van invloed zijn op uw taak. Voer de volgende stappen uit om activiteitenlogboeken te gebruiken in Stream Analytics:
Meld u aan bij Azure Portal en selecteer Activiteitenlogboek onder Overzicht.
U ziet een lijst met bewerkingen die zijn uitgevoerd. Elke bewerking waardoor uw taak mislukt, heeft een rode infoballon.
Selecteer een bewerking om de samenvattingsweergave weer te geven. Informatie hier is vaak beperkt. Selecteer JSON voor meer informatie over de bewerking.
Schuif omlaag naar de sectie Eigenschappen van de JSON, die details bevat van de fout die de mislukte bewerking heeft veroorzaakt. In dit voorbeeld is de fout veroorzaakt door een runtimefout van buiten de afhankelijke breedtegraadwaarden. Discrepantie in de gegevens die door een Stream Analytics-taak worden verwerkt, veroorzaakt een gegevensfout. U kunt meer informatie krijgen over verschillende fouten in invoer- en uitvoergegevens en waarom ze optreden.
U kunt corrigerende acties ondernemen op basis van het foutbericht in JSON. In dit voorbeeld moeten controles worden uitgevoerd om ervoor te zorgen dat de breedtegraad tussen -90 graden en 90 graden aan de query moet worden toegevoegd.
Als het foutbericht in de activiteitenlogboeken niet nuttig is bij het identificeren van de hoofdoorzaak, schakelt u resourcelogboeken in en gebruikt u Azure Monitor-logboeken.
Diagnostische gegevens verzenden naar Azure Monitor-logboeken
Het wordt ten zeerste aanbevolen om resourcelogboeken in te schakelen en naar Azure Monitor-logboeken te verzenden. Ze zijn standaard uitgeschakeld . Voer de volgende stappen uit om ze in te schakelen:
Maak een Log Analytics-werkruimte als u er nog geen hebt. Het is raadzaam om uw Log Analytics-werkruimte in dezelfde regio te plaatsen als uw Stream Analytics-taak.
Meld u aan bij Azure Portal en navigeer naar uw Stream Analytics-taak. Selecteer diagnostische logboeken onder Bewaking. Selecteer vervolgens Diagnostische gegevens inschakelen.
Geef een naam op in de naam van de diagnostische instellingen en schakel de selectievakjes in voor uitvoering en creatie onder logboek en AllMetrics onder metrische gegevens. Selecteer vervolgens Verzenden naar Log Analytics en kies uw werkruimte. Selecteer Opslaan.
Wanneer uw Stream Analytics-taak wordt gestart, worden resourcelogboeken doorgestuurd naar uw Log Analytics-werkruimte. Als u resourcelogboeken voor uw taak wilt weergeven, selecteert u Logboeken onder de sectie Bewaking .
Stream Analytics biedt vooraf gedefinieerde query's waarmee u eenvoudig kunt zoeken naar de logboeken waarin u geïnteresseerd bent. U kunt vooraf gedefinieerde query's selecteren in het linkerdeelvenster en vervolgens Uitvoeren selecteren. U ziet de resultaten van de query in het onderste deelvenster.
Categorieën van resourcelogboeken
Azure Stream Analytics legt twee categorieën resourcelogboeken vast:
Ontwerpen: legt logboek gebeurtenissen vast die betrekking hebben op bewerkingen voor het ontwerpen van taken, zoals het maken van taken, het toevoegen en verwijderen van invoer en uitvoer, het toevoegen en bijwerken van de query en het starten of stoppen van de taak.
Uitvoering: legt gebeurtenissen vast die optreden tijdens het uitvoeren van de taak.
- Connectiviteitsfouten
- Gegevensverwerkingsfouten, waaronder:
- Gebeurtenissen die niet voldoen aan de querydefinitie (niet-overeenkomende veldtypen en -waarden, ontbrekende velden, enzovoort)
- Evaluatiefouten voor expressies
- Andere gebeurtenissen en fouten
Alle logboeken worden opgeslagen in JSON-indeling. Zie het schema voor resourcelogboeken voor meer informatie over het schema voor resourcelogboeken.