Behandeln von Problemen in Azure Stream Analytics mithilfe von Ressourcenprotokollen

In einigen Fällen beendet ein Azure Stream Analytics-Auftrag unerwartet die Verarbeitung. Fehler können durch ein unerwartetes Abfrageergebnis, die Verbindung zu Geräten oder einen unerwarteten Dienstausfall verursacht werden. Die Ressourcenprotokolle in Azure Stream Analytics können Ihnen helfen, die Ursache dieser Fehler zu identifizieren und die Wiederherstellungszeit zu reduzieren.

Aktivieren Sie Ressourcenprotokolle für alle Stream Analytics-Aufträge, um das Debuggen und überwachen zu können.

Stream Analytics-Protokolltypen

Stream Analytics bietet zwei Arten von Protokollen:

• Aktivitätsprotokolle (immer aktiviert) bieten Einblicke in die Vorgänge, die bei Aufträgen durchgeführt werden.

• Ressourcenprotokolle (konfigurierbar), die umfangreichere Einblicke in sämtliche Vorgänge eines Auftrags bieten. Ressourcenprotokolle starten, wenn der Auftrag erstellt wurde, und enden, wenn der Auftrag gelöscht wird. Sie behandeln Ereignisse bei der Aktualisierung des Auftrags und während der Ausführung.

Debuggen von Stream Analytics-Aufträgen mithilfe von Aktivitätsprotokollen

Aktivitätsprotokolle sind standardmäßig aktiviert und geben allgemeine Einblicke in Vorgänge, die von Ihrem Stream Analytics-Auftrag ausgeführt werden. Informationen, die in Aktivitätsprotokollen vorhanden sind, können dazu beitragen, die Ursache der Probleme zu finden, die sich auf Ihren Auftrag auswirken. Führen Sie die folgenden Schritte aus, um Aktivitätsprotokolle in Stream Analytics zu verwenden:

1. Melden Sie sich beim Azure-Portal an, und wählen Sie Aktivitätsprotokoll unter Übersicht aus.

   

2. Sie sehen eine Liste der Vorgänge, die ausgeführt wurden. Jeder Vorgang, der zum Fehlschlagen Ihrer Aufgabe geführt hat, hat eine rote Infoblase.

3. Wählen Sie einen Vorgang aus, um dessen Zusammenfassung anzuzeigen. Informationen hier sind häufig eingeschränkt. Weitere Informationen zum Vorgang finden Sie unter JSON.

   

4. Scrollen Sie nach unten zum JSON-Abschnitt Eigenschaften, der Details zum Fehler bereitstellt, der den fehlerhaften Vorgang verursacht hat. In diesem Beispiel war das Scheitern auf einen Laufzeitfehler aufgrund von Breitengradwerten außerhalb des zulässigen Bereichs zurückzuführen. Eine Diskrepanz in Daten, die ein Stream Analytics-Auftrag verarbeitet, verursacht einen Datenfehler. Es stehen Informationen zu verschiedenen Fehlern bei der Eingabe und Ausgabe von Daten sowie zu den Gründen für deren Auftreten bereit.

   

5. Ergreifen Sie Korrekturmaßnahmen basierend auf der Fehlermeldung in JSON. Fügen Sie in diesem Beispiel Überprüfungen hinzu, um sicherzustellen, dass der Breitengrad zwischen -90 Grad und 90 Grad liegt.

6. Wenn die Fehlermeldung in den Aktivitätsprotokollen beim Identifizieren der Ursache nicht hilfreich ist, aktivieren Sie Ressourcenprotokolle, und verwenden Sie Azure Monitor Protokolle.

Stream Analytics-Diagnosedaten an Azure Monitor-Protokolle senden

Aktivieren Sie Ressourcenprotokolle und senden Sie sie an Azure Monitor-Protokolle. Ressourcenprotokolle sind standardmäßig deaktiviert .

1. Sofern nicht bereits geschehen, erstellen Sie einen Log Analytics-Arbeitsbereich. Platzieren Sie Ihren Log Analytics Arbeitsbereich in derselben Region wie Ihr Stream Analytics-Auftrag.

2. Melden Sie sich im Azure-Portal an, und navigieren Sie zu Ihrem Stream Analytics-Auftrag. Wählen Sie unter Überwachung die Option Diagnoseprotokolle aus. Wählen Sie dann Diagnose aktivieren aus.

   

3. Geben Sie in Name der Diagnoseeinstellungen einen Namen ein, und aktivieren Sie die Kontrollkästchen für Ausführung und Verfassen unter Protokoll sowie für AllMetrics unter Metrik. Aktivieren Sie dann An Log Analytics senden, und wählen Sie Ihren Arbeitsbereich aus. Wählen Sie Speichern aus.

   

4. Wenn Ihr Stream Analytics-Auftrag gestartet wird, werden Ressourcenprotokolle an Ihren Log Analytics-Arbeitsbereich weitergeleitet. Wenn Sie Ressourcenprotokolle für Ihren Auftrag anzeigen möchten, wählen Sie die Option Protokolle im Abschnitt Überwachung aus.

   

5. Stream Analytics bietet vordefinierte Abfragen, mit denen Sie problemlos nach den für Sie interessanten Protokollen suchen können. Sie können alle vordefinierten Abfragen im linken Bereich auswählen und dann Ausführen auswählen. Ihnen werden die Abfrageergebnisse im unteren Bereich angezeigt.

   

Stream Analytics-Ressourcenprotokollkategorien

Azure Stream Analytics erfasst zwei Kategorien von Ressourcenprotokollen:

• Erstellung: Erfasst Protokollereignisse zu Auftragserstellungsvorgängen wie Erstellen von Aufträgen, Hinzufügen und Löschen von Eingaben und Ausgaben, Hinzufügen und Aktualisieren der Abfrage sowie Starten und Beenden des Auftrags.

• Ausführung: Erfasst Ereignisse, die während der Ausführung eines Auftrags auftreten.

  • Verbindungsfehler
  • Datenverarbeitungsfehler wie Folgende:
    • Ereignisse, die nicht mit der Abfragedefinition übereinstimmen (nicht übereinstimmende Feldtypen und Werte, fehlende Felder usw.)
    • Fehler bei der Auswertung von Ausdrücken
  • Andere Ereignisse und Fehler

Alle Protokolle werden im JSON-Format gespeichert. Informationen zum Schema für Ressourcenprotokolle finden Sie unter Ressourcenprotokollschema.

Nächste Schritte

• Datenfehler in Azure Stream Analytics
• Referenz zur Stream Analytics-Abfragesprache