Default Parameters for XchgMsgTrackTest

This test tracks the flow of messages through an Exchange organization, and reports the number and size of messages that pertain to every key event type handled by the Exchange server.

This page depicts the default parameters that need to be configured for the XchgMsgtrackTest.

• The TEST PERIOD list box helps the user to decide how often this test needs to be executed.

• The Exchange Management Shell is a command-line management interface, built on Windows PowerShell which enables you to administer every part of Microsoft Exchange. This test uses the Exchange management shell to run scripts and collect the desired performance metrics from the Exchange server. By default, the test auto-discovers the location of the Exchange management shell and thus, automatically loads the Exchange management shell snap-in (exshell.psc1) for script execution. This is why, the XCHGEXTENSIONSHELLPATH is set to none by default.

• By default, the ALLEVENTS flag is set to No, indicating that this test will report metrics for only the following event types by default: SEND, RECEIVE, SUBMIT, FAIL, POISON. If you want the test to additionally report metrics across all event types – i.e., support an additional All descriptor, which will report the total number of emails handled by the server and their total size – then, set this flag to Yes.

• In large, highly active Exchange environments, hundreds of emails may be received by the Exchange server within a short period of time. In such environments, the frequent collection of detailed diagnosis of the received emails may increase the processing overheads of the eG agent, and may even choke the eG database. To avoid this, the DD FOR RECEIVEMESSAGE flag is set to No by default; this implies that the test will not provide the detailed diagnosis for the RECEIVE descriptor – i.e., for the received messages – by default. To view detailed diagnosis for these messages as well, set this flag to Yes.

• In large, highly active Exchange environments, hundreds of emails may be sent by the Exchange server within a short period of time. In such environments, the frequent collection of detailed diagnosis information related to the sent emails may increase the processing overheads of the eG agent, and may even choke the eG database. To avoid this, the DD FOR SENDMESSAGE flag is set to No by default; this implies that the test will not provide the detailed diagnosis for the SEND descriptor – i.e., for the sent messages – by default. To view detailed diagnosis for these messages as well, set this flag to Yes.

• In large, highly active Exchange environments, hundreds of emails may be submitted to the transport pipeline within a short period of time. In such environments, the frequent collection of detailed diagnosis information related to the submitted emails may increase the processing overheads of the eG agent, and may even choke the eG database. To avoid this, the DD FOR SUBMITMESSAGE flag is set to No by default; this implies that the test will not provide the detailed diagnosis for the SUBMIT descriptor – i.e., for the sent messages – by default. To view detailed diagnosis for these messages as well, set this flag to Yes.

• Once the necessary values have been provided, clicking on the UPDATE button will register the changes made.

When changing default configurations of tests, the values with “$” indicate variables that will be replaced by the eG system according to the specific server being managed - for instance, $hostName is the host/nickname of the target host, $port is the port number of the server being monitored. E.g., for a server xyz:80, $hostName will be changed automatically by the eG manager to “xyz” and $port will be changed to “80” when configuring a test.