Integrieren von OSDU-Dienstprotokollen in Azure Monitor

  • Artikel

Azure Data Manager für Energie unterstützt das Exportieren von OSDU-Dienstprotokollen nach Azure Monitor mithilfe einer Diagnoseeinstellung. Dieses Feature hilft Ihnen, die OSDU-Dienste besser zu beheben, zu debuggen und zu überwachen. Die hier aufgeführten Anweisungen ähneln der 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 Abfrage-Editors Kusto-Abfragesprache (KQL) im Log Analytics-Arbeitsbereich abzufragen. Nützliche Ressource: Erstellen eines Log Analytics-Arbeitsbereichs im Azure-Portal.

  • Ein vorhandenes Speicherkonto: Es wird verwendet, um JSON-Abbilder 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 "Microsoft Azure Data Manager for Energy Overview ".

  2. Wählen Sie "Diagnose Einstellungen" im linken Bereich aus.

    Screenshot shows that the list of OSDU services currently supported is visible on the diagnostic settings overview page.

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

    Screenshot to show that users can select all or a few log categories while creating a diagnostic setting.

  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 "Archivieren" für ein Speicherkonto und/oder "Senden an log Analytics"-Arbeitsbereich nach Bedarf aus.

    Screenshot shows that export to multiple destinations can be configured with just one diagnostic setting.

  5. Überprüfen Sie den Arbeitsbereich "Abonnement", "Speicherkonto" und "Log Analytics", in den Sie die Protokolle archivieren oder integrieren 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 osDU-Dienstprotokolle, die mithilfe einer Diagnoseeinstellung exportiert wurden, werden in der Tabelle "OEPDataplaneLogs " angezeigt.

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

    Screenshot shows the different parts of a Log Analytics workspace interface.

Problembehandlung mit OSDU-Dienstprotokollen

Das Analysieren 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. Hier sind einige Beispielabfragen, die hilfreich sein können:

  • Eine Abfrage zum Filtern von OSDU-Dienstprotokollen, die von einem bestimmten Dienst in Ihrem Azure Data Manager für Energie 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 Protokolle archivieren, Aufbewahrungsrichtlinien und vieles mehr nutzen:

  • Geben Sie das Speicherkonto für archivierungsprotokolle während des Erstellungsprozesses 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 einen langfristigen Speicher zu.

Nächste Schritte

Nachdem Sie nun OSDU-Dienstprotokolle sammeln, erstellen Sie eine Protokollabfragewarnung, um proaktiv benachrichtigt zu werden, wenn interessante Daten in Ihren Protokolldaten identifiziert werden.

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