Share via


整合 OSDU 服務記錄與 Azure 監視器

用於能源產業的 Azure 資料管理員支援使用診斷設定將 OSDU 服務記錄匯出至 Azure 監視器。 這項功能可協助您更妥善地進行疑難排解、偵錯及監視 OSDU 服務。 這裡的指示類似於您如何將其他記錄 (例如 Airflow 和 Elastic) 與 Azure 監視器整合。

必要條件

  • 現有的 Log Analytics 工作區。 此工作區會用來查詢 OSDU 服務記錄,使用 Log Analytics 工作區中的 Kusto 查詢語言 (KQL) 查詢編輯器。 實用資源:在 Azure 入口網站中建立記錄分析工作區

  • 現有的儲存體帳戶:用來儲存 OSDU 服務記錄的 JSON 傾印。 儲存體帳戶不一定與 Log Analytics 工作區位於相同的訂用帳戶中。

啟用 OSDU 服務記錄整合的診斷設定

  1. 開啟適用於能源產業的 Microsoft Azure 資料管理員的 [概觀] 頁面。

  2. 從左側面板中選取 [診斷設定]

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

  3. 選取 [新增診斷設定]。 選擇診斷設定名稱,然後選取您想要將記錄傳送至所選目的地的 [類別] 底下的服務。

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

  4. 在 [記錄] 區段底下,您可以選擇一或多個要為其建立診斷設定的 OSDU 服務。 選取 [封存至儲存體帳戶],和/或視需要選取 [傳送至 Log Analytics 工作區]

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

  5. 確認您要封存記錄或與其整合的訂用帳戶、儲存體帳戶和 Log Analytics 工作區。

在 Log Analytics 工作區中使用 OSDU 服務記錄

  1. 瀏覽至左面板中的 [記錄] 索引標籤。

  2. 展開 [記錄管理] 類別下的資料表清單。 使用診斷設定匯出的 OSDU 服務記錄會顯示在 OEPDataplaneLogs 資料表中。

  3. 移至編輯器窗格。 在這裡,您可以撰寫 Kusto 查詢語言 (KQL) 查詢來篩選您的 OSDU 服務記錄,並只顯示相關的記錄。

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

針對 OSDU 服務記錄進行疑難排解

在 Azure 監視器中分析 OSDU 服務記錄可協助您識別與特定服務和 API 相關的錯誤和問題。 檢查工作流程服務、分割服務或權利服務等服務的記錄,以快速識別並解決 API 呼叫或服務功能中的任何問題。

Log Analytics 工作區查詢編輯器支援 KQL 查詢。 以下是一些可能有所幫助的範例查詢:

  • 過去 6 小時內,篩選用於能源產業的 Azure 資料管理員中特定服務所產生 OSDU 服務記錄的查詢。
OEPDataplaneLogs
| where TimeGenerated >= ago(6h)
| where _ResourceID contains "name-of-your-adme-instance"
| where Category = "DatasetLogs"
  • 可篩選出所有導致今日錯誤的 OSDU 服務呼叫記錄的查詢。
OEPDataplaneLogs
| where _ResourceID contains "name-of-your-adme-instance"
| where TimeGenerated >= startofday(ago(0d))
| where TimeGenerated < startofday(ago(-1d))
| where LogLevel != "INFO"

將 OSDU 服務記錄封存至儲存體帳戶

您可以將 OSDU 服務記錄封存至儲存體帳戶,並利用 Azure 監視器功能進行記錄封存、保留原則等等:

  • 指定在診斷設定建立程序期間封存記錄的儲存體帳戶。
  • 設定封存記錄的保留原則。
  • 存取儲存體帳戶中的記錄,以取得其他分析或長期儲存體。

下一步

現在系統已在收集 OSDU 服務記錄,您可建立記錄查詢警示,以便在記錄資料中識別出有趣的資料時主動收到通知。