Being able to track messages is convenient for developers and administrators for debugging/analysis purposes. BizTalk enables you to track message content and context on ports, pipelines and orchestrations. Depending on your goal you can turn on/off different tracking options. These tracking options can be exported and imported through binding files.
This article contains the tracking options for Receive/Send Ports, Pipelines and Orchestrations as they may occur in binding files.
Given the performance penalty of using much tracking, you’ll want less tracking in your Live environment than in your Development/Test environment. If you use BTDF for deployment of BizTalk applications you can easily add variables to the Settings file, so you can automatically apply different tracking options per environment. Below some suggestions on how you could name these variables:
Track Message Bodies
Request message before port processing
1
Request message after port processing
2
Track Message Properties
16
32
Say you want to track messages and properties before and after port processing. You need:
<
ReceivePort
Name
=
"ReceivePort1"
IsTwoWay
"false"
BindingOption
"0"
>
Description
xsi:nil
"true"
/>
...
Tracking
>51</
</
Response message before port processing
4
Response message after port processing
8
64
128
SendPort
"SendPort1"
>204</
Say you want to track messages and properties as they enter/leave the port. You need:
IsStatic
>153</
Track Events
Port start and end events
ServiceStartEnd PipelineEvents
Message send and receive events
MessageSendReceive
Message before pipeline processing
InboundMessageBody
Message after pipeline processing
OutboundMessageBody
Say you want to track port start and end event and message receive and send events. You need:
"1"
ReceiveLocations
ReceiveLocation
"ReceiveLocation1"
ReceivePipeline
"ReceivePipeline1"
FullyQualifiedName
" ReceivePipeline, Pipelines, Version=1.0.0.0, Culture=neutral, PublicKeyToken=f4747cde3b0ad4ae"
Type
TrackingOption
"ServiceStartEnd MessageSendReceive PipelineEvents"
""
Orchestration start and end
ServiceStartEnd
Message send and receive
Shape start and end
OrchestrationEvents
Before orchestration processing
After orchestration processing
Incoming messages
TrackPropertiesForIncomingMessages
Outgoing messages
TrackPropertiesForOutgoingMessages
Say you want to track orchestration instances when they start and end, when messages are received and send and you want to see which shapes are started and ended in the Orchestration Debugger. You need:
Service
"Orchestration1"
State
"Started"
"ServiceStartEnd MessageSendReceive OrchestrationEvents"
Ports
Roles
Host
"ProcessingHost"
NTGroupName
"BizTalk Application Users"
Trusted
Another important place to find a large amount of BizTalk related articles is the TechNet Wiki itself. The best entry point is BizTalk Server Resources on the TechNet Wiki.