AVD Web Access Test

The AVD Web Access test emulates a user accessing the AVD service, and reports on the availability and responsiveness of the service over the web. Since this test can be executed from a location external to AVD, this test presents an unbiased external perspective of the state of the service.

Target of the Test: A Microsoft AVD Broker

Agent deploying the test: A remote agent

Output of the test: One set of results for every URL being monitored

Configurable parameters for the test

Test period

How often should the test be executed

Host

The IP address of the host for which this test is to be configured.

Port

The port at which the specified Host listens.

URL

This test emulates a user accessing the URL of the AVD service to determine the availability and responsiveness of the service. To enable this emulation, you need to configure the test with the URL that it should access. Specify this URL against the URL parameter. If required, you can even configure multiple URLs. If each URL configured requires special permissions for logging in, then, you need to configure the test with separate credentials for logging into every URL. Likewise, you need to provide instructions to the test on how to validate the content returned by every URL, and also set an encoding format for each URL. To enable administrators to easily configure the above per URL, eG Enterprise provides a special interface. To access this interface, click on the encircled ‘+’ button alongside the URL text box in the test configuration page. To know how to use this special interface, refer to Configuring Multiple URLs for Monitoring.

Cookie File

Whether any cookies being returned by the web server need to be saved locally and returned with subsequent requests

Proxy Host

The host on which a web proxy server is running (in case a proxy server is to be used)

Proxy Port

The port number on which the web proxy server is listening

Proxy Username

The user name of the proxy server

Proxy Password

The password of the proxy server

Confirm Password

Confirm the password by retyping it here.

Timeout

Here, specify the maximum duration (in seconds) for which the test will wait for a response from the server. The default TIMEOUT period is 30 seconds.

Report DNS Time

DNS lookups can cause significant delays in rendering a webpage. To avoid such delays, administrators may want to know how long the DNS server takes to respond to the requests. To help administrators in this regard, this test reports the DNS response time measure when the Report DNS Time flag is set to Yes. By default, this flag is set to No indicating that this test will not report the DNS response time measure by default.

 

Measures reported by the test:

MeasurementDescriptionMeasurement UnitInterpretation

Web availability

Indicates whether the AVD service was able to respond successfully to the query made by the test.

Percent

Availability failures could be caused by several factors such as the web server process(es) being down, the web server being misconfigured, a network failure, etc. Temporary unavailability may also occur if the web server is overloaded. Availability is determined based on the response code returned by the server. A response code between 200 to 300 indicates that the server is available.

Total response time

Indicates the time taken by the AVD service to respond to the requests it receives.

Secs

Response time being high denotes a problem. Poor response times may be due to the server being overloaded or misconfigured. If the URL accessed involves the generation of dynamic content by the server, backend problems (e.g., an overload at the application server or a database failure) can also result in an increase in response time.

TCP connection availability

Indicates whether the test managed to establish a TCP connection to the AVD service.

Percent

Failure to establish a TCP connection may imply that either the web server process is not up, or that the process is not operating correctly. In some cases of extreme overload, the failure to establish a TCP connection may be a transient condition. As the load subsides, the server may start functioning properly again.

TCP connect time

Quantifies the time for establishing a TCP connection to the web server host.

Secs

Typically, the TCP connection establishment must be very small (of the order of a few milliseconds). Since TCP connection establishment is handled at the OS-level, rather than by the application, an increase in this value signifies a system-level bottleneck on the host that supports the web server.

Server response time

Indicates the time period between when the connection was established and when the service sent back a HTTP response header to the client.

Secs

While the total response time may depend on several factors, the server response time is typically, a very good indicator of a server bottleneck (e.g., because all the available server threads or processes are in use).

Content validity

Validates whether the service was successful in executing the request made to it.

Percent

A value of 100% indicates that the content returned by the test is valid. A value of 0% indicates that the content may not be valid. This capability for content validation is especially important for multi-tier web applications. For example, a user may not be able to login to the web site but the server may reply back with a valid HTML page where in the error message, say, "Invalid Login" is reported. In this case, the availability will be 100 % (since we got a valid HTML response). If the test is configured such that the content parameter should exclude the string "Invalid Login," in the above scenario content validity would have a value 0.

Response code

Indicates the response code returned by the service for the simulated request.

Number

A value between 200 and 300 indicates a good response. A 4xx value indicates a problem with the requested content (eg., page not found). A 5xx value indicates a server error.

Content length

Indicates the size of the content returned by the service.

Kbytes

Typically the content length returned by the server for a specific URL should be the same across time. Any change in this metric may indicate the need for further investigation on the server side.

Data transfer time

 

Indicates the time taken for a data transfer between the drive and the host system.

Secs

Data transfer time being high denotes a problem..

DNS availability

Indicates whether the DNS server was able to respond successfully to the request made to it.

Percent

While the value 100 for this measure indicates that the DNS server is available and successfully responded to the request, the value 0 indicates that the DNS server is unavailable or is not responding to requests. Availability failures could be caused by many reasons such as a network failure. Sometimes, the DNS server may be reachable through basic network testing, but may not respond to DNS queries from clients.

Note:

This measure will be able to report a value only if the URL parameter of the test is configured with a domain name-based URL – eg., http://www.eginnovations.com, http://www.eBooks.com. If the URL parameter is configured with an IP-based URL instead – eg., http://192.168.10.21:80, http://192.168.10.34:7077 – then, this measure will not report any value. This is because, to report the availability of the DNS server, the test attempts to connect to the DNS server and resolve the domain name in the URL to its IP address. If the test is able to perform domain name – IP address resolution successfully, it reports the value 100 for this measure. If the resolution fails, the test reports the value 0. In case of an IP-based URL naturally, the test will not be able to find any domain name to resolve. The test therefore will not report any value for this measure in that case.

Configuring Multiple URLs for Monitoring

By default, the AVD Web Access test will be configured with the URL of the access portal of the AVD service. To configure additional URLs, do the following:

  1. Click on the encircled ‘+’ button alongside the URL text box in Figure 1.

    Configuring AVD Web Access Test

Figure 1 : Configuring the AVD Web Access test

  1. Figure 2 then appears. To add another URL, click the Add More button in Figure 2.

    Configuring Multiple URLs

Figure 2 : Configuring multiple URLs

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

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

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

    • Username and Password: These 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 URL configured for monitoring 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.

    • Content: 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*.

    • Encoding: 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.

    • Private Key File Path and Password: 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.

    • Method: Using this parameter, you can indicate how you want the eG agent to execute this test. If you want the eG agent to always run this test using the Java executable alone, then pick the Only Java option from the Method drop-down. Likewise, if you want the eG agent to always run this test using the cURL utility alone, then choose the Only cURL option from the Method drop-down. On the other hand, if you want the eG agent to automatically detect what methodology was successful in reporting metrics for this test during the last measure period, and employ the same methodology to run the test during the current measure period, then you need to go with the default selection - i.e., Auto-detect. This default setting is useful in environments where neither methodology (Java or cURL) can be relied upon to continuously report metrics for this test. In other words. the default setting is ideal for environments where the Java executable may have been successful in collecting metrics a few times, and the cURL utility may have been successful at other times.

    • System Properties - Property and Value : Some web pages (URLs) configured for monitoring may have been designed to allow access for only those requests that have certain specific properties enabled. For instance, web pages of an SSL-enabled web site may have been designed to support TLS v1.3 requests alone. In such a case, you will have to instruct the test to send connection requests to the configured URL over the TLS v1.3 protocol alone; if not, the test will fail. For this, you can use the Property and Value text boxes in the System Properties section. Specify the request property that the test needs to look up, in the Property text box. In the Value text box, enter the value this property should be set to, so that the eG agent is allowed access to the configured web page. In the case of the above example, you will have to specify -Dhttps.protocol in the Property text box and TLSv1.3 in the Value text box. You can even provide a comma-separated list of values in the Value text box. For example, if the web page supports multiple versions of the TLS protocol, then the Value specification will be: TLSv1.1,TLSv1.2,TLSv1.3. You can even configure more than one Property:Value pair, if the configured URL supports multiple properties. To add another pair, click on the encircled '+' button adjacent to the Value text box.

  2. 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 Figure 2. To update all the changes you made, click the Update button.
  3. 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.