AppDynamics Application Intelligence Platform

3.8.x Documentation



Release Notes

Skip to end of metadata
Go to start of metadata

There are four Geo Dashboards in EUM:

  • The overall Web/Mobile Geo Dashboard
  • The Web EUM Geo Dashboard
  • The iOS Geo Dashboard
  • The Android Geo Dashboard

This topic discusses the Web EUM Geo Dashboard.  

The Web EUM Geo Dashboard

You access the Web EUM Geo Dashboard by selecting the application and clicking End User Experience -> Web in the left navigation bar and making sure the Geo Dashboard tab is selected.

All Geo Dashboards display key EUM performance metrics by geographic location. You can quickly see which regions have the highest loads, the longest response times, and the most errors. You can understand at a glance which locations are active and of the active locations, which are slow. Then you can use this information to drill down into more detailed information for the slowest regions. Green circles indicate normal user experience, yellow warning, and red critical.

For example, in the Dashboard below you can see that the highest end-user response time (which implies the worst end-user experience) is currently in Australia, with France second, and the highest load (number of total page requests) is in California.

How the Web EUM Geo Dashboard is Organized

The dashboard is divided into three panels:

  • A main panel in the upper left displaying geographic distribution of end users on a map, if you selected the map view icon, or on a grid if you clicked the grid view icon.
    • You can switch between map view and grid view by clicking these icons.
    • You can expand the map panel or the grid panel to fill the entire EUM Dashboard by toggling the expand icon in the upper right corner of the panel.
  • A panel on the right displaying:
    • Summary metrics for the selected time range: End User Response Time, First Byte Time, HTML Download and DOM Build Time, and Resource Fetch Time. Click the End User Response Time link to see this metric in the Metric Browser and compare/correlate with other metrics as you wish.
    • Regions with highest end user response times.
    • Regions with the highest load (total number of requests for the selected time range)

  • A lower panel dynamically displaying graphs of key performance indicators (KPI):
    • The number and rate of page requests (load)
    • Average end user response time,
    • Number and rate of page views with JavaScript errors

The metrics displayed throughout the dashboard are for the region currently selected on the map or in the grid. For example, if you zoom down from world view to France in the map, the summary panels and the trend graphs display data for France.

See Web EUM Metrics for definitions of the metrics.

Using Map View

The main panel in map view displays a map superimposed with circles that represent average end user experience by region.

Geographic Drill-Down

You can hover over any region on the map to get summary metrics for that region.

Right-clicking lets you access browser snapshots for the region. See Browser Snapshots.

You can double-click any region on the map to drill down into metrics for that region.

When you drill down into the countries with the the highest levels of monitored traffic, a detailed map with the country's subregions is displayed. You can then drill down further into the subregions.

For locations for which detailed maps are not available, the country or region is colored blue to indicate that it is drilled down. Even when detailed maps are not available for subregions, EUM metrics are still collected and reported for the supported subregions in the summary panels and trend graphs.

For a complete list of the supported regions by country see Web EUM Countries and Regions by Geo Dashboard.

Map Actions

You can perform the following actions directly in the map:

  • Zoom into and drill down to a subregion in the map by clicking on the subregion. 
    • To zoom out to restore the currently selected region to the world or country, click the link in the location control in the upper left corner of the map. For example, if you have drilled down to India and then to West Bengal and now want to return to global view, select "World" in World > India > West Bengal.
  • View summary statistics for a region by hovering over its circle.
  • Zoom the entire map using the slider on the left. You can also use your mouse wheel to increase or decrease the map's zoom level.
  • Reposition the map by clicking and dragging it or by clicking the directional arrows in the map control widget.

Configuring Map View Options

You can configure the dashboard display in a variety of ways:

  • The metric to use for creating the colored circles: 
    • End user response time
    • First byte time 
    • Front end time
  • The ranges for values that trigger the performance indicator colors on the map
  • The circle sizes that indicate relative load on the map
  • Whether to show:
    • Map Controls
    • The US States in the global view
    • The Dark view of the map

All of these configurations are saved for the next time you log into AppDynamics.

To Configure the Map

1. In the Geo Dashboard, click the gear icon in the upper right corner of the map or grid panel to get the configuration window.

2. Select the value you want the load circles to represent.

3. Adjust the color thresholds by using one of the following two methods: 

  • Adjust the threshold slider.
    For example, if you want circles to be red whenever the end user response time is 182 milliseconds or greater, slide the maximum value of the yellow slider value to 182.
  • Edit the threshold slider to set specific values. Double-click the text field that indicates the slider threshold value to make it editable, enter the value of the threshold in the text field, and press the tab key. 
    For example, the following example sets the maximum yellow slider value to 500.

    You can enter as large a value as you like in the field (larger than the current maximum displayed value of the slider) and displayed range of values for the circle color ranges will adjust accordingly.

3. To configure circle sizes representing load (total number of end user requests), adjust the slider to make the circle ranges larger or smaller.

4. To display the map control widget, check Show Map Controls. To hide them clear this check box.
The map controls let you reposition the map using arrows and zoom the map using + and - buttons. After moving or zooming the map, if you want to return to the default zoomed out home view, click the globe icon in the center of the map control widget.

5. To show the individual state boundaries in the United States in global view, check Show US States in global View.
Metrics for individual states are displayed as if they were countries. Click the state in the United States map to display EUM data for that individual state.

6. To view your map with a dark colored background, check View Dark Map. 

Unknown Locations in Map and Grid Views

Requests can originate from locations for which the JavaScript agent has no map data. These requests are labeled as Unknown.

You may see this message at the bottom of the map when you are drilled in on a country for which EUM does not have regional data:

"Geographic information for some requests is unavailable and is not displayed on the map; switch to grid view for unknown regions."

In the map view, you may also see a location named "Unknown" in the highest response times and highest loads panels to the right of the map.

In grid view, aggregated EUM metrics for Unknown locations are displayed under the location name "Unknown".

The number of Unknown entries displayed depends on the current map settings:

  • If the map is set to world view and the Show US States in global view option is selected, you may see two Unknown entries: one for the aggregated metrics from the unknown countries and another for the unknown states.
  • If the map is set to world view and the Show US States in global view option is clear or if the map is set to country view, there is a single Unknown entry which displays the aggregated metrics from the unknown regions in the current country. For example, if there are three unknown regions in Russia reporting metrics, the entry for Unknown represents the aggregated metrics for those three regions.

You may also see a metric reported for a location named "Anonymous Proxy". The data for Anonymous Proxy represents the aggregated metrics from one or more private IP addresses that the JavaScript agent cannot identify.

One of the effects of Unknown regions is that it possible for a country to display as slow (red circles) on the global map, but when you drill down to the country all its regions appear normal (green circles). Or a country may display as normal on the global map, but some subregions may display as slow when you drill down.

Learn More