Monitor and track B2B messages in Consumption workflows for Azure Logic Apps using Azure Monitor

Applies to: Azure Logic Apps (Consumption)

After you set up B2B communication between trading partners in an integration account, these partners can exchange messages by using protocols such as AS2, X12, and EDIFACT. To confirm that this communication works as expected, set up Azure Monitor logs for your integration account.

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 record and store data about runtime data and events, such as trigger events, run events, and action events in a Log Analytics workspace.

For messages, logging also collects the following information:

• Message count and status
• Acknowledgments status
• Correlations between messages and acknowledgments
• Detailed error descriptions for failures

Azure Monitor lets you create log queries that help you find and review this information. You can also use this diagnostics data with other Azure services, such as Azure Storage and Azure Event Hubs.

This guide shows how to set up Azure Monitor logging for your integration account. You first install the Logic Apps B2B solution in the Azure portal. This solution provides aggregated information for B2B message events. Then, to enable logging and creating queries, you learn how to set up Azure Monitor logs.

For more information, see:

• Azure Monitor overview
• Azure Monitor Logs overview
• Resource log destinations
• Log queries in Azure Monitor
• Send diagnostic data to Azure Storage and Azure Event Hubs

Prerequisites

• An Azure account with an active subscription. If you don't have a subscription, create a free account.

• A Log Analytics workspace. If you don't have a Log Analytics workspace, see Create a Log Analytics workspace.

• A Consumption logic app resource that's set up Azure Monitor logging and has a workflow with the B2B messages that you want to monitor.

  Your workflow sends logging information to a Log Analytics workspace or another destination that you want.

• An integration account that's linked to your logic app resource.

Install Logic Apps B2B solution

Before Azure Monitor logs can track the B2B messages for your logic app, add the Logic Apps B2B solution to your Log Analytics workspace.

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

   

2. Under Log Analytics workspaces, select your workspace.

   

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

   

4. On the Overview page, select Add.

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

   

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.

   

   Azure deploys the solution to the Azure resource group that contains your Log Analytics workspace.

8. Go to your Log Analytics workspace, On the Overview page, on the Get Started tab, select View solutions again to see the installed solution. Select the solution tile to view more message details.

   When the workflow processes B2B messages, the charts update with the message count.

   

Set up Azure Monitor logs

You can enable Azure Monitor logging directly from your integration account.

1. In the Azure portal, find and select your integration account.

   

2. On the integration account sidebar, under Monitoring, select Diagnostic settings. Under the Diagnostic settings table, select Add diagnostic setting.

   

3. To create the setting, follow these steps:

   1. For Diagnostic setting name, provide a name.

   2. Under Destination details, select Send to Log Analytics workspace.

   3. For Subscription, select the Azure subscription for your Log Analytics workspace.

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

   5. Under Logs, select Integration Account tracking events, which specifies the event category that you want to record.

   6. When you're done, on the toolbar, select Save.

   For example:

   

View message status

After your workflow runs, you can view the status and data about any B2B messages exchanged by partners.

1. In the Azure portal search box, find and open the resource group for your Log Analytics workspace.

2. From the resource group, select the Logic Apps B2B solution that you previously installed.

3. From the solution sidebar, select Summary.

   

   Note

   If the Logic Apps B2B tile doesn't immediately show results after a run, try refreshing the browser or wait for a short time before trying again.

   By default, the Logic Apps B2B tile shows data based on a single day. To change the data scope to a different interval, select the scope control at the top of the page:

   

4. After the message status dashboard appears, you can view more details for a specific message type, which shows data based on a single day. Select the tile for AS2, X12, or EDIFACT.

   

   A list of messages appears for your chosen tile. For example, here's what an AS2 message list might look like:

   

   To learn more about the properties for each message type, see these message property descriptions:

   • AS2 message properties
   • X12 message properties
   • EDIFACT message properties

Property descriptions and name formats for AS2, X12, and EDIFACT messages

For each message type, here are the property descriptions and name formats for downloaded message files.

AS2 message property descriptions

Here are the property descriptions for each AS2 message.

X12 message property descriptions

Here are the property descriptions for each X12 message.

EDIFACT message property descriptions

Here are the property descriptions for each EDIFACT message.

Related content

• Create monitoring and tracking queries