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

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

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.