 |
|
|
DesktopResponse™ Web ServicesHow To... |
How To... Index
1. Filter Reports for My Page(s)
DesktopResponse 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 DialogFor 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 DesktopResponse script inserted in your page. The addition of the wildcard character (*) should be used to ensure a match is found.
2. View Status Reports
DesktopResponse provides a number of status reports. With the exception of the World Response report, status reports update every minute to provide a real-time view of the selected data. Under the heading 'Status' on the DesktopResponse Web Interface (see fig 2.1 below) you have eight links: World Response, Country Response, Critical Response, Warning Response, URL Response, ASN Response, Carrier Response and City Response.
Fig 2.1. Status Reports Menu
World Response
Fig 2.2. Section of World Map with MarkersWhenever a user hits a web page that has been set up to be monitored, DesktopResponse 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 default World Map will show all transactions for all web pages being recorded. You can also filter the report to include only your page(s).
Fig 2.3. Data Filter DialogThe user can filter the World Map results either by selecting a variable time window and/or applying an expression (Fig 2.3).
Fig 2.4. Expression Descriptions and Methods
Expression Variable Description Methods Supported ms Milliseconds >, <, =, and, or cc Country Code >, <, =, and, or url URL selection (supports * wild card) >, <, =, and, or ip IP address (supports CIDR) <,>,=, and, or sc success code (1 or 0) >,<,=, and, or
Country Response
The Country Response 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.
Fig 2.5. Country Response ReportThe table below shows the data elements reported for the status report options.
Fig 2.6. Overall Status and Filter
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) 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
Fig. 2.6. Critical ResponseYou 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 Response
The URL Response report is similar to the Country Response report except the report is summarized by each URL being monitored by country (see fig 2.7 below).
Fig 2.7. URL Response ReportURL Response 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.8 below) of the URL measures over time.
Fig 2.8. Graph for vus.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 DesktopResponse 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 DesktopResponse Web Interface, 'hot links' are provided that allow you to view live or historic data as a graph.
ASN Response
The ASN Response report shows the figures for different networks and lists them by ASN and Carrier
Fig 2.9: ASN ResponseYou can use the expressions filter to customize the report.
ISP Carrier Response
The Carrier Response report shows from which networks your web pages are being monitored from. They are listed by network.
Fig 2.10: Carrier ResponseYou can use the expressions filter to customize the report.
City Response
The City Response report summarizes the transactions by city showing the minimum (Min), average (Avg), and maximum (Max) latency for all transactions in the group (see fig 2.11 below).
Fig 2.11: City ResponseYou can use the expression filter to customize the report.
3. Viewing History Reports
Fig 3.1. History Reports MenuUnder 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 DesktopResponse 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.
Fig 3.2. Trace Report DataWhenever a threshold is broken, DesktopResponse 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).
Fig 3.3. Trace ExampleTrace 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
Fig 3.4. Last Hour DataFigure 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.
Fig 3.5. Average Latency, for every country, for every 5 minutes in the last hour.
Last 24 Hours History ReportThe 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).
Fig 3.6. Filter for Custom PageFor 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.
Fig 3.7. Custom Report Example
