Problemen met Azure Stream Analytics oplossen met behulp van resource logboeken

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. Met de resource Logboeken in Stream Analytics kunt u de oorzaak van problemen vaststellen wanneer deze optreden en de herstel tijd verminderen.

Het wordt ten zeerste aanbevolen om resource Logboeken in te scha kelen voor alle taken, omdat dit een aanzienlijk hulp voor fout opsporing en bewaking is.

Logboek typen

Stream Analytics biedt twee typen logboeken:

• Activiteiten logboeken (altijd aan), die inzicht geven in bewerkingen die worden uitgevoerd op taken.

• Bron logboeken (configureerbaar), die uitgebreid inzicht bieden in alles wat er gebeurt met een taak. Bron logboeken worden gestart wanneer de taak wordt gemaakt en beëindigd wanneer de taak wordt verwijderd. Ze omvatten gebeurtenissen wanneer de taak wordt bijgewerkt en terwijl deze wordt uitgevoerd.

Fout opsporing met activiteiten logboeken

Activiteiten logboeken zijn standaard ingeschakeld en geven inzichten op hoog niveau in bewerkingen die worden uitgevoerd door uw Stream Analytics-taak. Informatie die aanwezig is in activiteiten logboeken kan de hoofd oorzaak van de problemen die invloed hebben op uw taak vinden. Voer de volgende stappen uit om activiteiten Logboeken in Stream Analytics te gebruiken:

1. Meld u aan bij de Azure Portal en selecteer het activiteiten logboek in het overzicht.

   

2. U kunt een lijst weer geven met bewerkingen die zijn uitgevoerd. Elke bewerking waardoor uw taak is mislukt, heeft een rode info-bel.

3. Klik op een bewerking om de samenvattings weergave ervan weer te geven. Informatie is vaak beperkt. Klik op JSON voor meer informatie over de bewerking.

   

4. Schuif omlaag naar de sectie Eigenschappen van de JSON. Deze bevat details over de fout die de mislukte bewerking heeft veroorzaakt. In dit voor beeld is de fout veroorzaakt door een runtime-fout van de waarden van de afhankelijke Latitude. Het verschil in de gegevens die door een Stream Analytics taak worden verwerkt, veroorzaakt een gegevens fout. U vindt meer informatie over de verschillende invoer-en uitvoer gegevens fouten en waarom deze optreden.

   

5. U kunt corrigerende acties uitvoeren op basis van het fout bericht in JSON. In dit voor beeld wordt gecontroleerd om ervoor te zorgen dat de breedte van de Latitude tussen-90 graden ligt en 90 graden aan de query moet worden toegevoegd.

6. Als het fout bericht in de activiteiten logboeken niet nuttig is om de hoofd oorzaak te identificeren, kunt u bron logboeken inschakelen en Azure Monitor Logboeken gebruiken.

Diagnostische gegevens verzenden naar Azure Monitor-logboeken

Het inschakelen van bron logboeken en het verzenden van deze naar Azure Monitor Logboeken wordt sterk aanbevolen. Ze zijn standaard uitgeschakeld . Als u deze wilt inschakelen, voert u de volgende stappen uit:

1. Maak een Log Analytics-werk ruimte als u er nog geen hebt. Het is raadzaam om uw Log Analytics-werk ruimte in dezelfde regio als uw Stream Analytics-taak te hebben.

2. Meld u aan bij de Azure Portal en navigeer naar uw Stream Analytics-taak. Onder bewaking selecteert u Diagnostische logboeken. Selecteer vervolgens Diagnostische gegevens inschakelen.

   

3. Geef een naam op in de naam van de Diagnostische instellingen en schakel de selectie vakjes in voor uitvoering en ontwerp onder logboek en AllMetrics onder metrische gegevens. Selecteer vervolgens verzenden naar log Analytics en kies uw werk ruimte. Klik op Opslaan.

   

4. Wanneer uw Stream Analytics-taak wordt gestart, worden bron logboeken gerouteerd naar uw Log Analytics-werk ruimte. Als u de resource logboeken voor uw taak wilt weer geven, selecteert u Logboeken onder de sectie bewaking .

   

5. Stream Analytics biedt vooraf gedefinieerde query's waarmee u eenvoudig naar de logboeken kunt zoeken waarin u geïnteresseerd bent. U kunt alle vooraf gedefinieerde query's in het linkerdeel venster selecteren en vervolgens uitvoeren selecteren. De resultaten van de query worden weer geven in het onderste deel venster.

   

Categorieën van resourcelogboeken

Azure Stream Analytics worden twee categorieën resource logboeken vastgelegd:

• Ontwerpen: legt logboek gebeurtenissen vast die verband houden met het ontwerpen van taken, zoals het maken van een taak, 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 tijdens de uitvoering van de taak optreden.

  • Connectiviteitsfouten
  • Gegevens verwerkings fouten, waaronder:
    • Gebeurtenissen die niet voldoen aan de definitie van de query (niet-overeenkomende veld typen en waarden, ontbrekende velden, enzovoort)
    • Evaluatie fouten van expressie
  • Andere gebeurtenissen en fouten

Schema voor bron logboeken

Alle logboeken worden opgeslagen in JSON-indeling. Elke vermelding heeft de volgende algemene teken reeks velden:

Schema voor eigenschappen van uitvoerings logboek

Uitvoerings logboeken bevatten informatie over gebeurtenissen die zijn opgetreden tijdens de uitvoering van Stream Analytics taak. Het schema van eigenschappen varieert, afhankelijk van het feit of de gebeurtenis een gegevens fout of een algemene gebeurtenis is.

Gegevensfouten

Er is een fout opgetreden tijdens het verwerken van de gegevens in deze logboek categorie. Deze logboeken worden meestal gemaakt tijdens de lees-, serialisatie-en schrijf bewerkingen van gegevens. Deze logboeken bevatten geen verbindings fouten. Connectiviteits fouten worden behandeld als algemene gebeurtenissen. Meer informatie over de oorzaak van verschillende invoer-en uitvoer gegevens fouten.

Afhankelijk van de waarde van operationname , hebben gegevens fouten het volgende schema:

• Er treden gebeurtenissen op tijdens het lezen van gebeurtenissen. Ze treden op wanneer de gegevens bij de invoer niet voldoen aan het query schema om een van de volgende redenen:

  • Niet-overeenkomend type tijdens gebeurtenis (de) serialiseren: identificeert het veld dat de fout veroorzaakt.

  • Kan een gebeurtenis niet lezen, ongeldige serialisatie: bevat informatie over de locatie in de invoer gegevens waar de fout is opgetreden. Bevat de BLOB-naam voor BLOB-invoer, offset en een voor beeld van de gegevens.

• Verzenden van gebeurtenissen vindt plaats tijdens schrijf bewerkingen. Ze identificeren de streaming-gebeurtenis die de fout heeft veroorzaakt.

Algemene gebeurtenissen

Algemene gebeurtenissen zijn van belang voor alle andere.

Volgende stappen

• Stream Analytics gegevens fouten
• Naslag informatie voor de query taal Stream Analytics