Map IP addresses to network elements

Network element mapping enables you to furnish information on your Host IPs for network elements. This mapping is used by AGILITY parsers to detect network elements and improve the precision and relevance of parsed call flows and their corresponding predictions.

If your analyses results in AGILITY show unknown network elements, mapping your host details to network elements allows AGILITY to identify those network elements in future analyses.
You can map network elements one-by-one manually or create a .csv file and import them as a batch.

Map network elements manually

  1. From the AGILITY homepage, select Settings > Application Settings.

    application-settings.png
  2. Select Edit on the Hosts IP & Network Elements Mapping card.

    NE-host-mapping-main.png
  3. Select Enter Data on the Manually Enter Data option.

  4. Enter the domain name, IPV4, or IPV6 in the Host field. You may use:

    • IPv4 addresses with "^(?:[0-9]{1,3}\\.){3}[0-9]{1,3}$"

    • IPv6 addresses with "^(?:[0-9a-fA-F]{1,4}:)+[0-9a-fA-F]{1,4}$"

    • Domain names with "^[a-zA-Z0-9.-]+$"

  5. Choose the corresponding Network Element from the drop-down list.

  6. (Optional) Add a Domain Name corresponding to the entry to easily identify network entities.

  7. Select Add (or select the check mark and Save).

  8. (Optional) To add additional entries, select Add Entry.

Edit network elements

To change a network element mapping:

  1. From the AGILITY homepage, select Settings > Application Settings.

  2. Select Edit on the Hosts IP & Network Elements Mapping card.

  3. Select Enter Data on the Manually Enter Data option.

  4. Select the edit icon next to the entry that you want to change.

  5. Change the entry and select the check mark and Save.

Delete network elements

To remove a network element mapping:

  1. From the AGILITY homepage, select Settings > Application Settings.

  2. Select Edit on the Hosts IP & Network Elements Mapping card.

  3. Select Enter Data on the Manually Enter Data option.

  4. Select the edit icon next to the entry that you want to change.

  5. Select the “x” beside the mapping you want to remove, and select Save.

Note: A known issue exists which prevents removing mappings when there is only one entry. To remove the entry, import an empty .csv file, which will remove all mappings.

Create a file import .csv file

To import mappings using a file, you first need to create a .csv file with the required information. You can create the file using a spreadsheet application and export in .csv format, or use any text application and save as a .csv file.

Your .csv file must contain a comma-separated list in the format:

[host], [network element name]

For the host, you may use any of the following:

  • IPv4 addresses with "^(?:[0-9]{1,3}\\.){3}[0-9]{1,3}$"

  • IPv6 addresses with "^(?:[0-9a-fA-F]{1,4}:)+[0-9a-fA-F]{1,4}$"

  • Domain names with "^[a-zA-Z0-9.-]+$"

For the network element name, you can choose any that are currently supported by AGILITY. A complete list is available from the Import a host file window. You can access this window by selecting Import Data from Hosts IP & Network Elements Mapping and selecting List of available network elements.

Example .csv file

192.168.1.1,SGW
2001:0db8:85a3:0000:0000:8a2e:0370:7334,MME
server.example.com,ENODEB
192.168.1.3,SGW

Map network elements by file import

Important: When you import mapping elements from a .csv file, all pre-existing mappings in your settings are overwritten.

  1. From the AGILITY homepage, select Settings > Application Settings.

  2. Select Edit on the Hosts IP & Network Elements Mapping card.

  3. Select Import File on the Import Data option.

  4. Drag and drop your .csv file into the window, or select Browse and choose your file. The file is loaded and the file name displays in the window.

  5. Select Save to import your mapping file.
    The window verifies that the import was successful and displays what information was added and if there are any items which were not accepted.

  6. Select Close to close the window and return to the Hosts IP & Network Elements Mapping page.