AppDynamics Application Intelligence Platform
By default, end-users' locations are resolved using public geographic databases. You can host an alternate geo server for your countries, regions, and cities instead of using the default geo server hosted by AppDynamics.
Some customers prefer to host their own geo server because:
To host a custom geo server:
Download the GeoServer-2.0.zip file from AppDynamics at
This compressed file contains:
Deploy the geo.war in a separate Tomcat/Jetty web container. Do not deploy the geo.war file in the same container as the controller.
Enter the URL, including the context root, of your hosted geo server in the Geo Server URL field in the configuration screen. In the following configuration the context root is "/geo".
The local-map.xml IP mapping file specifies the locations for which EUM provides geographic data. It maps IP addresses to geographic locations.
Edit the local-map.xml, which was downloaded with the geo.war file, for your environment. This file contains a <location> element for every location to be monitored. The file has the following format.
The <country>, <region>, and <city> elements are required. If the values of <country> and <region> do not correspond to an actual geographic location already defined in the geographic database, map support is not available for the location in the EUM map panel, but EUM metrics are displayed for the location in the grid view of the geographic distribution, end user response time panel, trend graphs, browser distribution panel, and in the Metric Browser. The <city> element can be a string that represents the static location of the end-user. You will notice that at least one of the location elements has the
is-default=true attribute set. If there is an IP address that is not covered by your IP mapping file this is the value that is used. To use a public geo-server for non-covered IP addresses, see Using a Hybrid Custom-Public Geo Server Setup.
This data is visible in browser snapshots and can be used to filter browser snapshots and to filter browser snapshots for specific locations:
The valid names for country and region are those used in the map in the geo dashboard. You can hover over a region in the dashboard to see the exact name (including spelling and case) of the region. See The Web EUM Geo Dashboard View.
If you want EUM to evaluate any non-mapped IP address using the public geo-server, remove any location elements with the
is-default=true attribute set. In this case locating any non-mapped IP address is done in the EUM cloud, not locally.
In the web.xml file, set the
ip.mapping.config property to the path of the IP mapping file. The web.xml file is in the geo.war file.
You can also set the log directory for the geo server and the number of seconds that geo data should be cached,
Add the mapping information as follows:
This example assumes that you are using a modified local-map.xml file. If you created a new mapping file instead, use the name of that file in the <param-value> element instead of "local-map.xml" for the
If you are deploying your custom geo server on Windows, use the following additional instructions.
1. Unzip the geo.zip file you downloaded in Download the Geo Server File to D:\Appdynamics.
2. Copy D:\Appdynamics\geo\local-map-template.xml to D:\Appdynamics\geo\local-map.xml.
3. Edit the local-map.xml file as described in Create the IP Mapping File above.
4. Copy D:\Appdynamics\geo\geo.war to D:\apache-tomcat\webapps.
5. Restart the Tomcat server.
6. Stop the Tomcat server.
7. Edit the following in D:\apache-tomcat\webapps\geo\WEB-INF\web.xml:
8. Start the Tomcat server.
9. Test as follows on a Web browser that is not IE:
If, for example, you mapped 192.168.1.1 to India/Kernataka/Bangalore, the result would be a JSON document similar to this:
localIP value is a hex-encoded version of the original IP (in this case, 192.168.1.1), compressed for space.