Oracle Cloud Infrastructure Documentation

Geo IP Mapping

About Geo IP Mapping

  • Provide users the ability to override the GeoMap view configuration from Trace Explorer by adding an IP address map.

  • Use a template file in CSV format to upload the desired IP addresses and geographical locations.
  • Once it's updated, the GeoMap option shows traces and spans from the IP addresses uploaded using the template file and their respective geographical location.
    Note

    If there is an overlap in IP address ranges, mapping with the smallest IP address range is applied. For example, 10.0.0.0/8 and 10.0.0.0/20 are entries in the custom geo IP mapping. In this case the smallest IP range: 10.0.0.0/20 will be mapped if the traffic comes from IP address 10.0.10.10.

  • They are configured at APM Domain level.

Manage Geo IP Mapping

To update the geographical IP address map, do the following:

  • Go to the APM Domains page and click on the desired APM domain.

    The Domain Details page is displayed.

  • Go to Resources, located at the bottom left, click Geo IP Mapping and then Add Geo IP Map.

    The Add Geo IP Map window is displayed.

  • Click Download CSV Template.

    The CSV template file is downloaded.

  • Review the template file, update it with your desired geographical IP addresses and locations information and save it.

    For reference, see below an example of an updated template file:
    Subnet,Continent,Country,Country Code,Region Code,City,Company/ISP,Longitude,Latitude
28.153.96.4/7,AF,South Africa,ZAF,ZA-NL,Johannesburg,,,
1::1/8,EU,Netherlands,NLD,NL-ZH,Amsterdam,Oracle,-5.21343241413423423423423,15
10.0.0.0/8,US,United States,USA,US-CA

  • Upload the updated file by using the Drag and Drop box and click Submit.

After submitting, you can verify the updates by going to Trace Explorer and click on GeoMap view, or View Span Details for spans stemming from the mapped IP addresses. You see the geographic locations based on the mapping of the IP addresses specified in the CSV file.