Monitor run status, review trigger history, and set up alerts for Azure Logic Apps

After you create and run a logic app, you can check that logic app's run status, runs history, trigger history, and performance. To get notifications about failures or other possible problems, set up alerts. For example, you can create an alert that detects "when more than five runs fail in an hour."

For real-time event monitoring and richer debugging, set up diagnostics logging for your logic app by using Azure Monitor logs. This Azure service helps you monitor your cloud and on-premises environments so that you can more easily maintain their availability and performance. You can then find and view events, such as trigger events, run events, and action events. By storing this information in Azure Monitor logs, you can create log queries that help you find and analyze this information. You can also use this diagnostic data with other Azure services, such as Azure Storage and Azure Event Hubs. For more information, see Monitor logic apps by using Azure Monitor.

Note

If your logic apps run in an integration service environment (ISE) that was created to use an internal access endpoint, you can view and access inputs and outputs from logic app's runs history only from inside your virtual network. Make sure that you have network connectivity between the private endpoints and the computer from where you want to access runs history. For example, your client computer can exist inside the ISE's virtual network or inside a virtual network that's connected to the ISE's virtual network, for example, through peering or a virtual private network. For more information, see ISE endpoint access.

Review runs history

Each time that the trigger fires for an item or event, the Logic Apps engine creates and runs a separate workflow instance for each item or event. By default, each workflow instance runs in parallel so that no workflow has to wait before starting a run. You can review what happened during that run, including the status for each step in the workflow plus the inputs and outputs for each step.

  1. In the Azure portal, find and open your logic app in the Logic App Designer.

    To find your logic app , in the main Azure search box, enter logic apps, and then select Logic Apps.

    Find and select "Logic Apps" service

    The Azure portal shows all the logic apps that are associated with your Azure subscriptions. You can filter this list based on name, subscription, resource group, location, and so on.

    View logic apps associated with subscriptions

  2. Select your logic app, and then select Overview.

    On the overview pane, under Runs history, all the past, current, and any waiting runs for your logic app appear. If the list shows many runs, and you can't find the entry that you want, try filtering the list. If you don't find the data that you expect, try selecting Refresh on the toolbar.

    Overview, runs history, and other logic app information

    Here are the possible statuses for a logic app run:

    Status Description
    Cancelled The workflow was running but received a cancel request
    Failed At least one action failed, and no later actions in the workflow were set up to handle the failure
    Running The workflow is currently running.

    This status can also appear for throttled workflows or due to the current pricing plan. For more information, see the action limits on the pricing page. If you set up diagnostics logging, you can get information about any throttle events that happen.

    Succeeded All actions succeeded.

    Note: If any failures happened in a specific action, a later action in the workflow handled that failure.

    Waiting The workflow hasn't started or is paused, for example, due to an earlier workflow that's still running.
  3. To review the steps and other information for a specific run, under Runs history, select that run.

    Select a specific run to review

    The Logic app run pane shows each step in the selected run, each step's run status, and the time taken for each step to run, for example:

    Each action in the specific run

    To view this information in list form, on the Logic app run toolbar, select Run Details.

    On the toolbar, select "Run Details"

    The Run Details view shows each step, their status, and other information.

    Review details about each step in the run

    For example, you can get the run's Correlation ID property, which you might need when you use the REST API for Logic Apps.

  4. To get more information about a specific step, select either option:

    • In the Logic app run pane select the step so that the shape expands. You can now view information such as inputs, outputs, and any errors that happened in that step, for example:

      In logic app run pane, view failed step

    • In the Logic app run details pane, select the step that you want.

      In run details pane, view failed step

      You can now view information such as inputs and outputs for that step, for example:

    Note

    All runtime details and events are encrypted within the Logic Apps service. They are decrypted only when a user requests to view that data. You can hide inputs and outputs in run history or control user access to this information by using Azure role-based access control (Azure RBAC).

Review trigger history

Each logic app run starts with a trigger. The trigger history lists all the trigger attempts that your logic app made and information about the inputs and outputs for each trigger attempt.

  1. In the Azure portal, find and open your logic app in the Logic App Designer.

    To find your logic app , in the main Azure search box, enter logic apps, and then select Logic Apps.

    Find and select "Logic Apps" service

    The Azure portal shows all the logic apps that are associated with your Azure subscriptions. You can filter this list based on name, subscription, resource group, location, and so on.

    View logic apps associated with subscriptions

  2. Select your logic app, and then select Overview.

  3. On your logic app's menu, select Overview. In the Summary section, under Evaluation, select See trigger history.

    View trigger history for your logic app

    The trigger history pane shows all the trigger attempts that your logic app has made. Each time that the trigger fires for an item or event, the Logic Apps engine creates a separate logic app instance that runs the workflow. By default, each instance runs in parallel so that no workflow has to wait before starting a run. So if your logic app triggers on multiple items at the same time, a trigger entry with the same date and time appears for each item.

    Multiple trigger attempts for different items

    Here are the possible statuses for a trigger attempt:

    Status Description
    Failed An error occurred. To review any generated error messages for a failed trigger, select that trigger attempt and choose Outputs. For example, you might find inputs that aren't valid.
    Skipped The trigger checked the endpoint but found no data.
    Succeeded The trigger checked the endpoint and found available data. Usually, a "Fired" status also appears alongside this status. If not, the trigger definition might have a condition or SplitOn command that wasn't met.

    This status can apply to a manual trigger, recurrence trigger, or polling trigger. A trigger can run successfully, but the run itself might still fail when the actions generate unhandled errors.

    Tip

    You can recheck the trigger without waiting for the next recurrence. On the overview toolbar, select Run trigger, and select the trigger, which forces a check. Or, select Run on Logic Apps Designer toolbar.

  4. To view information about a specific trigger attempt, on the trigger pane, select that trigger event. If the list shows many trigger attempts, and you can't find the entry that you want, try filtering the list. If you don't find the data that you expect, try selecting Refresh on the toolbar.

    View specific trigger attempt

    You can now review information about the selected trigger event, for example:

    View specific trigger information

Set up monitoring alerts

To get alerts based on specific metrics or exceeded thresholds for your logic app, set up alerts in Azure Monitor. Learn about metrics in Azure. To set up alerts without using Azure Monitor, follow these steps.

  1. On your logic app menu, under Monitoring, select Alerts > New alert rule.

    Add an alert for your logic app

  2. On the Create rule pane, under Resource, select your logic app, if not already selected. Under Condition, select Add so that you can define the condition that triggers the alert.

    Add a condition for the rule

  3. On the Configure signal logic pane, find and select the signal for which you want to get an alert. You can use the search box, or to sort the signals alphabetically, select the Signal name column header.

    For example, if you want to send an alert when a trigger fails, follow these steps:

    1. In the Signal name column, find and select the Triggers Failed signal.

      Select signal for creating alert

    2. On the information pane that opens for the selected signal, under Alert logic, set up your condition, for example:

    3. For Operator, select Greater than or equal to.

    4. For Aggregation type, select Count.

    5. For Threshold value, enter 1.

    6. Under Condition preview, confirm that your condition appears correct.

    7. Under Evaluated based on, set up the interval and frequency for running the alert rule. For Aggregation granularity (Period), select the period for grouping the data. For Frequency of evaluation, select how often you want to check the condition.

    8. When you're ready, select Done.

    Here's the finished condition:

    Set up condition for alert

    The Create rule page now shows the condition that you created and the cost for running that alert.

    New alert on the "Create rule" page

  4. Specify a name, optional description, and severity level for your alert. Either leave the Enable rule upon creation setting turned on, or turn off until you're ready to enable the rule.

  5. When you're done, select Create alert rule.

Tip

To run a logic app from an alert, you can include the request trigger in your workflow, which lets you perform tasks like these examples:

Next steps