Appendix A Configuration and Module Parameters Reference

Instance

Name of the module instance. 

Description

Description of the instance. 

Service Host

Name of the server where the service is running 

Service Port

Port number where the service is running 

Calendar

The name of a calendar which already exists on the calendar server to be monitored. 

Time-out (sec)

Time-out interval for each request made to the server. Should have a positive value. Value of 0 nullifies the effect of timeout. 

Login ID

Login ID to access the service. Required only for IMAP and POP3 modules. 

Password

Password for the user. The IMAP and POP3 modules require a password. The password is passed in clear text during the synthetic transactions. The password is therefore not secure. Be certain that users for these modules have no privileges. 

Domain Name

The domain name where the NIS lookup is done.  

Email From

For the SMTP service, the email address of the sender of the mail. You should create an email account for each test on the system. The test email then has a destination. Failure to provide a destination may cause concurrent access problems, SMTP to reject mail requests. Undeliverable email will then end up at your root mail system. 

Process Name

The name of the process to be monitored. 

Argv Pattern of Process

Arguments to the process. 

User ID of Process

The user ID of the process owner. 

Process Count

The number of processes found matching process name, argv pattern of process and user ID of process.

Access Log File

The absolute path name of the HTTP server access log file. This file contains information about web server statistics. Only a file with common log file (CLF) format is supported. An alarm is displayed if the file does not exist, or if the file format is not CLF 

Web Server Product Name

Product name of the web server. 

Availability

Indicates the availability of the service. One of three states is returned:  

1. Up: Indicates the service is available 

2. Down: Indicates service is not available. Shows an alert if state is down. 

3. Degraded: Indicates performance is not as expected. The module is able to run test transactions but the response times of the transactions exceeds the alarm thresholds specified. When the availability is degraded, an alarm is generated. The alarm severity is the highest severity of all alarms that is set on the response times of the transaction. 

Reason for Non Availability

Indicates the likely reason for the service not being available. The reason the destination is unreachable indicates why the network or the host is unreachable. Not applicable is indicated when the service is not down. 

Uptime (%)

The percentage of uptime for the corresponding server since the module started monitoring the service. 

Mean Time To Recovery

The mean time to recovery since monitoring began. The value is calculated as the total downtime of service divided by the number of failures. 

Mean Time Between Failure

The mean time between failure since you started monitoring. The value is calculated as the ideal uptime of the service divided by the number of failures. 

Service Checked

Last time when the service was contacted. 

Name

Row name. 

Transaction Result

Indicates what happened to the transaction. One of two values is returned: 

1. Success: Indicates that the transaction was successful. 

2. Failure: Indicates that the transaction failed. Also lists the reason for failure, and displays a warning alarm.  

Transaction Failure

If a transaction fails, this parameter indicates the reason for the failure. Examples of reasons are unknown server name, or unable to reach the server. Not applicable is indicated when the transaction was successful. 

Lookup (ms)

Time taken to resolve the server name where service is running in milliseconds. You can set alarm thresholds on this property. 

Connect (ms)

Total time to establish a connection with the service in milliseconds. You can set alarm thresholds on this property. 

Data Transfer (Kbyte/sec)

Time from when the web page is requested until the web page is completely returned in kilobytes/second. You can set alarm thresholds on this property. 

Transaction (ms)

Total time taken to complete whole transaction in milliseconds. This sum is the total network time plus the total server processing time. You can set alarm thresholds on this property. 

Network (ms)

Total time spent in the network during the transaction in milliseconds. You can set alarm thresholds on this property. 

Server processing (ms)

Total time taken in milliseconds by the server to process the transaction. You can set alarm thresholds on this property. 

URL

HTTP page to test.  

Directory

Directory on the FTP server in which to save the file in or to retrieve the file. 

Operation

Indicates the type of FTP operation the user wants to monitor: 

1. get, which indicates an FTP get operation.

2. put, which indicates an FTP put operation.

File

For FTP transactions, the name of file to get or put. For an FTP put operation, the file should first be put in /var/opt/SUNWsymon/ftp/put.

Packet (KB)

Size of the each packet during the FTP get/put operation in KB.  

Authentication (ms)

Time to login to the server. FTP will log in as anonymous user. 

Data Transfer (ms)

Time to transfer the file (get or put) in milliseconds.

Host Name

The host name to look up in the DNS server. 

IP address(es)

IP address of the host. 

Host Lookup (ms)

Time taken to resolve the host name in the DNS server in milliseconds. 

NIS Lookup

Name to look up in the NIS domain. This could be a host, a user, a UNIX group, or a mail alias.  

NIS Map

The NIS name services map. There are four default values: passwd, hosts, groups, and mail aliases. The name to be resolved should be one of these four types. 

Base DN

The starting point for the search in the LDAP directory. 

Search Filter

The filter is a string representation of the filter to apply in the search. Simple filters can be specified as attributetype=attributevalue. 

LDAP Lookup (ms)

Time taken to resolve the name in the LDAP directory in milliseconds. 

Email To

Email address to send the test message to. 

Email (KB)

Size of the test message to be sent in KB. 

Message (KB)

Size of the message to be retrieved from the mail servers. Default value is 1k. You can edit this row. The values are: 1k, 5k, 10k, 20k, and 25k. 

Get Message (ms)

Time to retrieve a message from the mail server in milliseconds. 

User Name

User name whose calendar has to be accessed. If this calendar does not exist in the server, you receive an error.  

Logfile

Same as HTTP server's access log file. 

Total Operations

Total number of operations performed by the service since it was started.  

Total Data Transferred (KB)

Total data transferred in KB since the service was started. 

Total Files Transferred

Total files transferred since the service was started. 

Total Errors

Total errors encountered since the service was started. 

Total Server errors

Total errors encountered with error code numbers 500 or higher since the service was started.