Configuring Web URL monitoring

Enter the Web URL instance name. This is displayed on folders, graphs, lists, etc. If the instance name contains a space, it is not considered.

Example: If "bmc software" is the instance name, it would be considered as "bmcsoftware".

Specify the time interval between two consecutive statistical data polls. Default is 60 seconds. 

Select/clear check box to enable/disable data monitoring for the instance. Monitoring is enabled (check box selected). 

Alert on pattern not found (Positive match)

Specify a string that you not want to find within the page whose URL you are monitoring. For example, let us suppose that you are monitoring a URL and you want to be alerted if the string "Google" is not present in the page content. If the word "Google" is not present on the page, the content match parameter goes into the alarm state and the following annotation is displayed:

Positive string was not found: [Google]

The value of the Content match parameter is derived from the value of the positive and negative match. If the positive match was not found or the negative match was found, the value of the Content match parameter is 1. Otherwise, the value of the Content match parameter is 0. For example, you are monitoring the www.Google.com and your positive string is Error and negative string is Google. In this case, the positive match would not be found and negative match would be found on the monitored URL. Therefore, the value of the Content match parameter would be 1.

Alert on pattern found (Negative match)

Specify a string that you want to find within the page whose URL you are monitoring. For example, let us suppose that you are monitoring a URL and you want to be alerted if the string "ERROR" is present in the page content. If the word "ERROR" is present on the page, the content match parameter goes into the alarm state and the following annotation is displayed:

Negative string was found: [ERROR] 

The value of the Content match parameter is derived from the value of the positive and negative match. If the positive match was not found or the negative match was found, the value of the Content match parameter is 1. Otherwise, the value of the Content match parameter is 0. For example, you are monitoring the www.Google.com and your positive string is Error and negative string is Google. In this case, the positive match would not be found and negative match would be found on the monitored URL. Therefore, the value of the Content match parameter would be 1.

This value is used by the Web URL monitor if it is unable to determine the character encoding of the page. Usually, the encoding information is specified in the HTTP response header and/or in the META tags of the page. In these cases, if the specified URL refers to a page that has Non-English content, it is necessary to enter the character encoding of the page. Example: Korean Encoding specified as euc-kr; Japanese Encoding specified as euc-jp or shift-jis.

Note:

Enable the Include internal script execution or Include external script execution check box only if you want to monitor JavaScript of the URL as it results in high usage of system resources. For more information on the JavaScript parameters, see Java script (WUM_JS).

Select or clear the check box to enable or disable web URL monitoring that includes execution of any Java script included in the defined web URL. By default, collect internal Java script is disabled (check box cleared).

Select or clear the check box to enable or disable web URL monitoring that includes execution of any external Java script referred by the defined web URL. By default, collection of external Java script is disabled (check box cleared).

Specify the execution time. Execution time is the time taken to execute a single Java script. The monitor measures the Java script code execution time and reports the Java scripts that exceed the defined execution time. By default the execution time is 100 milliseconds.

Valid values: 10 to 10000 milliseconds.

Enter the user name used to access the proxy server. 

Enter the password corresponding to the user name. 

The KM supports monitoring of URLs that require Client Certificates by importing the Java key store database file (known as the .jks file) into the KM. 

When you configure the URLs to be monitored that require a client certificate, those client certificates should be already imported into the .jks file so it can be used while communicating with the URLs. An authorization error will occur if the required certificates are not found in the .jks database file. 

.jks file path

Enter the path (along with the file name and .jks extension) where the Java key store database file is located.

The Java key store database file must be accessible from the host where the PATROL Agent is running. BMC PATROL default account must have read permission on the directory where the .jks file is located.

Enter a password for the Java keystore database file. This password is used by the KM to open the java keystore database (aka .jks file).

To add the Web URL to the list, click Add to List button.

To save the changes made to the Web URL already added, click Modify Selection button.

To remove the selected Web URL from monitoring, click Remove from List, button.

Select/clear check box to enable/disable debugging. The log files are located at %PATROL_HOME%\WUM\logs,on the server where the PATROL Agent is running. By default, the debug is disabled (check box cleared).

When the log file reaches the maximum size, logs are rolled over to newer files ranging from <Port number>_WUM_JavaCollector.0.txt to <Port number>_WUM_JavaCollector.4.txt.

Enter the complete path of the Java home directory if you are not using the JRE that is installed with the PATROL Agent.

Example:

• (Windows) - If the JRE files reside at C:\Program Files (x86)\Java\jre8\bin\java.exe location then specify the path as C:\Program Files (x86)\Java\jre8
• (Unix/LINUX) - If the JRE files reside at /usr/java/jdk1.8.0_65/bin/ location then specify the path as /usr/java/jdk1.8.0_65