使用資源記錄對 Azure 串流分析進行疑難排解

有時候，Azure 串流分析作業會非預期地停止處理。 請務必要設法解決這類事件的問題。 錯誤發生的原因可能是非預期的查詢結果、裝置的連線狀況，或未預期的服務中斷。 串流分析中的資源記錄可協助您在事件發生當下找出問題原因，並減少復原時間。

強烈建議為所有作業啟用資源記錄，因為這可大幅協助偵錯和監視。

記錄類型

串流分析提供開兩種記錄類型：

• 活動記錄 (永遠啟動) 可讓您對所執行作業有深入的了解。

• 資源記錄 (可設定) 可讓您更深入地了解所有與作業相關的發生事件。 資源記錄會在作業建立時開始執行，並在作業刪除時結束。 這些記錄涵蓋作業更新時與作業執行時的情形。

注意

您可以使用 Azure 儲存體、Azure 事件中樞和 Azure 監視器記錄等服務來分析不一致的資料。 這些服務將會依據各自的計價模式向您收取費用。

注意

本文最近有所更新，改為使用「Azure 監視器記錄」一詞，而非 Log Analytics。 記錄資料仍儲存在 Log Analytics 工作區中，並仍由相同的 Log Analytics 服務收集和分析。 我們會持續更新術語，以更精確地反映 Azure 監視器記錄的角色。 如需詳細資料，請參閱 Azure 監視器遙測變更。

使用活動記錄進行偵錯

活動記錄預設會開啟，可以對 Stream Analytics 作業所執行的作業提供高層級的見解。 活動記錄中出現的資訊可能有助於找出影響您工作之問題的根本原因。 執行下列步驟，以在 Stream Analytics 中使用活動記錄：

1. 登入 Azure 入口網站，並在 [概觀] 下選取 [活動記錄]。

   

2. 您可以看到一份已執行的作業清單。 任何造成您的作業 (job) 失敗的任何作業 (operation) 都會出現紅色的資訊泡泡。

3. 選取作業，以查看其摘要檢視。 這裡的資訊通常是有限的。 若要深入了解作業的相關資訊，請選取 [JSON]。

   

4. 向下捲動至 JSON 的 [屬性] 區段，該區段提供導致作業失敗的錯誤的詳細資料。 在此範例中，失敗是由於超出範圍的緯度值的執行階段錯誤。 串流分析作業處理的資料不一致會導致資料錯誤。 您可以了解不同的輸入和輸出資料錯誤，以及其發生原因。

   

5. 您可以根據 JSON 中的錯誤訊息採取修正動作。 在此範例中，需要檢查以確保緯度值是介於 -90 度和 90 度之間。

6. 如果活動記錄中的錯誤訊息無法幫助識別根本原因，請啟用資源記錄，並使用 Azure 監視器記錄。

將診斷傳送至 Azure 監視器記錄

強烈建議開啟資源記錄並將其傳送至 Azure 監視器記錄。 其預設為 [關閉]。 若要將其開啟，請完成下列步驟：

1. 如果您尚未建立 Log Analytics 工作區，請加以建立。 建議您讓 Log Analytics 工作區位於與串流分析作業相同的區域中。

2. 登入 Azure 入口網站，然後瀏覽至您的 Stream Analytics 作業。 在 [監視] 下，選取 [診斷記錄]。 然後選取 [開啟診斷]。

   

3. 在 [診斷設定名稱] 中提供 [名稱]，然後勾選 [記錄] 底下的 [執行] 和 [撰寫] 方塊，以及 [計量] 下的 [AllMetrics]。 然後選取 [傳送至 Log Analytics] ，然後選擇工作區。 選取 [儲存]。

   

4. 當串流分析作業啟動時，資源記錄會路由至 Log Analytics 工作區。 若要檢視作業的資源記錄，請選取 [監視] 區段底下的 [記錄]。

   

5. 串流分析提供預先定義的查詢，可讓您輕鬆地搜尋您感興趣的記錄。 您可以在左窗格上選取任何預先定義的查詢，然後選取 [執行]。 您將會在底部窗格中看到查詢的結果。

   

資源記錄類別

Azure 串流分析會擷取兩種資源記錄類別：

• 撰寫：擷取與作業撰寫作業相關之記錄事件，例如作業建立、新增及刪除輸入與輸出、新增及更新查詢、開始及停止作業。

• 執行：擷取作業執行期間發生的事件。

  • 連線錯誤
  • 資料處理錯誤，包括：
    • 不符合查詢定義的事件 (不相符的欄位類型與值或遺漏欄位等)
    • 運算式評估錯誤
  • 其他事件和錯誤

所有記錄會儲存為 JSON 格式。 若要了解資源記錄的結構描述，請參閱資源記錄結構描述。

下一步

• 串流分析資料錯誤
• 串流分析查詢語言參考