Web Server / Services

Applications Manager supports monitoring of the following Web Services to check their status:

• Apache Server

• IIS Server

• Nginx Server

• Real Browser Monitor (RBM)

• PHP

• SSL Certificate Monitor

• Web Server

• Web Services

• HTTP - URLs and Record & Playback HTTP - URL Sequences

Apache Server

To create an Apache Monitor, follow the steps given below: Refer to the Prerequisites that are needed for Apache monitoring.

1. Click on New Monitor link. Choose Apache Server.

2. Enter the IP Address or hostname of the host in which the Monitor is running.

3. Enter the SubNetMask of the network.

4. Provide the port number in which the monitor is running.

5. Choose SSL option, if SSL is enabled in Apache Server.

6. Enter the polling interval time in minutes.

7. If you are adding a new monitor from an Admin Server, select a Managed Server.

8. Enter the Apache User Name and Password if the Apache Server is authenticated.

9. Modify the Apache Server Status URL if required. The default Server Status URL through which the data transfer details, access details, etc., are collected is http://<host-name:portNumber>server-status?auto. You can now modify the server status URL using this option, if the server status URL is different.

10. Choose the Monitor Group from the combo box with which you want to associate Apache Monitor (optional). You can choose multiple groups to associate your monitor.

11. Click Add Monitor(s). This discovers the Apache from the network and starts monitoring them.

Top

IIS Server

To create an IIS Monitor, follow the steps given below:

1. Click on New Monitor link. Choose IIS Server.

2. Enter the IP Address or hostname of the host in which the Monitor is running.

3. Enter the SubNetMask of the network.

4. Provide the port number in which the monitor is running.

5. Choose SSL option, if SSL is enabled in IIS Server.

6. Enter the polling interval time in minutes.

7. If you are adding a new monitor from an Admin Server, select a Managed Server.

8. Choose the Monitor Group from the combo box with which you want to associate IIS Monitor (optional). You can choose multiple groups to associate your monitor.

9. Click Add Monitor(s). This discovers the IIS Server from the network and starts monitoring them.

Top

Nginx Server

To create a Nginx Monitor, follow the steps given below:

1. Click on New Monitor link. Choose Nginx Server.

2. Enter Display Name of the server.

3. Enter the IP Address or hostname of the host in which the monitor is running.

4. Provide the port number in which the monitor is running.

5. Choose SSL option, if SSL is enabled in Nginx Server.

6. Enter the Nginx User Name and Password if the Nginx Server is authenticated.

7. Modify the Nginx Server Status URI if required. This is for getting the server status. The default Server Status URI is nginx_status. You can modify the server status URI using this option, if the server status URI is different.

8. Enter the polling interval time in minutes.

9. If you are adding a new monitor from an Admin Server, select a Managed Server.

10. Choose the Monitor Group from the combo box with which you want to associate Nginx Monitor (optional). You can choose multiple groups to associate your monitor.

11. Click Add Monitor(s). This discovers the Nginx Server from the network and starts monitoring them.

To Enable the Server Status, follow the steps given below:

1. Configure the location /server_status method in nginx.conf file, to enable server_status.

2. The value of stub_status attribute should be "on".

3. Change the attribute "deny all" to "Allow all".

4. Save the conf file and restart the Nginx Server.

Top

Real Browser Monitor

Real Browser Monitor (RBM) provides live End-User experience measurement. RBM opens up a Microsoft Internet Explorer Browser and monitors a web application just like how a real user sees it. It supports playback from different geographical locations. To know more about RBM and its monitoring capabilities, see Working of Real Browser Monitor.

Note: Real Browser Monitor supports IE browser only.

To create an Real Browser Monitor, follow the steps given below:

1. Click on New Monitor link. Choose Real Browser Monitor, under Web Server / Services.

2. Enter the Display Name of the RBM

3. Select the WebScript, from the available webscripts. To create new webscripts or to modify webscripts, follow the below steps:

   1. Click on Add/View Webscripts. It opens up a Webscript Manager
   2. Click on New link
   3. Enter New webscript name
   4. Click on Record New webscript
   5. This will prompt you to download the RBM Toolbar. Once, you have downloaded the toolbar, a new browser will be opened.
      
   6. In the browser, you can give the required application URL and go about doing the end user operations.
      
   7. Click on stop recording after the required sequence along with the actions have been recorded.
   8. Save the script in Webscript Manager
   9. For modifying the scripts, select the webscript, do the required changes and save the script. 
   10. Note: Following functions can be added for each URL
       
                     1. webCheckText
                     2. checkElementProperty
       
       
       webCheckText
       
       Syntax : webCheckText(searchText,prefixText,suffixText)
       
       prefixText and SuffixText are Optional. It checks if the given text is present in the current page. The result of this check will be updated in the details page of the monitor.
       
       Usage :
       
       # URL : "http://appmanager/home.html"
       setWindowNM("Welcome to ManageEngine Applications Manager","Welcome to ManageEngine Applications Manager","index",0,1)
       webCheckText("Applications Manager")
       
       checkElementProperty
       
       Syntax: checkElementProperty(tagName,propertyName,propertyValue,index,propertyNeeded,matchValue)
       
       It checks if a particular element property is present in the current page.
       
       For example in http://www.appmanager.com page, I need to check the link Home(<a href="home.html" class="mainstyle" target="index">Home&nbsp;</a>)
       
       then this function is used to check it.
       
       Usage :
       
       # URL : "http://appmanager/home.html"
       setWindowNM("Welcome to ManageEngine Applications Manager","Welcome to ManageEngine Applications Manager","index",0,1)
       checkElementProperty("A","href","home.html",1,"target","index")
       
       Here the function searches for the element with tagname "A" and the property "href=home.html" . And it checks if the property "target" is equal to "index" . The index denotes the number of occurences. If the same element is present more than once then we can indicate which element by using index.
       

4. Select the Playback Agents. Multiple selection option is also possible.

   1. Download the RBMAgent.exe and install it in remote host/localhost. 
      
   2. Invoke EUM agent through Start->  All Programs-> ManageEngine EUM agent -> Start Agent .
   3. While starting EUM agent, configure the Applications Manager Host and Port details to add the agent to Applications Manager.

5. Set the polling interval time in minutes.

6. Set the Timeout in minutes. Timeout is the maximum waiting time taken for the Webscript to execute. If the playback in the EUM agents got struck or was not played back properly, then EUM agent will wait for timeout and then move to the next polling.

7. Click Add RBM Monitor. 

Top

PHP

To create a PHP Monitor, follow the steps given below:

Initially, you need to place phpstats.php , the bundled Applications Manager's PHP file in the webserver's document root.

1. Click on New Monitor link. Select PHP Monitoring.

2. Enter the IP Address or hostname of the host in which the Monitor is running.

3. Enter the SubNetMask of the network.

4. Provide the port number in which the monitor is running.

5. Choose SSL option, if SSL is enabled in PHP.

6. Enter the path to be connected. By default, ' /phpstats.php ' is shown. http://hostname:portNo/"path to be connected" will be used for connection

7. Enter the polling interval time in minutes.

8. If you are adding a new monitor from an Admin Server, select a Managed Server.

9. Choose the Monitor Group from the combo box with which you want to associate PHP Monitor (optional). You can choose multiple groups to associate your monitor.

10. Click Add Monitor(s). This discovers the PHP Service from the network and starts monitoring them.

Top

SSL Certificate Monitor

To create a SSL Certificate Monitor, follow the steps given below:

1. Click on New Monitor link. Choose SSL Certificate Monitor.

2. Provide an appropriate Display Name for the SSL Certificate monitor.

3. Enter the Domain name for which SSL certificate is required to be monitored.

4. Provide the port in which the server is running [Default port is 443].

5. Check the box Need proxy to connect to the domain if the server is connected through proxy. In such cases you should also configure proxy server settings through the 'Configure Proxy' option available in the Admin tab.

6. Enter the Timeout value in seconds.

7. Provide the polling interval in minutes.

8. If you are adding a new monitor from an Admin Server, select a Managed Server.

9. Choose the Monitor Group from the combo box with which you want to associate the SSL Certificate Monitor (optional). You can choose multiple groups to associate your monitor.

10. Click Add Monitor(s). This discovers the SSL Certificate from the server and starts monitoring it.

Top

Web Server

To create a Web Server Monitor, follow the steps given below:

1. Click on New Monitor link. Choose Web Server.

2. Enter the IP Address or hostname of the host in which the Monitor is running.

3. Enter the SubNetMask of the network.

4. Provide the port number in which the monitor is running.

5. Enter the polling interval time in minutes.

6. If you are adding a new monitor from an Admin Server, select a Managed Server.

7. Choose the Monitor Group from the combo box with which you want to associate Web Server Monitor (optional). You can choose multiple groups to associate your monitor.

8. Click Add Monitor(s). This discovers the Web server from the network and starts monitoring them.

If you have added Monitors and not associated them with a Monitor Group, you can do this manually anytime. For information on associating a Monitor with a Monitor Group, refer to Associating Monitor with Monitor Groups topic.

Top

Web Services

To create Web Services Monitor, follow the steps given below:

Note: If you want to access Web Services through Proxy , Kindly go to Admin > Configure Proxy Settings > Check if Proxy is configured, else configure the same. For hosts that don't require Proxy, add them to the No Proxy list.

1. Click on New Monitor link. Choose Web Services.

2. Enter the WSDL URL.

3. Select the checkbox if proxy is required for connection to the WSDL URL.

4. Enter the polling interval time in minutes.

5. If you are adding a new monitor from an Admin Server, select a Managed Server.

6. Enter the Timeout.

7. Give the User Name and Password, if it is required to invoke the webservice operation.

8. Add a Header: You can use our pre-defined headers or create your own custom headers to invoke operations. Use '#' to seperate multiple headers.Use ':' to sepearate individual keys and values. For Example- Content-Type:text/application+xop;charset=UTF-9#Pragma:no-cache

9. During monitor creation, provide the token for extracting a specific value from the SOAP Response for sequential execution. The token is of the format OperationName_SEP_TagToBeExtracted.

10. Choose the Monitor Group from the combo box with which you want to associate Web Services Monitor (optional). You can choose multiple groups to associate your monitor.

11. Click Add Monitor(s). 

If you have added Monitors and not associated them with a Monitor Group, you can do this manually anytime. For information on associating a Monitor with a Monitor Group, refer to Associating Monitor with Monitor Groups topic.

After creation of Web Services monitor, you can proceed to add the required operations and configure the thresholds and alarms for the same. Kindly refer Web Services Monitor for more details on operations.

Note: Sequential execution of SOAP Operations Create a sequence of SOAP Operations wherein the output obtained from one SOAP Response is used as the input for the next SOAP Request. Procedure: During monitor creation, provide the token for extracting a specific value from the SOAP Response. The token is of the format OperationName_SEP_TagToBeExtracted. For example, the SOAP Operation GetCitiesByCountry returns the list of cities present in a particular country. Each city is specified within <City> tag in the SOAP Response. To extract the first city from the SOAP Response the Authentication token would be GetCitiesByCountry_SEP_City. After monitor creation, add the operations. For the operations where the input is taken from the response of another operation, call the function passAuthToken. Syntax : ${passAuthToken(authtoken)}. Example : ${passAuthToken(GetCitiesByCountry_SEP_City)}

Top

See Also

Monitor Information - Web Server / Services | Create Other New Monitors