VisualResponse Web Services 

How To...

How To... Index

1. Filter Reports for My Page(s)

2. View Status Reports
    World Response
    Country Response
    Critical Response
    Warning Response
    URL Response
3. View History Reports
    Trace Report
    Trace Routes
    Last Hour
    Last 24 Hours
    Last 30 Days
    Custom



1. Filter Reports for My Page(s)    

VisualResponse Status Reports can be filtered to include only data of interest to you.  When generating a report, you may filter the data using the Filter Viewed Items dialog (fig 1.1) using the available filter options for that report.  Available filter options are detailed in the appropriate subsections of this manual.


Fig 1.1. Sample Filter Viewed Items Dialog

For example, to filter the date to report only on your web page, use the following syntax in the Expression field:

     url=myalias*

Where myalias is the unique identifier you used within the VisualResponse script inserted in your page.  The addition of the wildcard character (*) should be used to ensure a match is found. 

2. View Status Reports   

VisualResponse provides a number of status reports. With the exception of the World Response report, status reports update regularly to provide a real-time view of the selected data. Under the heading 'Status' on the VisualResponse Web Interface (see fig 2.1 below) you have five links: World Response, Country Status, Critical Response, Warning Response and URL Status.

 

World Response

Whenever a user hits one of the web pages you have set up to be monitored, VisualResponse will record the response time and location of the transaction. This is displayed on the world map as a pie chart on top of a meter bar. The pie charts indicate a number of values. The color coding displays the pie in sections of Red (critical), Yellow (warning), and Green (healthy) to indicate the percentage of  transactions to the region marked. The size of the  pie chart indicates the percentage of the transaction volume for the time window being viewed. The bar indicates the spread of transactions plus or minus one standard deviation.

The user can filter the World Map results either by selecting a variable time window and/or applying an expression (Fig 2.3).

Expression Variable Description Methods Supported
ms Milliseconds >, <, =, and, or
cc Country Code >, <, =, and, or
url URL selection (support * wild card) >, <, =, and, or
ip IP address support CIDR <,>,=, and, or
sc success code (1 or 0) >,<,=, and, or

Fig 2.4. Expression Descriptions and Methods

 

Country Status

The Country Status report summarizes the transactions by country showing the minimum (Min), average (Avg), and maximum (Max) latency for all transactions in the group (see fig 2.5 below). The table in figure 2.6 provides detailed field descriptions.

The table  below shows the data elements reported for the status report options.

Min Latency (ms) The minimum response time in milliseconds
Avg. Latency (ms) The average response time in milliseconds
Max Latency (ms) The maximum response time in milliseconds
Std Deviation (ms) The standard deviation in milliseconds
Count (Red) A count of all the transactions that have exceeded the critical threshold defined
Count (Yellow) A count of all the transactions that have exceeded the warning threshold defined
Count (Green) A count of all the transactions that have not exceeded the critical or warning threshold defined.
Total The total number of transactions from this country
IP Count The number of unique IP addresses (i.e. users)

Fig. 2.6. Overall Status and Filter

The filter option is provided at the bottom of the Country Status report to allow a filter to be applied to the report view.

 

Critical Response

Critical Response shows a report of all URLs that have exceed the critical threshold.

You can also use the filter expression to tailor the filtered report. For example if you want to view all times that are greater than 40 seconds  you would type ms>40000 into the expression dialog box. Other expressions that can be used are explained in table 2.3 above.

 

Warning Response

This table is exactly the same as the Critical warning layout except it only shows users that have exceeded the warning response time you have set in Preferences.

 

URL Status

The URL Status report is similar to the Country Status report except the report is summarized by each URL being monitored by country (see fig 2.8 below).

URL Status shows the data collected in the last 5 minutes from each web page (URL) you are monitoring.  If one of your pages has not been hit in the last five minutes, then it will not show up in the table.  Note: the code 'vus-' and 'vuk-' are defined in the script syntax for the URL, this allows the full web page URL to be abbreviated for the reports.

Clicking on the URL link will display a graph (see fig 2.9 below) of the URL measures over time.

By default, host graphs display live data, allowing you to monitor latency information in real time. However, you may optionally choose to plot historical data.  Facilities are then provided to allow you to specify a time span and summary interval which VisualResponse uses to retrieve and display this information.  These facilities include:

Time Span - Indicates time span to be reported in an historical plot.  If 'Custom' is selected, this window is defined by the 'Begin' and 'End' fields.

Begin - The time span starting point. Modify by using arrow keys or right/left mouse clicks.

End - The time span ending point. Modify by using arrow keys or right/left mouse clicks.

Interval - The summarization interval used for historical data.

Plot live data - Indicates whether or not to plot live data, rather than historical data.

Fit data to plot - Causes historical data to display such that the requested time span fills the entire plot window.

OK - Requests a new plot, using the criteria described above.

On all tables of data throughout the VisualResponse Web Interface, 'hot links' are provided that allow you to view live or historic data as a graph.


3. History Reports   

Under the heading Reports you get the following links: Trace Report, Trace Routes, Last Hour, Last 24 Hours, Last 30 days and Custom.

 

Trace Report History Report 

The Trace Report lists all the traces conducted by VisualResponse when critical or warning conditions have occurred. This report displays the last hop time for the trace. Note the color coding is not the same as the warning and critical thresholds of the Status and History reports. The Trace Report is color coded based on the user preferences for Trace Reports.

Whenever a threshold is broken, VisualResponse will automatically run a trace and those traces are logged in 'Trace Report.' It tells you the exact time the trace was done and where the user was accessing the page from. The trace is done from the IP address web server to the destination IP address. If you click on one of the 'Trace Date/Time' links, the trace detail is displayed  (see fig.3.3 below).


 

Trace Routes History Report

The Trace Routes report shows all the hops from the web server to the destination. This reports the latency and the packet loss for each hop along with the network node name. The Trace Routes report also provides a 'previous/next' trace button to allow the user to scroll to the next trace in the log file. Alternatively a date/time stamp can be defined using the 'Show' button.


Last Hour History Report

Figure 3.4 shows the Last Hour report. This report provides country name, green, yellow and red counts, the average latency for each country and the IP count for that country summarized for the last hour. If any of the thresholds you have set have been exceeded, the report section is color coded.  If the number of thresholds is over the set % defined in the user preferences, it will highlight that section. The Hour detail report (see fig 3.5 below) summarizes the hour in 5 minute intervals.


Last 24 Hours History Report

The Last 24 Hours report is the same as the Last Hour report, but covers 24 hours and the summarization is by hour.

 

Last 30 Days History Report

The Last 30 Days report is the same as the Last 24 Hours report, but covers the last 30 days and the summarization is by day.

 

Custom History Report

The Custom History report allows the user to select the time period, the countries to report on, and the granulation for the summarization. This is done using the custom filter dialog (see fig 3.6 below).

For example, the report shown below reports latency for the United Kingdom (GB) on October 10, from 00:00:00 to 00:30:00, summarized by 5 minutes. 






© 1997-2005 Visualware Inc. | All rights reserved | Legal Information