Preparing Servers for Monitoring

Windows-based servers use the Performance Data Helper (PDH) component to expose performance metrics to ReadyAPI. This component is available in all Windows versions. To obtain data from a remote host, the following requirements should be met:

• ReadyAPI must run on a Windows machine. Windows, IIS and MSSQL monitors are not available on Linux and macOS machines.

• The account used to connect to the server must belong to one of the following user groups on it:

  • Performance Monitor Users

  • Performance Log Users

  • Administrators

  The Performance Monitor Users and Performance Log Users groups are not available in Windows XP. If you use this Windows version on the remote machine to be monitored, add the needed user account to the Administrators user group.

• The Remote Registry Windows service must be enabled and started on the monitored remote machine. This service is disabled by default on Windows Vista and later. If the server resides on the same computer where ReadyAPI is running (that is, if the localhost server is being monitored), this requirement is optional.

  To enable the Remote Registry Windows service, press WIN+R, and start the services.msc process. In the Services application, right-click Remote Registry and select Start.

To monitor the IIS server, you need to set it up in the same way as Windows servers.

To monitor the MSSQL database, you need to set it up in the same way as Windows servers.

1. You need to have Net-SNMP installed on your server. To check if Net-SNMP is installed, use the snmpd --version command.

   • If you have Net-SNMP installed, you should see the SNMP version number as well as the web address and email.

   • If you do not have Net-SNMP installed, use one of the following commands (depending on the kernel version):

     – either –

     sudo apt-get install snmpd

     – or –

     sudo apt-get install snmp

2. Then, edit the /etc/snmp/snmpd.conf file. This requires sudo privileges. Uncomment the following agent behavior line:

   agentAdress udp:161,udp6:[::1]:161

3. To allow your computer to access server metrics using the public community string, add the following line to the snmpd.conf file:

   rocommunity public

   If you are not sure how to configure Net-SNMP to suit your needs, you can just replace the whole text in a file with the line above.

4. Then, edit the /etc/default/snmpd file and make sure the row that begins with SNMPDOPTS does not contain any trailing addresses.

   For example, if the row in question is:

   SNMPDOPTS=''-Lsd -Lf /dev/null -u snmp -I -smux -p /var/run/snmpd.pid 127.0.0.1'

   Make it:

   SNMPDOPTS=''-Lsd -Lf /dev/null -u snmp -I -smux -p /var/run/snmpd.pid'

5. After changing the configuration of snmpd, restart the server. Execute the following command:

   /etc/init.d/snmpd restart

To monitor Apache servers using ReadyAPI, the mod_status module must be enabled. This module is available as part of a standard installation of either the Apache 1.x or Apache 2.x package, and the configuration is very straightforward.

To enable status reports only for some domain, add the following line to the httpd.conf file, preferably to the bottom:

To use extended counters, add this line to the httpd.conf file:

You need Apache 1.3.2 or higher to access extended counters.

On UNIX machines, you will also need to specify the following settings:

If the configuration files are stored in the /etc/apache2 directory, add the following line to the /etc/apache2/apache2.conf file:

You might also need to comment out the following line from the /etc/apache2/mods-available/status.conf file. Add # at the beginning of the line:

To access the MySQL database monitor, you need a database user account. This user does not need any privileges.

To create a new user, use the following command:

Also, download the MySQL Connector and put it into the ReadyAPI\bin\ext directory.

To access the Oracle database monitor, you need a database user account. This user needs access to the V$METRIC table.

To monitor the WildFly server, you need to:

• Copy the jboss-cli-client.jar library to the <ReadyAPI installation>\bin\ext folder. You can find it in the <WildFly installation>\bin\client folder.

• Use the management user account to connect to the server. See the WildFly documentation for information about adding users.

To use the Tomcat monitor, enable JMX monitoring on the server. Add the following parameters to the Tomcat startup script:

If you plan to add server authorization, refer to the Enabling JMX Remote topic in the Tomcat documentation.

You do not need to prepare MongoDB servers to monitor them.