在 Azure Logic Apps 中設定和檢視 Application Insights 中標準工作流程的增強遙測資料

適用於:Azure Logic Apps (標準)

在 Application Insights 中,您可以啟用標準邏輯應用程式資源的增強遙測資料收集,然後在工作流程完成執行之後檢視收集的資料。 此功能可讓您簡化體驗,以探索工作流程的深入解析,並更能控制資料來源上的篩選事件以協助您降低記憶體成本。 這些改善著重於即時效能計量,可提供您系統健康情況和行為的深入解析。 這可協助您主動偵測並及早解決問題。

透過連線至 Application Insights 的邏輯應用程式,您可以使用即時計量資料流,以近乎即時的方式透過 Azure 入口網站檢視記錄資料和其他計量。 您也可透過視覺效果,協助您繪製傳入要求、傳出要求和整體健康情況,並存取追蹤層級診斷的資料表。

下列清單描述一些範例遙測資料改善:

  • 觸發程序和動作事件現在包含觸發程序或動作類型和 API 名稱,可讓您查詢特定連接器的使用方式。
  • 讓重試事件更容易追蹤。
  • 擷取觸發程序和動作失敗的例外狀況。
  • 更能控制篩選非工作流程相關事件。
  • 進階篩選可讓您更充分控制事件的發出方式,包括觸發程序和動作。

您也可以設定標準邏輯應用程式資源,以 OpenTelemetry 格式匯出記錄和追蹤資料。 根據預設,此遙測資料會使用 Application Insights SDK 傳送至 Application Insights。 不過,您可以選擇使用 OpenTelemetry 語意來匯出此資料。 雖然您仍然可以使用 OpenTelemetry 格式將數據傳送至 Application Insights,但您也可以將相同的數據導出至任何其他符合 OpenTelemetry 規範的端點。 OpenTelemetry 為您的邏輯應用程式提供下列優點:

  • 在主機和應用程式程式代碼中產生之追蹤和記錄之間的相互關聯。
  • 以一致且符合標準的方式產生可匯出的遙測資料。
  • 與其他可取用 OpenTelemetry 相容資料的提供者整合。
  • 在邏輯應用程式資源層級啟用OpenTelemetry,無論是在主機組態 (host.json) 和邏輯應用程式專案中。

本指南說明如何在標準邏輯應用程式的 Application Insights 中開啟增強的遙測資料收集。

先決條件

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

  • Application Insights 執行個體。 當您建立標準邏輯應用程式,或在邏輯應用程式部署之後,事先建立此資源。

  • 標準邏輯應用程式和工作流程,無論是在 Azure 入口網站或 Visual Studio Code 中。

    • 邏輯應用程式資源或專案必須使用預設啟用的 Azure Functions v4 執行階段。

    • 邏輯應用程式必須已啟用 Application Insights 以進行診斷記錄和追蹤。 您可以在建立邏輯應用程式時或在部署之後執行此動作。

在 Application Insights 中啟用增強型遙測

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

  2. 在邏輯應用程式功能表的 [開發工具] 之下,選取 [進階工具]。 在 [進階工具] 頁面上,選取 [開始],這會開啟 Kudu 工具。

  3. 在 [Kudu] 頁面上,從 [偵錯主控台] 功能表中選取 [CMD]。 在資料夾目錄資料表中,瀏覽至下列檔案,然後選取 [編輯]:site/wwwroot/host.json

  4. 在 host.json 檔案中,新增下列 JSON 程式碼:

    {
       "version": "2.0",
       "extensionBundle": {
          "id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
          "version": "[1, 2.00]"
       },
       "extensions": {
          "workflow": {
             "Settings": {
                "Runtime.ApplicationInsightTelemetryVersion": "v2"
             }
          }
       }
    }
    

    此組態會啟用預設的詳細資訊層級。 如需其他選項,請參閱在來源套用篩選。

設定 OpenTelemetry 以進行效能監控

針對部分連接和內部部署的情況,您可以配置您的標準邏輯應用,依據您為特定環境定義的 OpenTelemetry 支援 應用程式設定來傳送遙測數據。 不過,在設定 OpenTelemetry 之前,請考慮目前版本中的下列限制:

  • 目前只有下列觸發程式支援 OpenTelemetry 輸出:HTTP、服務總線和事件中樞

  • 計量導出目前不受支援。

若要在 Azure 入口網站中設定 OpenTelemetry 功能,請依照標準邏輯工作流程的裝載選項執行步驟。

主機選項:工作流程服務計劃或應用服務環境 V3

針對使用 工作流程服務方案 或 App Service 環境 V3 裝載選項的標準邏輯應用程式,請遵循下列步驟來更新邏輯應用程式資源根目錄中 的host.json 檔案:

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

  2. 在資源導覽功能表上的 [ 開發工具] 底下,選取 [ 進階工具>] [移至]。

  3. 在 Kudu+ 控制台中,從 [ 偵錯] 主控台 選單中,選取 [CMD]。 移至 網站>wwwroot。

  4. 編輯 host.json 檔案。 在根層級,使用 OpenTelemetry 值新增下列 telemetryMode 設定,例如:

    {
        "version": "2.0",
        "extensionBundle": {
            "id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
            "version": "[1.*, 2.0.0)"
        },
        "telemetryMode": "OpenTelemetry"
    }
    
  5. 儲存您的編輯。

  6. 在資源導覽功能表上的 [ 設定>環境變數] 底下,選取 [ 應用程式設定]。

  7. 新增下列應用程式設定:

    應用程式設定 描述
    OTEL_EXPORTER_OTLP_ENDPOINT 在線事務處理 (OTLP) 匯出端點 URL,用於傳送遙測數據的位置,例如: https://otel.kloud....

    如需詳細資訊,請參閱 OTEL_EXPORTER_OTLP_ENDPOINT。
    OTEL_EXPORTER_OTLP_HEADERS (選填) 要套用至所有傳出資料的標頭清單。 通常用來將驗證金鑰或權杖傳遞至可檢視性後端,例如 Authorization=sk_....。

    如需詳細資訊,請參閱 OTEL_EXPORTER_OTLP_HEADERS。
  8. 完成時,請選取 [套用]。

  9. 如果您的 OpenTelemetry 端點需要其他 OpenTelemetry 相關設定,請在應用程式設定中包含這些設定。 如需詳細資訊,請參閱 OTLP 匯出工具組態。

主機選項:混合式

針對使用 混合式 裝載選項的標準邏輯應用程式,請遵循對應的步驟來設定 OpenTelemetry:

  1. 在內部部署 SMB 檔案共用的根目錄中,尋找並開啟 host.json 檔案。

  2. 在 host.json 檔案的根層級,使用 OpenTelemetry 值新增下列 telemetryMode 設定,然後儲存您的變更,例如:

    {
        "version": "2.0",
        "extensionBundle": {
            "id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
            "version": "[1.*, 2.0.0)"
        },
        "telemetryMode": "OpenTelemetry"
    }
    
  3. 儲存您的編輯。

  4. 在 Azure 入口網站中,使用 混合式 裝載選項尋找並開啟您的標準邏輯應用程式資源。

  5. 在資源導覽功能表上的 [ 設定] 底下,選取 [ 容器],然後選取 [ 編輯和部署]。

  6. 在 [ 編輯容器 ] 窗格中,選取 [ 環境變數],然後選取 [ 新增 ],以便您可以新增下列應用程式設定:

    名稱 來源 價值觀 描述
    OTEL_EXPORTER_OTLP_ENDPOINT 手動 < OTLP-endpoint-URL> 在線事務處理 (OTLP) 匯出端點 URL,用於傳送遙測數據的位置,例如: https://otel.kloud....

    如需詳細資訊,請參閱 OTEL_EXPORTER_OTLP_ENDPOINT。
    OTEL_EXPORTER_OTLP_HEADERS (選填) 手動 < OTLP 標頭> 要套用至所有傳出資料的標頭清單。 通常用來將驗證金鑰或權杖傳遞至可檢視性後端,例如 Authorization=sk_....。

    如需詳細資訊,請參閱 OTEL_EXPORTER_OTLP_HEADERS。

    下列範例顯示新增至邏輯應用程式資源的指定應用程式設定:

    螢幕螢幕截圖顯示 Azure 入口網站、邏輯應用程式(混合)資源選單(選定設定)、容器、編輯與部署,以及名為環境變數的窗格。

  7. 完成時,選取 [儲存]。

  8. 如果您的 OpenTelemetry 端點需要其他 OpenTelemetry 相關設定,請在應用程式設定中包含這些設定。 如需詳細資訊,請參閱 OTLP 匯出工具組態。

如需詳細資訊,請參閱編輯標準邏輯應用程式的主機和應用程式設定。

開啟 Application Insights

工作流程完成執行並經過幾分鐘之後,請開啟 Application Insights 資源。

  1. 在 Azure 入口網站的邏輯應用程式功能表上,於 [設定] 底下選取 [Application Insights]。

  2. 在 Application Insights 資源功能表上的 [監視] 底下,選取 [記錄]。

在 Application Insights 中檢視增強的記錄

下列各節說明 Application Insights 中的資料表,您可以在其中尋找及檢視從工作流程執行產生的增強式遙測。

資料表名稱 描述
請求 工作流程執行中下列事件的詳細資料:

- 觸發程序和動作事件
- 重試嘗試
- 連接器使用方式
追蹤 工作流程執行中下列事件的詳細資料:

- 工作流程開始和結束事件
- 批次傳送和批次接收事件
例外狀況 工作流程執行中例外狀況事件的詳細資料
相依關係 工作流程執行中相依性事件的詳細資料

要求資料表

要求資料表包含欄位,可追蹤標準工作流程執行中下列事件的相關資料:

  • 觸發程序和動作事件
  • 重試次數
  • 連接器使用方式

若要顯示資料如何進入這些欄位,假設您有下列範例標準工作流程,其開頭為要求觸發程序,後面接著撰寫動作和回應動作。

截圖顯示 Azure 入口網站與標準工作流程設計器,並包含觸發器與動作。

觸發程序的設定具有名為 [自訂追蹤 ID] 的參數。參數值會設定為從傳入訊息本文提取 orderId 屬性值的運算式:

截圖顯示 Azure 入口網站、標準工作流程、已選取的請求觸發器、設定標籤,以及自訂追蹤 ID。

接下來,工作流程的撰寫動作設定已新增名為 solutionName 的追蹤屬性。 屬性值會設定為邏輯應用程式資源的名稱。

螢幕截圖顯示 Azure 入口網站、標準工作流程、已選取的撰寫動作、設定標籤以及追蹤屬性。

撰寫動作後面接著會傳回呼叫者回應的回應動作。

下列清單包含您可以針對要求資料表建立和執行的範例查詢:

任務 步驟
檢視所有觸發程序和動作事件 查詢所有觸發與動作事件
只檢視觸發事件或動作事件 僅查詢觸發或動作事件
檢視具有特定作業類型的觸發程序或動作事件 依作業類型查詢觸發或動作事件
檢視具有特定工作流程執行識別碼的觸發程序和動作事件 依工作流程執行 ID 查詢觸發程序與動作事件
檢視具有特定用戶端追蹤識別碼的觸發程序和動作事件 依客戶端追蹤 ID 查詢觸發與動作事件
檢視具有特定解決方案名稱的觸發程序和動作事件 依解決方案名稱查詢觸發器與動作事件
使用重試嘗試檢視觸發程序和動作事件 查詢重試嘗試的觸發與動作事件
使用連接器使用方式檢視觸發程序和動作事件 查詢連接器使用情況的觸發與動作事件

查詢所有觸發程序和動作事件

在工作流程執行和幾分鐘之後,您可以針對要求資料表建立查詢,以檢視所有作業事件。

  1. 如有必要,請選取您想要檢閱的時間範圍。 根據預設,此值是過去 24 小時。

  2. 若要檢視所有觸發程序和動作事件,請建立並執行下列查詢:

    requests
    | sort by timestamp desc
    | take 10
    

    下列範例顯示 [結果] 索引標籤,其中包含每個資料列中已指出的資料行和資料:

    螢幕擷取圖顯示工作流程執行時的 Application Insights、查詢、結果索引標籤及操作事件。

    資料行 描述 範例
    名稱 工作流程作業名稱 在此範例中,資料列會顯示手動 (要求觸發程序)、撰寫和回應。
    成功 作業執行狀態 在此範例中,所有資料列都會針對成功執行顯示 True。 如果發生錯誤,則值為 False。
    resultCode 作業執行狀態碼 在此範例中,所有資料列都會顯示 Succeeded (200)。
    持續時間 作業執行持續時間 每個作業各有不同。
  3. 若要檢視特定作業的詳細資料,請展開觸發程序或動作的資料列:

    下列範例顯示 [要求] 觸發程序的展開詳細資料:

    螢幕截圖顯示 Application Insights、請求觸發程序的 [結果] 索引標籤及詳細資料。

    屬性 描述 範例
    Category 作業類別目錄,取決於作業一律是 Workflow.Operations.Triggers 或 Workflow.Operations.Actions Workflow.Operations.Triggers。
    clientTrackingId 自訂追蹤識別碼 (如果指定) 123456
    runId 工作流程執行執行個體的識別碼 08585358375819913417237801890CU00
    triggerName 觸發程序名稱 手動
    workflowId 執行觸發程序的工作流程識別碼 c7711d107e6647179c2e15fe2c2720ce
    workflowName 執行觸發程序的工作流程名稱 請求-回應-工作流程
    operation_Name 執行觸發程序的作業名稱。 在此情況下,此名稱與工作流程名稱相同。 請求-回應-工作流程
    operation_Id 剛執行之元件或工作流程的識別碼。 此識別碼與工作流程執行執行個體的 runId 值相同。 如果例外狀況或相依性存在,這個值會超出資料表,讓您可以將此觸發程序記錄連結到這些例外狀況或相依性。 08585358375819913417237801890CU00
    operation_ParentId 呼叫觸發程序之工作流程的可連結識別碼 f95138daff8ab129

    下列範例顯示撰寫動作的展開詳細資料:

    螢幕擷取圖顯示 Application Insights、撰寫動作的結果標籤及詳細資訊。

    屬性 描述 範例
    Category 作業類別目錄,取決於作業一律是 Workflow.Operations.Triggers 或 Workflow.Operations.Actions Workflow.Operations.Actions
    clientTrackingId 自訂追蹤識別碼 (如果指定) 123456
    actionName 動作名稱 撰寫
    runId 工作流程執行執行個體的識別碼 08585358375819913417237801890CU00
    workflowId 執行動作之工作流程的識別碼 c7711d107e6647179c2e15fe2c2720ce
    workflowName 執行動作之工作流程的名稱 請求-回應-工作流程
    solutionName 追蹤的屬性名稱 (如果指定) LA-AppInsights
    operation_Name 執行動作之作業的名稱。 在此情況下,此名稱與工作流程名稱相同。 請求-回應-工作流程
    operation_Id 剛執行之元件或工作流程的識別碼。 此識別碼與工作流程執行執行個體的 runId 值相同。 如果例外狀況或相依性存在,這個值會超出資料表,讓您可以將此動作記錄連結到這些例外狀況或相依性。 08585358375819913417237801890CU00
    operation_ParentId 呼叫動作之工作流程的可連結識別碼 f95138daff8ab129

只查詢觸發程序或動作事件

您可以根據作業類別和工作流程名稱,針對要求資料表建立查詢,以檢視作業事件的子集。

  1. 如有必要,請選取您想要檢閱的時間範圍。 根據預設,此值是過去 24 小時。

  2. 若要檢視特定工作流程中的所有觸發程序事件,請將 customDimensions.Category 屬性值設定為 Workflow.Operations.Triggers 以及 operation_Name 設定為工作流程名稱來建立並執行查詢,例如:

    requests
    | where customDimensions.Category == "Workflow.Operations.Triggers" and operation_Name == "Request-Response-Workflow"
    

    截圖顯示僅針對觸發器的請求表查詢。

  3. 若要檢視特定工作流程中的所有動作事件,請將 customDimensions.Category 屬性值設定為 Workflow.Operations.Actions 以及 operation_Name 設定為工作流程名稱來建立查詢,例如:

    requests
    | where customDimensions.Category == "Workflow.Operations.Actions" and operation_Name == "Request-Response-Workflow"
    

    螢幕擷取圖顯示僅用於動作的請求表查詢。

依作業類型查詢觸發程序或動作事件

您可以針對要求資料表建立查詢,以檢視特定觸發程序或動作類型的事件。

  1. 如有必要,請選取您想要檢閱的時間範圍。 根據預設,此值是過去 24 小時。

  2. 若要檢視具有特定觸發程序類型的所有作業事件,請建立並執行查詢,並將 customDimensions.triggerType 值設定為您想要的觸發程序類型,例如:

    requests
    | where customDimensions.triggerType == "Request"
    

    螢幕擷取圖顯示 Requests 資料表中 Request 觸發程序類型的查詢。

  3. 若要檢視具有特定動作類型的所有作業事件,請將 customDimensions.actionType 值設定為您想要的動作類型來建立並執行查詢,例如:

    requests
    | where customDimensions.actionType == "Compose"
    

    螢幕截圖顯示 Compose 動作類型的請求表查詢。

依工作流程執行識別碼查詢觸發程序和動作事件

您可以根據工作流程執行識別碼,針對要求資料表建立查詢,以檢視作業事件的子集。 此工作流程執行識別碼與您在工作流程的執行歷程記錄中找到的識別碼相同。

  1. 如有必要,請選取您想要檢閱的時間範圍。 根據預設,此值是過去 24 小時。

  2. 若要檢視具有特定工作流程執行識別碼的所有作業事件,請建立並執行查詢,並將 operation_Id 值設定為工作流程執行識別碼,例如:

    requests
    | where operation_Id == "08585287554177334956853859655CU00"
    

    螢幕截圖顯示基於工作流程執行 ID 的請求表查詢。

依用戶端追蹤識別碼查詢觸發程序和動作事件

您可以根據工作流程名稱和用戶端追蹤識別碼,針對要求資料表建立查詢,以檢視作業事件的子集。

  1. 如有必要,請選取您想要檢閱的時間範圍。 根據預設,此值是過去 24 小時。

  2. 若要檢視特定工作流程中具有特定用戶端追蹤識別碼的所有作業事件,請將 operation_Name 值設定為工作流程名稱,以及 clientTrackingId 屬性值設定為您想要的值來建立並執行查詢,例如:

    requests
    | where operation_Name == "Request-Response-Workflow"
    | extend correlation = todynamic(tostring(customDimensions.correlation))
    | where correlation.clientTrackingId == "123456"
    

    螢幕擷取圖顯示使用操作名稱與用戶端追蹤 ID 進行查詢結果。

依方案名稱查詢觸發程序和動作事件

您可以根據工作流程名稱和方案名稱,針對要求資料表建立查詢,以檢視作業事件的子集。

  1. 如有必要,請選取您想要檢閱的時間範圍。 根據預設,此值是過去 24 小時。

  2. 若要檢視特定工作流程中具有特定用戶端追蹤識別碼的所有作業事件,請將 operation_Name 值設定為工作流程名稱,以及 solutionName 屬性值設定為您想要的值來建立並執行查詢,例如:

    requests
    | where operation_Name == "Request-Response-Workflow" and customDimensions has "trackedProperties"
    | extend trackedProperties = todynamic(tostring(customDimensions.trackedProperties))
    | where trackedProperties.solutionName == "LA-AppInsights"
    

    螢幕截圖顯示使用作業名稱與解決方案名稱進行查詢結果。

重試次數

為了顯示此資料如何進入要求資料表,下列範例標準工作流程會使用呼叫不會解析之 URL 的 HTTP 動作。 工作流程也有一個重試原則設定為固定間隔,每 60 秒重試三次。

截圖顯示 Azure 入口網站、標準工作流程、選取的 HTTP 動作、設定標籤及重試原則。

重試嘗試的查詢觸發程序和動作事件

您可以針對要求資料表建立查詢,以使用重試嘗試來檢視作業事件的子集。

  1. 如有必要,請選取您想要檢閱的時間範圍。 根據預設,此值是過去 24 小時。

  2. 若要只檢視具有重試歷程記錄的觸發程序和動作事件,請在 Application Insights 中建立並執行下列查詢:

    requests
    | extend retryHistory = tostring(tostring(customDimensions.retryHistory))
    | where isnotempty(retryHistory)
    
  3. 若要使用重試原則檢視特定作業的重試嘗試,請展開該作業的資料列。

    下列範例顯示 HTTP 動作的展開詳細資料:

    螢幕擷取圖顯示 Application Insights、HTTP 動作的結果標籤及詳細資訊。

    success 和 resultCode 屬性值表示 HTTP 動作失敗。 除了查詢所有觸發程序和動作事件的要求資料表中所述的屬性,記錄包含下列資訊,其中包括三次重試嘗試:

    屬性 描述 範例
    retryHistory 一或多個重試嘗試的歷程記錄詳細資料
    代碼 特定重試嘗試的錯誤類型
    錯誤 發生之特定錯誤的詳細資料

連接器使用方式的查詢觸發程序和動作事件

您可以根據特定的連接器使用方式,針對要求資料表建立查詢,以檢視作業事件的子集。

  1. 如有必要,請選取您想要檢閱的時間範圍。 根據預設,此值是過去 24 小時。

  2. 若要使用特定連接器類型來檢視所有觸發程序事件,請使用下列屬性和值建立並執行查詢:

    requests
    | where customDimensions.Category == "Workflow.Operations.Triggers" and customDimensions.triggerType =="ApiConnectionWebhook" and customDimensions.apiName =="commondataservice"
    
    屬性 範例值
    customDimensions.Category Workflow.Operations.Triggers
    customDimensions.triggerType 作業類型,例如 ApiConnectionWebhook
    customDimensions.apiName JSON 格式的連接器 API 名稱,例如 Microsoft Dataverse 連接器的 commondataservice

    螢幕擷取畫面顯示 Application Insights 中具有 ApiConnectionWebhook 連線的 Microsoft Dataverse 觸發事件的 [結果] 索引標籤。

  3. 若要檢視具有特定連接器使用方式的所有動作事件,請將 customDimensions.Category 值設定為 Workflow.Operations.Actions、customDimensions.triggerType 值設定為作業類型,以及 customDimensions.apiName 設定為 JSON 格式的連接器 API 名稱來建立並執行查詢,例如:

    屬性 範例值
    customDimensions.Category Workflow.Operations.Actions
    customDimensions.triggerType 作業類型,例如 ApiConnection
    customDimensions.apiName JSON 格式的連接器 API 名稱,例如 Microsoft Office 365 Outlook 連接器的 office365
    requests
    | where customDimensions.Category == "Workflow.Operations.Actions" and customDimensions.actionType == "ApiConnection" and customDimensions.apiName == "office365"
    

    螢幕擷取圖顯示應用程式洞察中,Results 標籤中包含 ApiConnection 連線的 Microsoft Office 365 Outlook 動作事件。

針對觸發程序和動作,Application Insights 會區分存在的連線類型。 您可以根據連線是否有 ApiConnection、ApiConnectionWebhook、要求等內建基本類型,或內建服務提供者型 ServiceProvider 類型,在 [actionType] 和 [triggerType] 欄位中看到不同的值。

追蹤資料表

追蹤資料表包含欄位,可追蹤標準工作流程執行中下列事件的相關資料:

下列清單包含您可以針對追蹤資料表建立和執行的範例查詢:

任務 步驟
檢視所有工作流程執行的開始和結束事件 查詢所有工作流程執行中的開始與結束事件
檢視特定工作流程執行的開始和結束事件 查詢工作流程執行中的開始與結束事件
檢視所有工作流程執行中的批次傳送和接收事件 查詢所有工作流程執行中的批次發送與批次接收事件

查詢所有工作流程執行的開始和結束事件

您可以針對追蹤資料表建立查詢,以檢視所有工作流程執行的所有開始和結束事件。

  1. 如有必要,請選取您想要檢閱的時間範圍。 根據預設,此值是過去 24 小時。

  2. 請將 customDimensions.Category 值設定為 Workflow.Operations.Runs 來建立並執行查詢,例如:

    traces
    | where customDimensions.Category == "Workflow.Operations.Runs"
    

    螢幕擷取畫面顯示 Application Insights 中的 [結果] 索引標籤,其中顯示所有工作流程執行的開始事件與事件。

查詢特定工作流程執行的開始和結束事件

您可以針對追蹤資料表建立查詢,以檢視特定工作流程執行的開始和結束事件。

  1. 如有必要,請選取您想要檢閱的時間範圍。 根據預設,此值是過去 24 小時。

  2. 請將 customDimensions.Category 值設定為 Workflow.Operations.Run,並將 operation_Id 值設定為工作流程執行識別碼來建立並執行查詢,例如:

    traces
    | where customDimensions.Category == "Workflow.Operations.Runs"
    | and operation_Id == "08585287571846573488078100997CU00"
    

    螢幕擷取圖顯示 Application Insights、特定執行的啟動和事件結果索引標籤。

查詢所有工作流程執行中的批次傳送和批次接收事件

您可以針對追蹤資料表建立查詢,以檢視所有工作流程執行中的批次傳送和批次接收事件。

  1. 如有必要,請選取您想要檢閱的時間範圍。 根據預設,此值是過去 24 小時。

  2. 請將 customDimensions.Category 值設定為 Workflow.Operations.Run,並將 operation_Id 值設定為工作流程執行識別碼來建立並執行查詢,例如:

    traces
    | where customDimensions.Category == "Workflow.Operations.Batch"
    

    螢幕螢幕顯示在所有工作流程執行中,應用程式洞察(Application Insights)中批次傳送與批次接收事件的結果標籤。

例外狀況資料表

例外狀況資料表包含欄位,可追蹤標準工作流程執行中例外狀況事件的相關資料。 若要顯示資料如何進入這些欄位,假設您有下列範例標準工作流程,其開頭為要求觸發程序,後面接著撰寫動作和回應動作。 撰寫動作會使用將值除以零的運算式,這會產生例外狀況:

螢幕擷取圖顯示 Azure 入口網站、標準工作流程設計器、請求觸發器、包含例外產生表達式的撰寫動作,以及回應動作。

查詢所有工作流程執行中的例外狀況事件

您可以針對例外狀況資料表建立查詢,以檢視所有工作流程執行中的例外狀況事件。

  1. 如有必要,請選取您想要檢閱的時間範圍。 根據預設,此值是過去 24 小時。

  2. 若要檢視所有例外狀況事件,請在 Application Insights 中建立並執行下列查詢:

    exceptions
    | sort by timestamp desc
    
  3. 若要檢視特定例外狀況的詳細資料,請展開該例外狀況的資料列:

    下列範例顯示撰寫動作的展開例外狀況,以及例外狀況的詳細資料:

    螢幕擷取畫面顯示 Application Insights、例外事件的 [結果] 索引標籤(其中已展開 Compose 動作的例外事件),以及例外詳細資料。

    屬性 描述
    problemId 例外狀況類型,或發生例外狀況的簡短描述
    outerMessage 例外狀況的更詳細描述
    細節 例外狀況的詳細資訊和最完整的資訊
    clientTrackingId 用戶端追蹤識別碼 (如果指定)
    workflowId 發生例外狀況之工作流程的識別碼
    workflowName 發生例外狀況之工作流程的名稱
    runId 工作流程執行執行個體的識別碼
    actionName 例外狀況失敗之動作的名稱
    operation_Name 發生例外狀況之工作流程的名稱
    operation_Id 剛執行之元件或工作流程的識別碼。 此識別碼與工作流程執行執行個體的 runId 值相同。 此值超出資料表,因此您可以將此例外狀況記錄與工作流程執行執行個體連結。
    operation_ParentId 呼叫動作之工作流程的識別碼,您可以在要求資料表中連結到動作的識別碼
  4. 若要檢視特定工作流程的例外狀況,請建立並執行下列查詢:

    exceptions
    | where operation_Name contains "Request-Response-Workflow-Exception"
    

相依性資料表

相依性資料表包含欄位,可追蹤標準工作流程執行中相依性事件的相關資料。 當某個資源呼叫另一個資源,且這兩個資源都使用 Application Insights 時,就會發出這些事件。 Azure Logic Apps 的範例包括透過 HTTP、資料庫或檔案系統呼叫另一個服務的服務。 Application Insights 會測量相依性呼叫的持續時間,以及這些呼叫是否成功或失敗,以及相依性名稱等資訊。 您可以調查特定的相依性呼叫,然後將其與要求和例外狀況相互關聯。

若要顯示資料如何進入這些欄位,假設您有下列使用 HTTP 動作透過 HTTP 呼叫子工作流程的標準父工作流程範例:

截圖顯示 Azure 入口網站,標準工作流程設計器,父工作流程使用 HTTP 動作呼叫子工作流程。

查詢特定工作流程中的相依性事件

您可以針對相依性資料表建立查詢,以檢視特定工作流程執行中的相依性事件。

  1. 如有必要,請選取您想要檢閱的時間範圍。 根據預設,此值是過去 24 小時。

  2. 若要檢視父工作流程與子工作流程之間的相依性事件,請建立並執行下列查詢:

    union requests, dependencies
    | where operation_Id contains "<runId>"
    

    此查詢會使用 union 運算子,從要求資料表和相依性資料表傳回記錄。 查詢也會使用 operation_Id 屬性值,藉由指定您想要的工作流程 runId 值來提供記錄之間的連結,例如:

    union requests, dependencies
    | where operation_Id contains "08585355753671110236506928546CU00"
    

    下列範例顯示指定工作流程的相依性事件,包括來自要求資料表之父工作流程中作業事件的記錄,以及相依性資料表的相依性記錄:

    螢幕擷取圖顯示應用程式洞察的「結果」標籤,並顯示特定工作流程的相依事件。

    針對作業事件記錄,itemType 資料行會將其記錄類型顯示為要求。 針對相依性記錄,itemType 資料行會指出記錄類型為相依性。

    屬性 描述
    runId 工作流程執行執行個體的識別碼
    actionName 發生相依性事件所在動作的名稱
    operation_Id 指定工作流程的識別碼。 此識別碼與工作流程執行執行個體的 runId 值相同。 這個值超出資料表,讓您可以連結此相依性記錄與工作流程執行執行個體。
    operation_ParentId 發生相依性事件所在動作的識別碼,這也會將作業事件記錄和相依性事件記錄連結在一起

使用查詢時,您也可以在 Application Insights 中使用應用程式對應時,將父工作流程的相依性呼叫視覺化至子工作流程。 查詢中的 operation_Id 值會提供連結,讓此視覺效果成為可能。

若要開啟應用程式對應,請在 Application Insights 資源功能表上的 [調查] 底下,選取 [應用程式對應]。

螢幕截圖顯示應用程式洞察與應用程式映射,並顯示父工作流程與子工作流程之間的相依關係。

篩選事件

在 Application Insights 中,您可以透過下列方式篩選事件:

  • 如先前各節所述,建立並執行查詢。

  • 藉由指定要在發出事件之前評估的準則來篩選來源。

    藉由在來源套用篩選,您可以減少所需的儲存體數量,以及因此產生的營運成本。

在來源套用篩選

在要求資料表或追蹤資料表中,記錄具有名為 customDimensions 的節點,其中包含類別屬性。 例如,在要求資料表中,批次觸發程序事件的要求記錄看起來類似下列範例:

螢幕截圖顯示 Application Insights 中的 Requests 資料表,以及批次訊息觸發事件的記錄。

在 [要求] 資料表中,下列類別屬性值可協助您區分和關聯不同的詳細資訊層級:

類別值 描述
Workflow.Operations.Triggers 識別觸發程序事件的要求記錄
Workflow.Operations.Actions 識別動作事件的要求記錄

針對每個類別值,您可以在邏輯應用程式資源或專案的 host.json 檔案中,獨立設定詳細資訊層級。 例如,若要只傳回發生錯誤的觸發程序或動作事件的記錄,請在 host.json 檔案中新增下列記錄 JSON 物件,其中包含具有所需詳細資訊層級的 logLevel JSON 物件:

{
   "logging": {
      "logLevel": {
         "Workflow.Operations.Actions": "Error",
         "Workflow.Operations.Triggers": "Error"
      }
   }
}

針對追蹤資料表記錄,下列範例顯示您可以變更事件詳細資訊層級的方式:

{
   "logging": {
      "logLevel": {
         "Workflow.Host": "Warning",
         "Workflow.Jobs": "Warning",
         "Workflow.Runtime": "Warning"
      }
   }
}

下列範例會將記錄的預設詳細資訊層級設定為警告,但會將詳細資訊層級保留在觸發程序、動作和工作流程執行事件的資訊層級:

{
   "logging": {
      "logLevel": {
         "default": "Warning",
         "Workflow.Operations.Actions": "Information",
         "Workflow.Operations.Runs": "Information",
         "Workflow.Operations.Triggers": "Information"
      }
   }
}

如果您未指定任何 logLevel 值,則預設的詳細資訊層級為資訊。 如需詳細資訊,請參閱設定記錄等級。

移除儲存體相依性錯誤

若要篩選出儲存體相依性錯誤,例如 404 找不到錯誤和 412 先決條件失敗錯誤,請將 Host.Workflow 記錄層級設定為 None,例如:

{
   "logging": {
      "logLevel": {
         "Workflow.Host": "Warning",
         "Workflow.Jobs": "Warning",
         "Workflow.Runtime": "Warning",
         "Host.Workflow": "None"
      }
   }
}
  1. 在 Azure 入口網站中,開啟您的標準邏輯應用程式資源。

  2. 在邏輯應用程式功能表的 [開發工具] 之下,選取 [進階工具]。 在 [進階工具] 頁面上,選取 [開始],這會開啟 Kudu 工具。

  3. 在 [Kudu] 頁面上,從 [偵錯主控台] 功能表中選取 [CMD]。 在資料夾目錄資料表中,瀏覽至下列檔案,然後選取 [編輯]:site/wwwroot/host.json

  4. 在 host.json 檔案中,新增記錄 JSON 物件,並將 logLevel 值設定為您想要的詳細資訊層級:

    {
       "logging": {
          "logLevel": {
             "Workflow.Operations.Actions": "<verbosity-level>",
             "Workflow.Operations.Triggers": "<verbosity-level>"
          }
       }
    }
    

在 Application Insights 中檢視工作流程計量

透過 Application Insights 中的遙測增強功能,您也可以在 [計量] 儀表板中取得工作流程深入解析。

開啟 [計量] 儀表板並設定基本篩選

  1. 在 Azure 入口網站中,如果尚未開啟,請開啟 Application Insights 資源。

  2. 在 Application Insights 資源功能表上的 [監視] 底下,選取 [計量]。

  3. 從 [範圍] 清單中,選取您的 Application Insights 執行個體。

  4. 從 [計量命名空間] 清單中,選取 [workflow.operations]。

  5. 從 [計量] 清單中,選取計量,例如 [完成的執行]。

  6. 從 [彙總] 清單中,選取類型,例如 [計數] 或 [平均值]。

    當您完成時,[計量] 儀表板會顯示已完成工作流程執行的圖表。

    螢幕螢幕顯示應用程式洞察與指標儀表板及圖表,顯示完成工作流程執行次數隨時間變化。

根據特定工作流程進行篩選

當您在 [計量] 儀表板中啟用多維度計量時,可以將 Application Insights 中擷取的整體事件子集設為目標,並根據特定工作流程來篩選事件。

  1. 在您的 Application Insights 資源上,啟用多維度計量。

  2. 在 Application Insights 中,開啟 [計量] 儀表板。

  3. 在圖表工具列上,選取 [新增篩選]。

  4. 從 [屬性] 清單中,選取 [工作流程]。

  5. 從 [運算子] 清單中,選取等號 (=)。

  6. 從 [值] 清單中,選取您想要的工作流程。

    螢幕截圖顯示 Application Insights 的指標儀表板與多維度指標圖表。

檢視「即時」記錄資料和計量

啟用 Application Insights 增強式遙測之後,您可以在 Azure 入口網站中檢視來自 Application Insights 執行個體的近即時記錄資料和其他計量。 您可以使用此視覺效果來繪製輸入要求、輸出要求和整體健康情況。 您也會取得追蹤層級診斷的資料表。

  1. 在 Azure 入口網站中,如果尚未開啟,請開啟 Application Insights 資源。

  2. 在 Application Insights 資源功能表上的 [調查] 底下,選取 [即時計量]。

    [即時計量] 頁面會顯示記錄資料和其他計量,例如:

    螢幕擷取圖顯示 Azure 入口網站與應用程式洞察選單,並選取名為「Live metrics」的項目。

如需詳細資訊,請參閱即時計量︰延遲僅 1 秒的監視與診斷。

附註

由於標準邏輯應用程式工作流程是以 Azure Functions 為基礎,即時計量支援這些邏輯應用程式工作流程。

從應用程式記錄檔串流和檢視偵錯輸出

啟用 Application Insights 增強式遙測之後,您可以在 Azure 入口網站中,針對應用程式的記錄檔串流詳細資訊偵錯資訊。 這項資訊相當於在本機 Visual Studio Code 環境中偵錯工作流程所產生的輸出。

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

  2. 在邏輯應用程式資源功能表上的 [監視] 底下,選取 [記錄資料流]。

    [記錄資料流] 頁面會連線到 Application Insights 執行個體,並顯示偵錯輸出。 例如,下列輸出包含其他資訊之間的要求和回應呼叫:

    截圖顯示 Azure 入口網站與標準邏輯應用程式選單,並選取名為「日誌串流」的項目。

在邏輯應用程式 Insights 刀鋒視窗中檢視執行

啟用 Application Insights 後,您也可以在 Azure 入口網站的 Logic Apps Insights 刀鋒視窗下檢視 Runs。 必須滿足某些先決條件,Runs 才會顯示。

  1. 必須在 host.json啟用 Application Insights V2 整合。

{ "version": "2.0", "extensionBundle": { "id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows", "version": " [1, 2.00) " }, "extensions": { "workflow": { "Settings": { "Runtime.ApplicationInsightTelemetryVersion": "v2" } } } }

  1. 如果您在「執行」索引標籤下看不到工作流程清單,很可能是這個邏輯應用程式缺少了一個標籤。

名稱:隱藏連結:/app-insights-resource-id 值:/subscriptions/{subscriptionid}/resourceGroups/{resourcegroupname}/providers/microsoft.insights/components/{applicationinsightsname}

只有當您直接從入口網站的 Logic App 頁面中的 Application Insights 刀鋒建立 Application Insights 實例,或在建立 Logic App 時建立 Insights 實例時,此標籤才會自動新增。 如果您選擇現有的 Application Insights 實例,就不會新增此標籤。 您可以在概觀刀鋒視窗上的 JSON 檢視中檢查,以確認您的邏輯應用程式是否包含此標籤。

如果 Logic 應用程式沒有此標籤,您可以使用以下 PowerShell 方法來新增它。 請注意,您將無法透過 Azure 入口網站新增該標籤。

  1. 開啟 PowrShell 視窗並執行 “Install-Module -Name Az -AllowClobber -Scope CurrentUser”。 完成後關上視窗。

  2. 開啟另一個 PowerShell window 並執行:New-AzTag -ResourceId "/subscriptions/{subscriptionid}/resourceGroups/{resourcegroupid}/providers/Microsoft.Web/sites/{logicappname}" -Tag @{ "hidden-link: /app-insights-resource-id" = "/subscriptions/{subscriptionid}/resourceGroups/{resourcegroupname}/providers/microsoft.insights/components/{applicationinsightsname}" }

後續步驟

啟用或開啟 Application Insights