monitor-logic-apps-log-analytics.md

title	description	services	ms.suite	ms.reviewer	ms.topic	ms.date
Monitor logic apps by using Azure Monitor logs	Troubleshoot logic apps by setting up Azure Monitor logs and collecting diagnostics data for Azure Logic Apps	logic-apps	integration	divswa, logicappspm	article	09/24/2020

Set up Azure Monitor logs and collect diagnostics data for Azure Logic Apps

To get richer debugging information about your logic apps during runtime, you can set up and use Azure Monitor logs to record and store information about runtime data and events, such as trigger events, run events, and action events in a Log Analytics workspace. Azure Monitor helps you monitor your cloud and on-premises environments so that you can more easily maintain their availability and performance. By using Azure Monitor logs, you can create log queries that help you collect and review this information. You can also use this diagnostics data with other Azure services, such as Azure Storage and Azure Event Hubs.

To set up logging for your logic app, you can enable Log Analytics when you create your logic app, or you can install the Logic Apps Management solution in your Log Analytics workspace for existing logic apps. This solution provides aggregated information for your logic app runs and includes specific details such as status, execution time, resubmission status, and correlation IDs. Then, to enable logging and creating queries for this information, set up Azure Monitor logs.

This article shows how to enable Log Analytics on new logic apps and existing logic apps, how to install and set up the Logic Apps Management solution, and how to set up and create queries for Azure Monitor logs.

Prerequisites

Before you start, you need a Log Analytics workspace. If you don't have a workspace, learn how to create a Log Analytics workspace.

Enable Log Analytics for new logic apps

You can turn on Log Analytics when you create your logic app.

1. In the Azure portal, on the pane where you provide the information to create your logic app, follow these steps:

   1. Under Log Analytics, select On.

   2. From the Log Analytics workspace list, select the workspace where you want to send the data from your logic app runs.

      

      After you finish this step, Azure creates your logic app, which is now associated with your Log Analytics workspace. Also, this step automatically installs the Logic Apps Management solution in your workspace.

2. When you're done, select Create.

3. After you run your logic app, to view your logic app runs, continue with these steps.

Install Logic Apps Management solution

If you turned on Log Analytics when you created your logic app, skip this step. You already have the Logic Apps Management solution installed in your Log Analytics workspace.

1. In the Azure portal's search box, enter log analytics workspaces, and then select Log Analytics workspaces.

   

2. Under Log Analytics workspaces, select your workspace.

   

3. On the Overview pane, under Get started with Log Analytics > Configure monitoring solutions, select View solutions.

   

4. Under Overview, select Add.

   

5. After the Marketplace opens, in the search box, enter logic apps management, and select Logic Apps Management.

   

6. On the solution description pane, select Create.

   

7. Review and confirm the Log Analytics workspace where you want to install the solution, and select Create again.

   

   After Azure deploys the solution to the Azure resource group that contains your Log Analytics workspace, the solution appears on your workspace's summary pane.

   

Set up Azure Monitor logs

When you store information about runtime events and data in Azure Monitor logs, you can create log queries that help you find and review this information.

Note

After you enable diagnostics settings, diagnostics data might not flow for up to 30 minutes to the logs at the specified destination, such as Log Analytics, event hub, or storage account. This delay means that diagnostics data from this time period might not exist for you to review. Completed events and tracked properties might not appear in your Log Analytics workspace for 10-15 minutes.

1. In the Azure portal, find and select your logic app.

2. On your logic app menu, under Monitoring, select Diagnostic settings > Add diagnostic setting.

   

3. To create the setting, follow these steps:

   1. Provide a name for the setting.

   2. Select Send to Log Analytics.

   3. For Subscription, select the Azure subscription that's associated with your Log Analytics workspace.

   4. For Log Analytics Workspace, select the workspace that you want to use.

   5. Under log, select the WorkflowRuntime category, which specifies the event category that you want to record.

   6. To select all metrics, under metric, select AllMetrics.

   7. When you're done, select Save.

   For example:

   

View logic app runs status

After your logic app runs, you can view the data about those runs in your Log Analytics workspace.

1. In the Azure portal, find and open your Log Analytics workspace.

2. On your workspace's menu, select Workspace summary > Logic Apps Management.

   

   [!NOTE] If the Logic Apps Management tile doesn't immediately show results after a run, try selecting Refresh or wait for a short time before trying again.

   Here, your logic app runs are grouped by name or by execution status. This page also shows details about failures in actions or triggers for the logic app runs.

   

3. To view all the runs for a specific logic app or status, select the row for that logic app or status.

   Here is an example that shows all the runs for a specific logic app:

   

   [!NOTE] The Resubmit capability on this page is currently unavailable.

   For actions where you set up tracked properties, you can also view those properties by selecting View in the Tracked Properties column. To search the tracked properties, use the column filter.

   

4. To filter your results, you can perform both client-side and server-side filtering.

   • Client-side filter: For each column, select the filters that you want, for example:

     

   • Server-side filter: To select a specific time window or to limit the number of runs that appear, use the scope control at the top of the page. By default, only 1,000 records appear at a time.

     

5. To view all the actions and their details for a specific run, select the row for a logic app run.

   Here is an example that shows all the actions and triggers for a specific logic app run:

   

Send diagnostic data to Azure Storage and Azure Event Hubs

Along with Azure Monitor logs, you can extend how you use your logic app's diagnostic data with other Azure services, for example:

• Archive Azure resource logs to storage account
• Stream Azure platform logs to Azure Event Hubs

You can then get real-time monitoring by using telemetry and analytics from other services, like Azure Stream Analytics and Power BI. For example:

• Stream data from Event Hubs to Stream Analytics
• Analyze streaming data with Stream Analytics and create a real-time analytics dashboard in Power BI

Based on the locations where you want to send diagnostic data, make sure that you first create an Azure storage account or create an Azure event hub. You can then select the destinations where you want to send that data. Retention periods apply only when you use a storage account.

Azure Monitor diagnostics events

Each diagnostic event has details about your logic app and that event, for example, the status, start time, end time, and so on. To programmatically set up monitoring, tracking, and logging, you can use this information with the REST API for Azure Logic Apps and the REST API for Azure Monitor. You can also use the clientTrackingId and trackedProperties properties, which appear in

• clientTrackingId: If not provided, Azure automatically generates this ID and correlates events across a logic app run, including any nested workflows that are called from the logic app. You can manually specify this ID in a trigger by passing a x-ms-client-tracking-id header with your custom ID value in the trigger request. You can use a request trigger, HTTP trigger, or webhook trigger.

• trackedProperties: To track inputs or outputs in diagnostics data, you can add a trackedProperties section to an action either by using the Logic App Designer or directly in your logic app's JSON definition. Tracked properties can track only a single action's inputs and outputs, but you can use the correlation properties of events to correlate across actions in a run. To track more than one property, one or more properties, add the trackedProperties section and the properties that you want to the action definition.

  Here's an example that shows how the Initialize variable action definition includes tracked properties from the action's input where the input is an array, not a record.

  {
     "Initialize_variable": {
        "type": "InitializeVariable",
        "inputs": {
           "variables": [
              {
                 "name": "ConnectorName", 
                 "type": "String", 
                 "value": "SFTP-SSH" 
              }
           ]
        },
        "runAfter": {},
        "trackedProperties": { 
           "myTrackedPropertyName": "@action().inputs.variables[0].value"
        }
     }
  }

  This example show multiple tracked properties:

  "HTTP": {
     "type": "Http",
     "inputs": {
        "body": "@triggerBody()",
        "headers": {
           "Content-Type": "application/json"
        },
        "method": "POST",
        "uri": "http://store.fabrikam.com",
     },
     "runAfter": {},
     "trackedProperties": {
        "myActionHTTPStatusCode": "@action()['outputs']['statusCode']",
        "myActionHTTPValue": "@action()['outputs']['body']['<content>']",
        "transactionId": "@action()['inputs']['body']['<content>']"
     }
  }

This example shows how the ActionCompleted event includes the clientTrackingId and trackedProperties attributes:

{
   "time": "2016-07-09T17:09:54.4773148Z",
   "workflowId": "/subscriptions/XXXXXXXXXXXXXXX/resourceGroups/MyResourceGroup/providers/Microsoft.Logic/workflows/MyLogicApp",
   "resourceId": "/subscriptions/<subscription-ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Logic/workflows/MyLogicApp/runs/<run-ID>/actions/Http",
   "category": "WorkflowRuntime",
   "level": "Information",
   "operationName": "Microsoft.Logic/workflows/workflowActionCompleted",
   "properties": {
      "$schema": "2016-06-01",
      "startTime": "2016-07-09T17:09:53.4336305Z",
      "endTime": "2016-07-09T17:09:53.5430281Z",
      "status": "Succeeded",
      "code": "OK",
      "resource": {
         "subscriptionId": "<subscription-ID>",
         "resourceGroupName": "MyResourceGroup",
         "workflowId": "<logic-app-workflow-ID>",
         "workflowName": "MyLogicApp",
         "runId": "08587361146922712057",
         "location": "westus",
         "actionName": "Http"
      },
      "correlation": {
         "actionTrackingId": "e1931543-906d-4d1d-baed-dee72ddf1047",
         "clientTrackingId": "<my-custom-tracking-ID>"
      },
      "trackedProperties": {
         "myTrackedPropertyName": "<value>"
      }
   }
}

Next steps

• Create monitoring and tracking queries
• Monitor B2B messages with Azure Monitor logs