Freigeben über

Integrieren von OSDU-Dienstprotokollen in Azure Monitor

  • Artikel

Azure Data Manager for Energy unterstützt das Exportieren von OSDU-Dienstprotokollen nach Azure Monitor mithilfe einer Diagnoseeinstellung. Dieses Feature hilft Ihnen bei der Problembehandlung, beim Debuggen und beim Überwachen von OSDU-Diensten. Die hier aufgeführten Anweisungen ähneln denen für die Integration anderer Protokolle, z. B. Airflow und Elastic, in Azure Monitor.

Voraussetzungen

  • Ein vorhandener Log Analytics-Arbeitsbereich. Dieser Arbeitsbereich wird verwendet, um OSDU-Dienstprotokolle mithilfe des KQL-Abfrage-Editors (Kusto Query Language, Kusto-Abfragesprache) im Log Analytics-Arbeitsbereich abzufragen. Nützliche Ressource: Erstellen eines Log Analytics-Arbeitsbereichs im Azure-Portal.

  • Ein vorhandenes Speicherkonto: Dieses wird verwendet, um JSON-Sicherungen von OSDU-Dienstprotokollen zu speichern. Das Speicherkonto muss sich nicht im selben Abonnement wie der Log Analytics-Arbeitsbereich befinden.

Aktivieren von Diagnoseeinstellungen für die Integration von OSDU-Dienstprotokollen

  1. Öffnen Sie die Seite Übersicht für Microsoft Azure Data Manager for Energy.

  2. Wählen Sie im linken Bereich Diagnoseeinstellungen aus.

    Screenshot: Liste der derzeit unterstützten OSDU-Dienste ist auf der Übersichtsseite mit den Diagnoseeinstellungen sichtbar.

  3. Klicken Sie auf Diagnoseeinstellung hinzufügen. Wählen Sie den Namen einer Diagnoseeinstellung und dann die Dienste unter Kategorien aus, für die Sie Protokolle an Ihr ausgewähltes Ziel senden möchten.

    Screenshot: Benutzer können beim Erstellen einer Diagnoseeinstellung alle oder einige Protokollkategorien auswählen.

  4. Im Abschnitt „Protokolle“ können Sie einen oder mehrere OSDU-Dienste auswählen, für die Sie eine Diagnoseeinstellung erstellen möchten. Wählen Sie nach Bedarf In einem Speicherkonto archivieren und/oder An Log Analytics senden aus.

    Screenshot: Der Export an mehrere Ziele kann mit nur einer Diagnoseeinstellung konfiguriert werden.

  5. Überprüfen Sie das Abonnement, das Speicherkonto und den Log Analytics-Arbeitsbereich, die Sie für die Archivierung der Protokolle oder für die Integration verwenden möchten.

Arbeiten mit OSDU-Dienstprotokollen im Log Analytics-Arbeitsbereich

  1. Navigieren Sie im linken Bereich zur Registerkarte Protokolle.

  2. Erweitern Sie die Liste der Tabellen unter der Kategorie „Protokollverwaltung“. Die mithilfe einer Diagnoseeinstellung exportierten OSDU-Dienstprotokolle werden in der Tabelle OEPDataplaneLogs angezeigt.

  3. Wechseln Sie zum Editor-Bereich. Hier können Sie KQL-Abfragen (Kusto Query Language, Kusto-Abfragesprache) schreiben, um Ihre OSDU-Dienstprotokolle zu filtern und nur die relevanten anzuzeigen.

    Screenshot: Verschiedene Teile der Benutzeroberfläche eines Log Analytics-Arbeitsbereichs

Problembehandlung mit OSDU-Dienstprotokollen

Die Analyse von OSDU-Dienstprotokollen in Azure Monitor kann Ihnen helfen, Fehler und Probleme im Zusammenhang mit bestimmten Diensten und APIs zu identifizieren. Überprüfen Sie Protokolle für Dienste wie den Workflowdienst, den Partitionsdienst oder den Berechtigungsdienst, um Probleme in den API-Aufrufen oder Dienstfunktionen schnell zu identifizieren und zu beheben.

Der Abfrage-Editor des Log Analytics-Arbeitsbereichs unterstützt KQL-Abfragen. Im Anschluss finden Sie einige hilfreiche Beispielabfragen:

  • Eine Abfrage zum Filtern von OSDU-Dienstprotokollen, die von einem bestimmten Dienst in Ihrer Azure Data Manager for Energy-Instanz in den letzten 6 Stunden generiert wurden
OEPDataplaneLogs
| where TimeGenerated >= ago(6h)
| where _ResourceID contains "name-of-your-adme-instance"
| where Category = "DatasetLogs"
  • Eine Abfrage zum Filtern von Protokollen für alle OSDU-Dienstaufrufe, die heute zu Fehlern geführt haben
OEPDataplaneLogs
| where _ResourceID contains "name-of-your-adme-instance"
| where TimeGenerated >= startofday(ago(0d))
| where TimeGenerated < startofday(ago(-1d))
| where LogLevel != "INFO"

Archivieren von OSDU-Dienstprotokollen in Speicherkonten

Sie können OSDU-Dienstprotokolle in Speicherkonten archivieren und Azure Monitor-Features für die Protokollarchivierung, Aufbewahrungsrichtlinien und vieles mehr nutzen:

  • Geben Sie das Speicherkonto für die Archivierung von Protokollen während der Erstellung der Diagnoseeinstellung an.
  • Legen Sie Aufbewahrungsrichtlinien für die archivierten Protokolle fest.
  • Greifen Sie auf die Protokolle im Speicherkonto für eine andere Analyse oder zur langfristigen Speicherung zu.

Nächste Schritte

Sie haben OSDU-Dienstprotokolle gesammelt. Erstellen Sie nun eine Protokollabfragewarnung, um proaktiv benachrichtigt zu werden, wenn interessante Daten in Ihren Protokolldaten identifiziert werden.

Tutorial: Erstellen einer Protokollabfragewarnung für eine Azure-Ressource