eG Monitoring
 

Measures reported by BTFileRecTest

The file receive adapter is used to read messages from files and submit them to the server. The receive adapter reads the file and creates a BizTalk message object, so that BizTalk server can process the message. While reading from the file, the adapter locks the file to ensure that no modifications can be made to the file content. The file receive adapter does not pick up read-only files or system files.

This test reports how efficient the file receive adapter on each host instance is. The test monitors the inflow of messages to the file receive adapter, measures the load on the adapter, and reveals how well the adapter handled the load; lock failures encountered by the adapter while attempting to read files are also revealed by this test, so that reasons for the same can be diagnosed.

 The measures made by this test are as follows:

Measurement Description Measurement Unit Interpretation
Bytesreceived Indicates the total number of bytes received by the file receive adapter on this host instance. Bytes The counter is incremented after a message is completely read by the adapter from the file system.

BytesreceivedSec Indicates the rate at which the bytes are received by the file receive adapter on this host instance. Bytes/Sec  
Messagesreceived Indicates the number of messages received by the file receive adapter on this host instance. Number The counter is incremented after a message is completely read by the file receive adapter from the file system.
MessagesreceivedSec Indicates the rate at which the messages are received by the file receive adapter on this host instance. Msgs/sec The counter applies only to messages that have been completely read by the file receive adapter from the file system.

Ideally, the value of this measure should be high. A low value indicates that the file receive adapter is not reading files quickly. Further investigation may be required to diagnose the root-cause of the slowdown.

Lockfailures Indicates the number of times the file receive adapter failed to lock the file during reading process. Number Ideally, the value of this measure should be 0. A non-zero value indicates a lock failure. This in turn implies that the adapter could not prevent changes from being made to one/more files that were being read.