整合 OSDU 服務記錄與 Azure 監視器
用於能源產業的 Azure 資料管理員支援使用診斷設定將 OSDU 服務記錄匯出至 Azure 監視器。 這項功能可協助您更妥善地進行疑難排解、偵錯及監視 OSDU 服務。 這裡的指示類似於您如何將其他記錄 (例如 Airflow 和 Elastic) 與 Azure 監視器整合。
必要條件
現有的 Log Analytics 工作區。 此工作區會用來查詢 OSDU 服務記錄,使用 Log Analytics 工作區中的 Kusto 查詢語言 (KQL) 查詢編輯器。 實用資源:在 Azure 入口網站中建立記錄分析工作區。
現有的儲存體帳戶:用來儲存 OSDU 服務記錄的 JSON 傾印。 儲存體帳戶不一定與 Log Analytics 工作區位於相同的訂用帳戶中。
啟用 OSDU 服務記錄整合的診斷設定
開啟適用於能源產業的 Microsoft Azure 資料管理員的 [概觀] 頁面。
從左側面板中選取 [診斷設定]。
選取 [新增診斷設定]。 選擇診斷設定名稱,然後選取您想要將記錄傳送至所選目的地的 [類別] 底下的服務。
在 [記錄] 區段底下,您可以選擇一或多個要為其建立診斷設定的 OSDU 服務。 選取 [封存至儲存體帳戶],和/或視需要選取 [傳送至 Log Analytics 工作區]。
確認您要封存記錄或與其整合的訂用帳戶、儲存體帳戶和 Log Analytics 工作區。
在 Log Analytics 工作區中使用 OSDU 服務記錄
瀏覽至左面板中的 [記錄] 索引標籤。
展開 [記錄管理] 類別下的資料表清單。 使用診斷設定匯出的 OSDU 服務記錄會顯示在 OEPDataplaneLogs 資料表中。
移至編輯器窗格。 在這裡,您可以撰寫 Kusto 查詢語言 (KQL) 查詢來篩選您的 OSDU 服務記錄,並只顯示相關的記錄。
針對 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 服務記錄,您可建立記錄查詢警示,以便在記錄資料中識別出有趣的資料時主動收到通知。