BT File Send Adapter Test

The File send adapter transmits messages from the message box database to a specified destination address (URL). You define the URL, which is a file path and file name, by using wildcard characters related to the message context properties. The File send adapter resolves the wildcard characters to the actual file name before writing the message to the file.

When writing a message to a file, the File send adapter gets the message content from the body part of the BizTalk message object. The File send adapter ignores other message parts in the BizTalk Message object. After the File adapter writes the message to a file, it deletes the message from the MessageBox database. The File adapter writes files to the file system either directly or by using the file system cache, which can improve performance, particularly for large files.

This test monitors the outflow of data and messages from the file send adapter on each host instance and reports the load on the adapter and the slowdowns (if any) suffered by the adapter while processing the load.

Target of the test : A BizTalk Server 2010

Agent deploying the test : An internal agent

Outputs of the test : One set of results for each host instance on the BizTalk server being monitored

Configurable parameters for the test

Parameters	Description
Test period	This indicates how often should the test be executed.
Host	The host for which this test is to be configured.
Port	The port at which the host listens to.
Ispassive	If this parameter is set to Yes, then it means that, by default, all BizTalk servers being monitored by the eG system are the passive servers of a BizTalk cluster. No alerts will be generated if the servers are not running. Measures will be reported as "Not applicable" by the agent if the servers are not up.

Measurements made by the test

Measurement	Description	Measurement Unit	Interpretation
Bytes sent	Indicates the total number of bytes sent by the file send adapter on this host instance.	Bytes	The counter is incremented only for messages that have been completely written to file system.
Bytes sent rate	Indicates the rate at which bytes were sent by the file send adapter on this host instance.	Bytes/Sec	The counter applies only to messages that have been completely written to file system.
Messages sent	Indicates the number of messages sent by the file send adapter on this host instance.	Number	The counter is incremented only for messages that have been completely written to file system.
Messages sent rate	Indicates the rate at which messages were sent by the file send adapter on this host instance.	Msgs/Sec	The counter applies only to messages that have been completely written to file system. Ideally, the value of this measure should be high. A low value indicates that the file send adapter is experiencing delays while writing files to the file system. Further investigation may be required to diagnose the root-cause of the slowdown.