監視及收集 Azure Logic Apps 中工作流程的診斷資料

適用於：Azure Logic Apps (使用量 + 標準)

若要取得更豐富的資料來偵錯和診斷 Azure Logic Apps 中的工作流程，您可以記錄工作流程執行時間資料和事件，例如觸發事件、執行事件和動作事件，您可以在設定和使用Azure 監視器記錄時傳送至Log Analytics 工作區、Azure儲存體帳戶、Azure事件中樞、另一個合作夥伴目的地，或所有這些目的地。

注意

Azure 監視器資源記錄不會遺失 100%。 資源記錄是以市集和轉寄架構為基礎，專為大規模移動每天數 PB 的資料而設計。 這項功能包括跨平臺的內建備援和重試，但不提供交易式保證。 交易式監視可能會降低受監視服務的可靠性與效能。 此外，暫時性記錄錯誤必須在無法確認記錄傳遞時停止上游服務。 每當 Azure 監視器小組可以確認資料遺失的持續性來源時，小組就會考慮解決並預防其最高優先順序。 不過，由於分散于 Azure 的暫時、非重複服務問題，因此仍可能會發生小型資料損失，而且無法攔截所有問題。

本操作指南說明如何根據您是否有取用或標準邏輯應用程式資源來完成下列工作。

取用

1. 在 [取用邏輯應用程式建立] 中，啟用 Log Analytics 並指定 Log Analytics 工作區。

   -或-

   針對現有的取用邏輯應用程式， 請在 Log Analytics 工作區中安裝 Logic Apps 管理解決方案。 此解決方案可提供邏輯應用程式執行的彙總資訊，並且會包含狀態、執行時間、重新提交狀態和相互關聯識別碼等具體詳細資料。

2. 新增診斷設定以啟用資料收集。

3. 檢視工作流程執行狀態。

4. 將診斷資料傳送至 Azure 儲存體和 Azure 事件中樞。

5. 在遙測中包含自訂屬性。

標準

1. 新增診斷設定以啟用資料收集。

2. 檢視工作流程執行狀態。

3. 將診斷資料傳送至 Azure 儲存體和 Azure 事件中樞。

4. 在遙測中包含自訂屬性。

必要條件

• Azure 帳戶和訂用帳戶。 如果您沒有訂用帳戶，請註冊一個免費的 Azure 帳戶。

  針對取用邏輯應用程式資源，您需要 Azure 訂用帳戶擁有者或參與者許可權，以便從 Azure Marketplace 安裝 Logic Apps 管理解決方案。 如需詳細資訊，請參閱下列文件：

  • 購買許可權 - Azure Marketplace 購買

  • Azure 角色、Azure AD 角色和傳統訂用帳戶管理員角色

• 您想要傳送診斷資料的目的地資源：

  • Log Analytics 工作區

  • Azure 儲存體帳戶

  • Azure 事件中樞

• 邏輯應用程式資源和工作流程

启用 Log Analytics

取用

針對取用邏輯應用程式，您必須先啟用 Log Analytics。

在邏輯應用程式建立時啟用 Log Analytics

1. 在 Azure 入口網站的 [ 建立邏輯應用程式 ] 窗格中，遵循下列步驟：

   1. 在 [方案] 底下，請務必選取 [ 取用 ]，以便只顯示 [取用工作流程] 的選項。

   2. 針對 [啟用記錄分析]，選取 [ 是]。

   3. 從 Log Analytics 工作區 清單中，選取您要從工作流程執行傳送資料的工作區。

      

2. 完成建立邏輯應用程式資源。

   完成時，邏輯應用程式會與您的 Log Analytics 工作區相關聯。 此步驟也會在您的工作區中自動安裝 Logic Apps 管理解決方案。

3. 執行工作流程之後， 請檢視您的工作流程執行狀態。

安裝 Logic Apps 管理解決方案

如果您在建立邏輯應用程式資源時開啟 Log Analytics，請略過本節。 您已在 Log Analytics 工作區中安裝了 Logic Apps 管理解決方案。 否則，請繼續進行現有取用邏輯應用程式的下列步驟：

1. 在 Azure 入口網站 搜尋方塊中，輸入 Log Analytics 工作區，然後從結果中選取 [Log Analytics 工作區 ]。

   

2. 在 [Log Analytics 工作區] 下方，選取您的工作區。

   

3. 在 [概觀] 窗格上，於 [開始使用 Log Analytics]>[設定監視解決方案] 底下，選取 [檢視解決方案]。

   

4. 在 [ 概觀]底下，選取 [ 新增]，以將新的解決方案新增至您的工作區。

5. 在 Marketplace 頁面開啟之後，在搜尋方塊中輸入 邏輯應用程式管理，然後選取 [Logic Apps 管理]。

   

6. 在 [Logic Apps 管理] 圖格上，從 [建立] 清單中，選取 [Logic Apps 管理]。

   

7. 在 [建立 Logic Apps 管理 (預覽) 解決方案] 窗格上，選取要安裝解決方案的 Log Analytics 工作區。 選取 [檢閱 + 建立]、檢閱您的資訊，然後選取 [建立]。

   

   在 Azure 將解決方案部署到包含 Log Analytics 工作區的 Azure 資源群組之後，該解決方案便會出現在 [概觀] 底下的工作區摘要窗格上。

   

標準

針對標準邏輯應用程式，您可以繼續進行 新增診斷設定。 啟用 Log Analytics 不需要其他必要步驟，Logic Apps 管理解決方案也不會套用至標準邏輯應用程式。

新增診斷設定

取用

1. 在 Azure 入口網站中，開啟您的取用邏輯應用程式資源。

2. 在邏輯應用程式資源功能表上的 [ 監視] 底下，選取 [ 診斷設定]。 在 [ 診斷設定] 頁面上，選取 [ 新增診斷設定]。

   

3. 針對 [診斷設定名稱]，提供您想要設定的名稱。

4. 在[記錄類別]> 底下，選取[工作流程執行時間診斷事件]。 在 [計量] 底下，選取 [AllMetrics]。

5. 在 [ 目的地詳細資料] 底下，根據您想要傳送記錄的位置，選取一或多個目的地。

   Destination	方向
   傳送至 Log Analytics 工作區	選取 Log Analytics 工作區和工作區的 Azure 訂用帳戶。
   封存至儲存體帳戶	選取 Azure 儲存體帳戶和儲存體帳戶的 Azure 訂用帳戶。 如需詳細資訊，請參閱 將診斷資料傳送至 Azure 儲存體和 Azure 事件中樞。
   串流至事件中樞	選取事件中樞命名空間、事件中樞和事件中樞原則名稱的 Azure 訂用帳戶。 如需詳細資訊，請參閱 將診斷資料傳送至 Azure 儲存體和 Azure 事件中樞 和 Azure 監視器合作夥伴整合。
   傳送至合作夥伴解決方案	選取您的 Azure 訂用帳戶和目的地。 如需詳細資訊，請參閱 Azure 原生 ISV 服務概觀。

   下列範例會選取 Log Analytics 工作區作為目的地：

   

6. 若要完成新增診斷設定，請選取 [ 儲存]。

標準

1. 在 Azure 入口網站中，開啟您的標準邏輯應用程式資源。

2. 在邏輯應用程式資源功能表上的 [ 監視] 底下，選取 [診斷設定]。 在 [ 診斷設定] 頁面上，選取 [ 新增診斷設定]。

   

3. 針對 [診斷設定名稱]，提供您想要用於設定的名稱。

4. 在[記錄>類別]下，選取[工作流程執行時間記錄]。 在 [計量] 底下，選取 [AllMetrics]。

5. 在 [目的地詳細資料] 底下，根據您想要傳送記錄的位置，選取一或多個目的地。

   Destination	方向
   傳送至 Log Analytics 工作區	選取 Log Analytics 工作區和工作區的 Azure 訂用帳戶。
   封存至儲存體帳戶	選取 Azure 儲存體帳戶和儲存體帳戶的 Azure 訂用帳戶。 如需詳細資訊，請參閱 將診斷資料傳送至 Azure 儲存體和 Azure 事件中樞。
   串流至事件中樞	選取事件中樞命名空間、事件中樞和事件中樞原則名稱的 Azure 訂用帳戶。 如需詳細資訊，請參閱 將診斷資料傳送至 Azure 儲存體和 Azure 事件中樞 和 Azure 監視器合作夥伴整合。
   傳送至合作夥伴解決方案	選取您的 Azure 訂用帳戶和目的地。 如需詳細資訊，請參閱 Azure 原生 ISV 服務概觀。

   下列範例會選取 Log Analytics 工作區作為目的地：

   

6. 或者，若要包含 Host.Startup、 Host.Bindings和 Host.LanguageWorkerConfig等事件的遙測，請選取 [ 函式應用程式記錄]。 如需詳細資訊，請參閱 使用 Azure 監視器記錄監視 Azure Functions。

7. 若要完成新增診斷設定，請選取 [ 儲存]。

Azure Logic Apps 現在會將工作流程執行的相關遙測傳送至 Log Analytics 工作區。

注意

啟用診斷設定之後，診斷資料最多可能不會流向指定目的地的記錄 30 分鐘，例如 Log Analytics、儲存體帳戶或事件中樞。 此延遲表示在此時間週期內可能沒有診斷資料可供您檢閱。 已完成的事件和所追蹤的屬性可能會有 10-15 分鐘的時間不會出現在 Log Analytics 工作區中。

檢視工作流程執行狀態

取用

工作流程執行之後，您可以在 Log Analytics 工作區中檢視這些執行的相關資料。

1. 在 Azure 入口網站中，開啟 Log Analytics 工作區。

2. 在工作區功能表上的 [ 傳統] 下，選取 [工作區摘要]。 在 [ 概觀] 頁面上，選取 [Logic Apps 管理]。

   注意

   如果在執行之後，[Logic Apps 管理] 圖格未立即顯示結果，請嘗試選取 [重新整理]，或於短暫等候之後再試一次。

   

   摘要頁面會顯示依名稱或依執行狀態分組的工作流程。 此頁面也會顯示工作流程執行動作或觸發程式中失敗的詳細資料。

   

3. 若要檢視特定工作流程或狀態的所有執行，請選取該工作流程或狀態的資料列。

   此範例顯示特定工作流程的所有執行：

   

   針對新增 追蹤屬性的動作，您可以使用資料行篩選來搜尋追蹤的屬性。 若要檢視屬性，請在 [ 追蹤的屬性 ] 資料行中，選取 [ 檢視]。

   

4. 若要篩選您的結果，您可以執行用戶端和伺服器端篩選。

   • 用戶端篩選：針對每個資料行，選取您想要的篩選條件，例如：

     

   • 伺服器端篩選：若要選取特定時間範圍或限制出現的執行次數，請使用頁面頂端的範圍控制項。 根據預設，一次只能出現 1,000 筆記錄。

     

5. 若要檢視特定執行的所有動作及其詳細資料，請選取邏輯應用程式工作流程執行的資料列。

   下列範例顯示特定邏輯應用程式工作流程執行的所有動作和觸發程式：

   

標準

1. 在 Azure 入口網站中，開啟 Log Analytics 工作區。

2. 在工作區導覽功能表上，選取 [ 記錄]。

3. 在新查詢索引標籤的左側資料行中，展開 [ 資料表] 底下的 [LogManagement]，然後選取 [LogicAppWorkflowRuntime]。

   在右窗格中的 [ 結果] 下，資料表會顯示與下列事件相關的記錄：

   • WorkflowRunStarted
   • WorkflowRunCompleted
   • WorkflowTriggerStarted
   • WorkflowTriggerEnded
   • WorkflowActionStarted
   • WorkflowActionCompleted
   • WorkflowBatchMessageSend
   • WorkflowBatchMessageRelease

   針對已完成的事件， EndTime 資料行會發佈完成事件的時間戳記。 此值可協助您判斷開始事件與已完成事件之間的持續時間。

   

範例查詢

在 Log Analytics 工作區的查詢窗格中，您可以輸入自己的查詢來尋找特定資料，例如：

• 選取特定工作流程執行識別碼的所有事件：

  LogicAppWorkflowRuntime
  | where RunId == "08585258189921908774209033046CU00"
  

• 列出所有例外狀況：

  LogicAppWorkflowRuntime
  | where Error != ""
  | sort by StartTime desc
  

• 識別已經歷重試的動作：

  LogicAppWorkflowRuntime
  | where RetryHistory != ""
  | sort by StartTime desc 
  

將診斷資料傳送至 Azure 儲存體和 Azure 事件中樞

除了 Azure 監視器記錄之外，您可以將收集的資料傳送至其他目的地，例如：

• 將 Azure 資源記錄封存到儲存體帳戶
• 將 Azure 平台記錄串流至 Azure 事件中樞

接著，您可以使用來自其他服務的遙測和分析來取得即時監視，例如 Azure 串流分析和Power BI，例如：

• 將資料從事件中樞串流至串流分析
• 使用串流分析分析串流資料並在 Power BI 中建立即時分析儀表板

注意

只有在使用儲存體帳戶時，才會套用保留期間。

在遙測中包含自訂屬性

在您的工作流程中，觸發程式和動作可讓您新增下列自訂屬性，使其值連同 Log Analytics 工作區中發出的遙測一起顯示。

自訂追蹤識別碼

大部分觸發程式都有 自訂追蹤識別碼 屬性，您可以在其中使用運算式來指定追蹤識別碼。 您可以使用此運算式從接收的訊息承載取得資料，或產生唯一值，例如：

如果您未指定此自訂追蹤識別碼，Azure 會自動產生此識別碼，並將工作流程執行之間的事件相互關聯，包括從父工作流程呼叫的任何巢狀工作流程。 您可以使用觸發程序要求中的自訂識別碼值來傳遞 x-ms-client-tracking-id 標頭，在觸發程序中手動指定此識別碼。 您可以使用要求觸發程式、HTTP 觸發程式或 Webhook 型觸發程式。

取用

標準

追蹤的屬性

動作具有 [追蹤屬性 ] 區段，您可以在其中輸入運算式或硬式編碼值來追蹤特定輸入或輸出，以指定自訂屬性名稱和值，例如：

取用

標準

追蹤的屬性只能追蹤單一動作的輸入和輸出，但您可以使用 correlation 事件的屬性來相互關聯工作流程執行中的動作。

追蹤的屬性只能參考其本身觸發程式或動作的參數、輸入和輸出。

在具有安全輸入、安全輸出或兩者的觸發程式或動作上，不允許追蹤屬性。 它們也不允許參考另一個具有安全輸入、安全輸出或兩者的觸發程式或動作。

下列範例顯示自訂屬性出現在 Log Analytics 工作區的位置：

取用

1. 在 Log Analytics 工作區功能表上，選取 [ 傳統] 底下的 [ 工作區摘要]。 在 [ 概觀] 頁面上，選取 [Logic Apps 管理]。

2. 選取您要檢閱之工作流程的資料列。

3. 在 [ 執行 ] 頁面上的 [邏輯應用程式執行 ] 資料表中，尋找 [追蹤識別碼 ] 資料行和 [追蹤屬性] 資料 行。

   

4. 請可以使用資料行篩選來搜尋追蹤屬性。 若要檢視屬性，請選取 [ 檢視]。

   

標準

自訂追蹤識別碼會出現在 ClientTrackingId 資料 行中，而追蹤的屬性會出現在 TrackedProperties 資料行中，例如：

下一步

• 建立監視和追蹤查詢
• 使用 Azure 監視器記錄監視 B2B 訊息