Share via


Tracking Messages in BizTalk Services portal

 

Important

Microsoft Azure BizTalk Services (MABS) is being retired, and replaced with Azure Logic Apps. If you currently use MABS, then Move from BizTalk Services to Logic Appsprovides some guidance on moving your integration solutions to Logic Apps.

If you're brand new to Logic Apps, then we suggest getting started here:

Monitor EDI and AS2 messages, batches, and bridges deployed in a BizTalk Services subscription. The tracking information helps you in the following ways:

  • Determines if a processing delay occurs.

  • Provides specific details of a message’s properties.

  • Helps determine the flow of events when a message is being processing.

Note

To track messages processed by the X12 and AS2 pipelines, you must enable tracking as part of an agreement before you can view tracking data. To enable tracking, see Create an X12 Agreement in Azure BizTalk Services and Create an AS2 Agreement in Azure BizTalk Services.

To track messages processed by the EAI bridges, you must enable tracking as part of the Visual Studio application. See Tracking Messages Processed by the Bridge. Tracking of messages that failed in processing, is enabled by default. However, to track promoted properties and successfully processed messages, you must explicitly enable tracking while configuring the bridges.

View and Query Tracked Data

You can view and query tacked data using the BizTalk Services Portal. You can use the BizTalk Services Portal to track messages based on three different criterion – messages, protocol (X12 or AS2), and batching.

To view and query tracked data based on messages

  1. Select Tracking on the BizTalk Services Portal home page.

  2. On the Tracking page, select Messages.

  3. Select the drop-down arrow against the Search box to see different fields based on which you can filter the tracking data to be viewed.

    Parameter

    Description

    Request ID

    The request ID of the message sent to the BizTalk Services.

    Track ID

    The ID received in response to sending a message to an endpoint. The tracking ID is same as the request ID that is sent back to the client.

    Note

    By default, the tracking ID you must have received includes a _Gx as a suffix, where x is a numeric number. While looking at tracking information using the tracking ID, you must remove the _Gx suffix.

    Event Level

    The event category (Error or All) that you want to filter in the tracking data.

    Endpoint URL

    The relative endpoint URL where the endpoint is deployed.

    Date From

    The start date/time from which the tracking data must be retrieved.

    Date To

    The end date/time up to which the tracking data must be retrieved.

    > [!NOTE]
    > <P><STRONG>Event Level</STRONG>, <STRONG>Date From</STRONG>, and <STRONG>Date To</STRONG> are always enabled by default in the search filter. However, <STRONG>Date From</STRONG> and <STRONG>Date To</STRONG> must be filled according to local time zone. The default <STRONG>Date To</STRONG> is the current local time and default <STRONG>Date From</STRONG> is the current local time minus 24 hours (1 Day).</P>
    
    1. Click Search.

    To view and query tracked data based on protocol

    1. Select Tracking on the BizTalk Services Portal home page.

    2. On the Tracking page, select Protocol, and then select either X12 or AS2.

    3. Select the drop-down arrow next to the Search box to see different fields based on which you can track the messages.

      Parameter

      Applicable to

      Description

      Sender

      X12 and AS2

      The Sender can be a specific partner or any partner. You can also use < Any *> as a wild card.

      Receiver

      X12 and AS2

      The Receiver can be a specific partner or any partner. You can also use < Any *> as a wild card.

      Message Type

      X12

      The Message Type can be a specific type, like 850–Purchase Order, or any type. You can also use < Any *> as a wild card.

      Interchange ID

      X12

      The interchange ID for the message to be tracked.

      AS2 Message ID

      AS2

      The AS2 message ID for the message to be tracked

      Request ID

      X12 and AS2

      The request ID of the message sent to the BizTalk Services.

      Date From

      X12 and AS2

      The start date/time after which the tracking data must be retrieved.

      Date To

      X12 and AS2

      The end date up to which the tracking data must be retrieved.

      Note

      Date From and Date To are always enabled by default in the search filter. However, values for these filters must be filled according to local time zone. The default value for Date To is the current local time and the default value for Date From is the current local time minus 24 hours (1 Day).

    4. Select Search.

      Once you see the filter tracking data, you can also download the messages from the portal. Click the row in the list and then click Details from the command bar to get an option to download more data. For example, for an X12 tracking row, you can download the EDI message, suspended message, and the corresponding correlated functional acknowledgements. Similarly, for AS2 tracking row, you can download the AS2 message before encoding/decoding and the corresponding correlated MDNs. This is available only with the BizTalk Services Premium edition.

    To view and query tracked data based on batching

    1. Select Tracking on the BizTalk Services Portal home page.

    2. On the Tracking page, select Batching, and then select either active batches or completed batches.

    3. Select the drop-down arrow against the Search box to see different fields based on which you can track the messages.

      Parameter

      Applicable to

      Description

      Sender

      Active and completed

      The Sender can be a specific partner or any partner. You can also use < Any *> as a wild card.

      Receiver

      Active and completed

      The Receiver can be a specific partner or any partner. You can also use < Any *> as a wild card.

      Agreement

      Active and completed

      The name of the agreement containing the batch configuration. You can also use < Any *> as a wild card.

      Batch

      Active and completed

      The name of the batch that processes the message. You can also use < Any *> as a wild card.

      Request ID

      Completed

      The request ID of the message sent to the BizTalk Services.

      Completed Time From

      Completed

      The start date after which the batch is released.

      Completed Time To

      Completed

      The end date before which the batch is released.

      Note

      Completed Time From and Completed Time To are always enabled by default in the search filter. However, you must enter the value for these filters according to local time zone. The default value for Completed Time To is the current local time and the default value for Completed Time From is the current local time minus 24 hours (1 Day).

    4. Click Search.

    Known Issue

    Tracking events are captured up to the X12/AS2 message processing and correlation of the acknowledgements only in the Protocol (X12 or AS2) tracking tabs. If a message fails outside of the Protocol stage, the tracking view still shows the message as successfully processed. In this situation, refer to the Messages tab in Tracking for error details. As a tip, you must copy the Request ID from X12 or AS2 tracking tab and use that ID as a search filter in the Messages tab.

    The X12 Receive and Send Settings (Create an X12 Agreement in Azure BizTalk Services) provides information on the Protocol stage.

    See Also

    Manage Partners and Profiles in Azure BizTalk Services
    Create Agreements in Azure BizTalk Services
    Manage your Resources in BizTalk Services portal
    Configuring EDI, AS2, and EDIFACT on BizTalk Services Portal