Configuring URLs for Monitoring

By default, the AzureWebAcsTest test will be configured with the URL of the home page of the target Azure cloud being monitored. To configure additional URLs, do the following:

1. Click on the encircled ‘+’ button alongside the URL text box in the test configuration page.

2. The CONFIGURATION OF URL PATTERNS page will then appear. TO add another URL, click the Add More button in the page.

3. Another URL specification section will appear. Specify the following in that section:

   • Specify a unique name by which the URL you will be specifying shortly will be referred to across the eG user interface in the Name text box. This is the name that will appear as the descriptor of this test.

   • Enter the URL of the web page that this test should access.

   • The Username and Password parameters are to be set only if a specific user name / password has to be specified to login to the web page (i.e., URL ) that you have configured for monitoring. In this case, provide valid login credentials using the Username and Password text boxes. If the web server on which Azure Web Access test executes supports ‘Anonymous user access’, then these parameters will take either of the following values:

     • A valid Username and Password for the configured URL

     • none in both the Username and Password text boxes of the configured URL, if no user authorization is required

     • Some web servers however, support NTLM (Integrated Windows) authentication, where valid login credentials are mandatory. In other words, a none specification will not be supported by such web servers. Therefore, in this case, against each configured URL, you will have to provide a valid Username in the format: domainname\username, followed by a valid Password.

     • Please be sure to check if your web site requires HTTP authentication while configuring this parameter. HTTP authentication typically involves a separate pop-up window when you try to access the page. Many sites use HTTP POST for obtaining the user name and password and validating the user login. In such cases, the username and password have to be provided as part of the POST information.

   • The Content parameter has to be configured with an instruction:value pair that will be used to validate the content being returned by the test. If the Content value is None, no validation is performed. On the other hand, if you pick the Include option from the Content list, it indicates to the test that for the content returned by the web server to be valid, the content must include the specified value (a simple string search is done in this case). This value should be specified in the adjacent text box. Similarly, if the Exclude option is chosen from the Content drop-down, it indicates to the test that the server's output is valid if it does not contain the value specified in the adjacent text box. The Include or Exclude value you specify in the text box can include wildcard characters. For example, an Include instruction can be *Home page*.

   • Sometimes the eG agent has to parse the URL content with specific encoding other than the default (ISO-8859-1) encoding. In such a case, specify the type of encoding using which the eG agent can parse the URL content in the Encoding text box. By default, this value is none.

   • SSL-enabled web sites are typically secured by a private key, public key, or a public-private key pair. If the web page configured for this test is SSL-enabled - i.e., if an HTTPS URL is specified against URL - and the contents of this web page can only be accessed using a private key, then the full path to the private key file will have to be provided against Private key file path and the Password of the private key file should be specified against Password. If no such private key protects the contents of the configured URL, then set the Private key file path and its Password to none.

4. Similarly, you can add multiple URL specifications. To remove a URL specification, click on the encircled ‘-’ button corresponding to it. To clear all URL specifications, click the Clear button in the CONFIGURATION OF URL PATTERNS page. To update all the changes you made, click the Update button.

5. Once Update is clicked, you will return to the test configuration page. The URL text box in the test configuration page will display just the Names - i.e., the unique display names - that you may have configured for the multiple URLs, as a comma-separated list. To view the complete URL specification, click the encircled ‘+’ button alongside the URL text box, once again.