Geographical locations configuration

AppMon uses the GeoLite2 City database by MaxMind to map and resolve IP addresses to geographical locations. For typical applications, no further setup is required. See Configure Geographic Location to learn how AppMon obtains the Client IP address.

Geographical locations database update

The database containing IP addresses to geographical locations mapping updates as part of a product update. See User Experience Management Data Files for more information.

Map IP address ranges to locations

If monitoring intranet applications, visitors may have private IP addresses. It is impossible to determine the location of these IP addresses. As a result, features such as grouping visits by location are available in this scenario. To exploit the advantages of User Experience Management, map the private IP address ranges to the locations where these ranges are used.

Consider the following example:

A company operates an ALM application that is accessed from a web browser. To ensure availability and application performance and to detect bugs easily, AppMon uses UEM to monitor the ALM application. There are three offices which access this application. They are in New York, Boston, and San Francisco. Internally, the offices use private IP address ranges that the DHCP servers provide. The San Francisco office also uses public IPv6 addresses. The table below shows the IP address setup:

Location Net ID Subnet Mask
New York
San Francisco
San Francisco 2001:1234:C0A8:1E00:: /64

Use the Geographical Locations pane of the Server Settings dialog box to map these private IP ranges. You can edit the mapping from IP ranges to geographical locations manually.

The image details the configuration for the example. Use the Create and Edit buttons to set up and change the mappings for all the relevant IP address ranges.


To map a single IP addresses, use a range of 32 for IPv4 and 128 for IPv6 when you enter the IP address.

Click OK to apply the settings on the AppMon Server immediately.

The subnetmask attribute value is the number of non-zero bits as used in the CIDR notation. The region information is optional but it provides more details within AppMon. In the corresponding XML file, the region is encoded using the ISO 3166-2 standard for the US and Canada and the FIPS 10-4 standard for the rest of the world. The city name is not validated and may be a random string. The country is encoded using the ISO 3166-1 Alpha-2 country codes.


The IP address ranges specified must be disjoint subnets. Foe example, and are disjoint. However, and are not.


For optimal performance, IP mappings are limited to 10000 entries. To modify this limit, edit ipmappings.xml with any text or XML editor. The attribute named limit inside the xml-node ipmappingconfig must be added or modified to contain the desired number of maximum allowed IP mappings.

Import IP address mappings from a CSV file

You can also import IP Address mappings from a CSV file. The Import button next to the table opens a dialog box in which you can choose the CSV file that contains your mappings. AppMon skips conflicting address ranges or invalid lines and logs them to the Client log. The imported file data overwrites existing mappings with identical address ranges.

The following are requirements for the CSV file:

  • Must be UTF-8 encoded.
  • Allowed delimiters are comma, semicolon and tab.
  • Use double quotes if a value contains a delimiter.
  • Escape double quotes inside a value with a preceding double quote.
  • Valid values for country and region are the same as shown in the drop-down menus when manually adding a mapping.

The following is an example:,24,Austria,Oberösterreich,Linz,48.30639,14.28611,24,Poland,Pomorskie,Gdansk,54.35205,18.64637

Geo locations

HTTP request headers

Use HTTP request headers to determine the Client IP address or Server host name.

Locations in the world map

The Geographic locations database contains a list of geographic locations for specific IP addresses throughout the world. However this is never a definitive list. There could be IP addresses that don't appear in this list. You may also want to associate unique custom IP addresses directly to a city's location. To do this, define a geo location for a specific city in the server settings. See Defining Custom Locations in the World Map for more information.