Problemen met Azure Stream Analytics oplossen met behulp van resourcelogboeken

Soms wordt een Azure Stream Analytics-taak onverwacht beëindigd. Storingen kunnen worden veroorzaakt door een onverwacht resultaat van een query, verbindingsproblemen met apparaten of een onverwachte uitval van een service. De resourcelogboeken in Azure Stream Analytics kunnen u helpen de oorzaak van deze fouten te identificeren en de hersteltijd te verminderen.

Schakel resourcelogboeken in voor alle Stream Analytics-taken om te helpen bij foutopsporing en bewaking.

Stream Analytics-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.

Fouten opsporen in Stream Analytics-taken 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 bij het vinden van de hoofdoorzaak van de problemen die van invloed zijn op uw taak. Voer de volgende stappen uit om activiteitenlogboeken in Stream Analytics te gebruiken:

1. Meld u aan bij Azure Portal en selecteer Activiteitenlogboek onder Overzicht.

   

2. U ziet een lijst met bewerkingen die zijn uitgevoerd. Elke bewerking waardoor uw taak mislukt, heeft een rode infoballon.

3. Selecteer een bewerking om de samenvattingsweergave weer te geven. Informatie hier is vaak beperkt. Selecteer JSON voor meer informatie over de bewerking.

   

4. 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 buitengrenswaarden voor breedtegraad. Een discrepantie in 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.

   

5. Voer corrigerende acties uit op basis van het foutbericht in JSON. In dit voorbeeld voegt u controles toe om ervoor te zorgen dat de breedtegraad tussen -90 graden en 90 graden ligt.

6. 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 van Stream Analytics verzenden naar Azure Monitor logboeken

Schakel resourcelogboeken in en stuur deze naar Azure Monitor-logboeken. Resourcelogboeken zijn standaard uitgeschakeld .

1. Maak een Log Analytics-werkruimte als u er nog geen hebt. Plaats uw Log Analytics werkruimte in dezelfde regio als uw Stream Analytics-taak.

2. Meld u aan bij Azure Portal en navigeer naar uw Stream Analytics-taak. Selecteer diagnostische logboeken onder Bewaking. Selecteer vervolgens Diagnostische gegevens inschakelen.

   

3. Geef een naam op in Naam van diagnostische instellingen en schakel de selectievakjes voor Execution en Authoring in onder logboeken, en AllMetrics onder metriek. Selecteer vervolgens Verzenden naar Log Analytics en kies uw werkruimte. Selecteer Opslaan.

   

4. 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 .

   

5. Stream Analytics biedt vooraf gedefinieerde query's waarmee u eenvoudig kunt zoeken naar de logboeken waarin u geïnteresseerd bent. U kunt een of meer vooraf gedefinieerde query's in het linkerdeelvenster selecteren en vervolgens Uitvoeren selecteren. U ziet de resultaten van de query in het onderste deelvenster.

   

Categorieën voor Stream Analytics-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)
    • Fouten bij het evalueren van 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.

Volgende stappen

• Stream Analytics-gegevensfouten
• Naslaginformatie voor de querytaal van Stream Analytics