System PulseMeter Help
Home
System PulseMeter
Order
2010 System Pulse Software (c)
|
System PulseMeter TCP Connection Test
TCP Connection Test
Use the TCP test for monitoring TCP based servers. The TCP test can be used for
monitoring Whois, FTP servers, Telnet, Chargen, and other types of servers.
TCP Connection Test Properties
"Basic" TCP Connection test properties can be set in the "Test Properties" dialog.
Specific TCP test properties include:
- "Host" -
monitored host name or IP address.
- "Port" - number of the port at the monitored host used for listening for
incoming TCP packets. It can be 21 for FTP servers, 23 for Telnet servers,
43 for Whois servers, etc.
- "Timeout" - adjust this value to change timeout of the
TCP test. Default TCP connection test timeout is set to 2.000 milliseconds.
- "Test passes when" -
a set of reply type and reply value of the test, considered as successful.
- "Condition" - condition of the reply can be:
- "No reply"
- "Any reply"
- "Reply is equal to"
- "Reply isn't equal to"
- "Reply is greater than"
- "Reply is less than"
- "Reply contains"
- "Reply doesn't contain"
- "Value" - the value returned by the monitored host.
- "Script" -
The script options is used for setting sophisticated data exchange with the
monitored server. For example, it can be used for logging to FTP servers,
sending passwords, skipping greeting messages from servers, etc. The script
always should be started with "Connect" command and finished by "Disconnect"
command.
The available "Script" commands include:
-
Connect - the command connects to a remote server.
- Send - use "Send" command for sending data to server, including
sending login data. All data sent in "Send" command should be
double-quoted,
for example: Send "User anonymous" . The
response from the
server can be assigned to the "Reply".
- Recv - a command for receiving data from remote server containing
reply from server. The response from the server can be assigned to the
"Reply".
- Reply - the "Reply" command is used for assigning data received from
the server to the test result. The "Reply" command can be equal to
"Recv" or to "Send" commands result. The "Reply" command should be
followed by a = sign, for example: Reply = Send "pass%20zzz@website.com"
- FetchReply - FetchReply command can be used to process the reply to
access it's specific fragments. Fetches a string from the reply until the
first occurrence of the delimiter and deletes the string and delimiter from
the reply. The command can be applied to the result several times, so that
any part of returned data can be assigned to the Reply. Delimiter should be specified in double-quotes, for example:
- FetchReply "," will return 45,10 if Reply is 23,45,10
- Reply = FetchReply "," will return 23 if Reply is 23,45,10
- Disconnect - use "Disconnect" command for quitting the connection to
server.
TCP Connection Test Script Examples
- Basic script example, that connects to remote server, doesn't send any
data to the server and receives the reply. It can be used for connecting to
FTP server, obtaining greeting message from the server and setting it as the
reply result:
Connect Reply = Recv Disconnect
- Connects to the FTP server, receives the greeting message, logins as an
anonymous user and sets the login result as the reply. After that the script
logs out from the FTP server:
Connect
Recv
Send "User anonymous"
Reply = Send "pass%20zzz@website.com"
Send "Quit"
Disconnect
- This script example connects to a mail server, sends login information and
receives the number of letters and their total size, and then processes the
received data to return only the number of letters.
In case if we remove the "FetchReply" command the test will return both
values separated by space, for example, if there are tree letters on a
server, and their size is 20000 bytes, the reply will look like: 3
20000 . We can select whether we want to receive letters number or
letters size as the result. In case if we apply Reply = FetchReply " "
command, the result will be the first value, equal to the number of letters
3. In case if we apply FetchReply " "
command, the result will be all the data after the first space in the
returned text, in our example it will be the overall letters size
20000:
Connect
Recv
Send "user%20user@mail.com"
Send "pass%20apwd"
Reply = Send "stat"
Reply = FetchReply " "
Disconnect
|