OSDU-servicelogboeken integreren met Azure Monitor

  • Artikel

Azure Data Manager for Energy ondersteunt het exporteren van OSDU-servicelogboeken naar Azure Monitor met behulp van een diagnostische instelling. Met deze functie kunt u beter problemen oplossen, fouten opsporen en de OSDU-services bewaken. De instructies hier zijn vergelijkbaar met hoe u andere logboeken, zoals Airflow en Elastic, integreert met Azure Monitor.

Vereisten

  • Een bestaande Log Analytics-werkruimte. Deze werkruimte wordt gebruikt om query's uit te voeren op OSDU-servicelogboeken met behulp van de Kusto-querytaal -queryeditor (KQL) in de Log Analytics-werkruimte. Nuttige resource: een Log Analytics-werkruimte maken in Azure Portal.

  • Een bestaand opslagaccount: het wordt gebruikt voor het opslaan van JSON-dumps van OSDU-servicelogboeken. Het opslagaccount hoeft zich niet in hetzelfde abonnement te bevinden als uw Log Analytics-werkruimte.

Diagnostische instellingen inschakelen voor integratie van OSDU-servicelogboeken

  1. Open de pagina Microsoft Azure Data Manager for Energy Overview .

  2. Selecteer Diagnostische Instellingen in het linkerdeelvenster.

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

  3. Selecteer Diagnostische instellingen toevoegen. Kies de naam van een diagnostische instelling en selecteer de services onder Categorieën waarvoor u logboeken naar uw gekozen bestemming wilt verzenden.

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

  4. In de sectie Logboeken kunt u een of meerdere OSDU-services kiezen waarvoor u een diagnostische instelling wilt maken. Selecteer Archiveren naar een opslagaccount en/of verzenden naar Log Analytics-werkruimte naar wens.

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

  5. Controleer het abonnement, het opslagaccount en de Log Analytics-werkruimte waarmee u de logboeken wilt archiveren of ermee wilt integreren.

Werken met OSDU-servicelogboeken in Log Analytics Workspace

  1. Navigeer naar het tabblad Logboeken in het linkerdeelvenster.

  2. Vouw de lijst met tabellen uit onder de categorie Logboekbeheer. De OSDU-servicelogboeken die worden geëxporteerd met behulp van een diagnostische instelling, worden weergegeven in de tabel OEPDataplaneLogs .

  3. Naar het deelvenster Editor gaan. Hier kunt u Kusto-querytaal (KQL)-query's schrijven om uw OSDU-servicelogboeken te filteren en alleen de relevante query's weer te geven.

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

Problemen oplossen met OSDU-servicelogboeken

Het analyseren van OSDU-servicelogboeken in Azure Monitor kan u helpen bij het identificeren van fouten en problemen met betrekking tot specifieke services en API's. Bekijk logboeken voor services zoals de werkstroomservice, partitieservice of rechtenservice om snel eventuele problemen in de API-aanroepen of servicefunctionaliteit te identificeren en op te lossen.

Log Analytics Workspace-queryeditor ondersteunt KQL-query's. Hier volgen enkele voorbeeldquery's die nuttig kunnen zijn:

  • Een query voor het filteren van OSDU-servicelogboeken die zijn gegenereerd door een specifieke service in uw Azure Data Manager for Energy in de afgelopen 6 uur.
OEPDataplaneLogs
| where TimeGenerated >= ago(6h)
| where _ResourceID contains "name-of-your-adme-instance"
| where Category = "DatasetLogs"
  • Een query voor het filteren van logboeken voor alle OSDU-serviceoproepen die vandaag tot fouten hebben geleid.
OEPDataplaneLogs
| where _ResourceID contains "name-of-your-adme-instance"
| where TimeGenerated >= startofday(ago(0d))
| where TimeGenerated < startofday(ago(-1d))
| where LogLevel != "INFO"

OSDU-servicelogboeken archiveren naar opslagaccounts

U kunt OSDU-servicelogboeken archiveren naar opslagaccounts en profiteren van Azure Monitor-functies voor archivering van logboeken, bewaarbeleid en meer:

  • Geef het opslagaccount op voor het archiveren van logboeken tijdens het maken van de diagnostische instelling.
  • Bewaarbeleid instellen voor de gearchiveerde logboeken.
  • Open de logboeken in het opslagaccount voor andere analyse of langetermijnopslag.

Volgende stappen

Nu u OSDU-servicelogboeken verzamelt, maakt u een logboekquerywaarschuwing om proactief op de hoogte te worden gesteld wanneer interessante gegevens worden geïdentificeerd in uw logboekgegevens.

Een logboekquerywaarschuwing maken voor een Azure-resource