Names and look-ups: Difference between revisions

From Allegro Network Multimeter Manual
Jump to navigation Jump to search
Access restrictions were established for this page. If you see this message, you have no access to this page.
No edit summary
(Add information for VLAN naming list)
 
(37 intermediate revisions by 8 users not shown)
Line 1: Line 1:
It is possible to label IP and MAC address with custom names and group
On this settings page, user defined names for IPs, MAC addresses and ports can be configured, as well as the configuration for active look-ups using DNS resolve or traceroute.
them together into categories to allow for easy access to specific
systems. For example, all your internal machines could be labeled to
match their actual name and you can categorize them into different
departments.


These user defined names are persistent and are available from start
= User defined names =
on.


<br>
It is possible to label IP and MAC address, as well as TCP-/UDP-ports with custom names and group them together into categories to provide easy access to specific systems.
For example, all your internal machines could be labeled to match their actual name and you can categorize them into different departments.


==''' Configuration'''==
These user defined names are persistent and are available from start on. All entries are assigned per Allegro Appliance and not per user. An assigned name is available for all users.
<br>


'''Adding or remove entries'''


The configuration of the list of names is available via "Settings ->
== Configuration ==
User defined names".


The configuration page shows on top the list of IP and MAC names
The configuration of the list of user defined names is available via '''Settings -> Names and look-ups'''.
currently set in the system. It is possible to search for a specific
entry by entering the IP or MAC address, or the category or actual
name.


Individual entries may be removed from the list by clicking at the
'''Web Interface'''
trashcan symbol in the last column.
{| class="wikitable"
|-
|[[File:User defined names.png|800px|none]]
|}
 
=== IP names, MAC names and VLAN names ===
 
'''Adding or removing entries'''
 
In the tabs for IP, MAC and VLAN names, the configuration page shows on top the list of names currently set in the system.
It is possible to search for a specific entry by entering the IP or MAC address or VLAN tag, category or actual name.
 
Individual entries may be removed from the list by clicking at the trashcan symbol in the last column.
 
At the bottom of the table new elements can be added by entering the IP or MAC address or VLAN tag, the category and name of the element.
By clicking the '''plus''' symbol, the entry is added and will be used without further doing.


At the bottom of the table new elements can be added by entering the
The complete IP, MAC and VLAN lists can be cleared by clicking the respective clear button below the table, a dialog will ask for confirmation.
IP or MAC address, and the category and name of the element. By
clicking at the "plus" symbol, the entry is added and will be used
without further doing.


The complete IP or MAC address list can be cleared by clicking at the
Names may also be set directly at the IP or MAC detail page, see below for more information.
bottom below the table. A dialog will ask for confirmation.


Names may also be set directly at the IP or MAC detail page, see below
for more information.


<br>
'''Importing IP list'''
'''Importing IP list'''


The IP names allows importing an IP list from an external URL or
IP names can be imported as an IP list from an external URL or a file in the format:
from a file in the format:


  {| class="wikitable"  
{| class="wikitable"  
|#A line with a commend
|#A line with a comment
1.2.3.1   
1.2.3.1   


Line 50: Line 47:
   
   
1.2.3.3  
1.2.3.3  
  |}
|}
    
    
By clicking on "Import list" a dialog will be openend where you can choose to
By clicking on '''Import IP list''' a dialog will be opened where you can choose to download such a list from a given URL or specify a file from your system.  
download such a list from a given URL or specify a file from your system. The
The IPs are added to the already existing ones.
IPs are added to the already existing ones.


<br>


'''Uploading or downloading the complete list'''
'''Uploading or downloading the complete list as CSV file'''


Depending on the use case, the number of elements to add may be
Depending on the use case, the number of elements to add may be large.  
large. In this case it is also possible to upload a comma separated
In this case it is also possible to upload a comma separated text file (.csv).  
text file (.csv). The format is simple as follows:
The format is simple as follows:


{| class="wikitable"
{| class="wikitable"
|ip,192.168.0.1,category,name
|ip,192.168.0.1,category,name
mac,00:00:00:00:00:00,category,name  
mac,00:00:00:00:00:00,category,name
 
vlan,4,category,name<br>
...
...
|}
|}


The first column defines whether the line describes an IP or MAC
Each line describes one entry.
address. The second column is the actual address and the third and
The columns contain the following information in this order:
fourth is the category and the name of the entry.
# Entry type. Can be '''ip''' for an IP address, '''mac''' for a MAC address or '''vlan''' for a VLAN tag.
# Actual address or tag.
# Category name.
# Entry name.
 
A template file which may be opened in a spreadsheet application can be downloaded using the '''Download CSV template''' button.
 
The final file can be uploaded by clicking the '''Upload CSV list''' button and selecting the file from your local directory.
 
The current list can be downloaded by clicking the '''Download''' button. The CSV file will contain IP and MAC addresses, and VLAN tags.
 
=== L4 port names ===


The web page allows to download a template file which may be opened in
'''Adding or removing entries'''
a spreadsheet application.


The final file can be uploaded by clicking at the upload button and
On top of this tab, a list of configured TCP- and UDP-port names is shown.
selecting the file from your local directory.
Entries from this list can be removed by clicking the trashcan icon on the right of each entry line.


The current list can be downloaded also by clicking at the download
New port names can be created by clicking the '''Add port name''' button on the bottom of the list.
button. The CSV file will contain both IP and MAC addresses.
A configuration dialog pops up and allows to select the protocol type (TCP or UDP) and configure the port number as well as the name.


<br>
== Name display for user defined names ==


==''' Name display for user defined names'''==
If a user defined name is configured for an IP or MAC address or VLAN tag, the name will be shown among the alternative names (which also include possible DNS, DHCP name, or other sources of information).


<br>
In the IP and MAC overview screenshots below, the IP or MAC column is highlighted to indicate such special entries for which a name is configured.


If a user defined name is configured for an IP or MAC address, the
{| class="wikitable"
name will be shown among the alternative names (which also include
|- 
possible DNS, DHCP name, or other sources of information).
![[File:Ap-mm-ip-list-user-defined-name.png|800px|none]] !! IP  
|}


{|
{| class="wikitable"
|-
! [[File:Ap-mm-mac-list-user-defined-name.png|800px|none]] !! MAC
|[[File:Ap-mm-ip-alternative-names.png|600px|thumb|center]] || [[File:Ap-mm-mac-alternative-names.png|600px|thumb|right]]
|-         
! IP !! MAC  
|-
|-
|}
|}




In the detailed page for a single IP or MAC address, you can click on the pencil symbol to directly set a name for this specific address.


{| class="wikitable"
|- 
![[File:Ap-mm-ip-alternative-names.png|800px|none]] !! IP
|}


 
{| class="wikitable"
In the detailed page for a single IP or MAC address, you can click on
! [[File:Ap-mm-mac-alternative-names.png|800px|none]] !! MAC 
the pencil symbol to directly set a name for this specific address.
 
{|
|-
! IP !! MAC 
|-         
|[[File:Ap-mm-ip-list-user-defined-name.png|600px|thumb|center|User defined names]] || [[File:Ap-mm-mac-list-user-defined-name.png|600px|thumb|right|User defined names]]
|-
|-
|}
|}


The IP and MAC overview, the IP or MAC column is highlighted to
== Filtering==
indicate such special entries for which a name is configured.


<br>
It is possible to enter the category or user defined name for IP and MAC filters.


==''' Filtering'''==
Also, the '''name''' check in [[Live filtering of tables|complex filters]] matches the user defined name, like in this example:


{| class="wikitable"
|(name=systemA)
|}


It is possible to enter the category or user defined name for IP and
MAC filters.


Also, the "name" check in :doc:`complex filters <filtering>` matches
It is also possible to filter for a specific category by using the '''category''' check:
the user defined name, like in this example:


{| class="wikitable"
{| class="wikitable"
   |(name=systemA)
   |(category=server)
|}
|}


In this example, the list would only show those elements for which a user defined name is set and its category contains the string '''server'''.
= DNS resolve =


It is also possible to filter for specific category by using the
The Allegro Network Multimeter can resolve IP addresses by using the DNS server known to the management interface. A reverse lookup is being performed and the retrieved naming information is shown next to the IP address in various modules.
"category" check:


{| class="wikitable"
The DNS resolving can also be configured to run periodically after an interval passed and try to resolve IPs of certain given subnets. To prevent high load on the DNS server, only 5 queries may be active in parallel.
  |(category=server)
 
|}
= Traceroute =
(Starting from v4.0)
 
The Allegro Network Multimeter can perform a traceroute to IP addresses using the management interface.
Discovering the network hops to reach the target can take a considerable amount of time.
To trade between a swift and complete result, the following settings can be adjusted to meet the requirements:
* '''Ping count on each network hop''': higher values can compensate occasional packet losses and make the displayed packet loss ratio more representative, but increase the traceroute duration
* '''Maximum TTL value''': upper limit of discoverable network hops; lower values reduce traceroute duration but may cut off some network hops closer to the target IP
* '''Timeout per network hop''': duration of milliseconds to wait for a hop response before it fails as timed out; higher values may discover more network hops at the expense of an increased traceroute duration


In this example, the list would only show those element for which a
The currently displayed settings will be applied after clicking the '''Save settings''' button.
user defined name is set and its category contains the string
To show the currently used settings, the '''Reload settings''' button needs to be clicked.
"server".
The default values can be shown by clicking the '''Load default settings''' button, they are not automatically applied.

Latest revision as of 12:53, 11 September 2023

On this settings page, user defined names for IPs, MAC addresses and ports can be configured, as well as the configuration for active look-ups using DNS resolve or traceroute.

User defined names

It is possible to label IP and MAC address, as well as TCP-/UDP-ports with custom names and group them together into categories to provide easy access to specific systems. For example, all your internal machines could be labeled to match their actual name and you can categorize them into different departments.

These user defined names are persistent and are available from start on. All entries are assigned per Allegro Appliance and not per user. An assigned name is available for all users.


Configuration

The configuration of the list of user defined names is available via Settings -> Names and look-ups.

Web Interface

User defined names.png

IP names, MAC names and VLAN names

Adding or removing entries

In the tabs for IP, MAC and VLAN names, the configuration page shows on top the list of names currently set in the system. It is possible to search for a specific entry by entering the IP or MAC address or VLAN tag, category or actual name.

Individual entries may be removed from the list by clicking at the trashcan symbol in the last column.

At the bottom of the table new elements can be added by entering the IP or MAC address or VLAN tag, the category and name of the element. By clicking the plus symbol, the entry is added and will be used without further doing.

The complete IP, MAC and VLAN lists can be cleared by clicking the respective clear button below the table, a dialog will ask for confirmation.

Names may also be set directly at the IP or MAC detail page, see below for more information.


Importing IP list

IP names can be imported as an IP list from an external URL or a file in the format:

#A line with a comment

1.2.3.1

1.2.3.2

1.2.3.3

By clicking on Import IP list a dialog will be opened where you can choose to download such a list from a given URL or specify a file from your system. The IPs are added to the already existing ones.


Uploading or downloading the complete list as CSV file

Depending on the use case, the number of elements to add may be large. In this case it is also possible to upload a comma separated text file (.csv). The format is simple as follows:

ip,192.168.0.1,category,name

mac,00:00:00:00:00:00,category,name

vlan,4,category,name
...

Each line describes one entry. The columns contain the following information in this order:

  1. Entry type. Can be ip for an IP address, mac for a MAC address or vlan for a VLAN tag.
  2. Actual address or tag.
  3. Category name.
  4. Entry name.

A template file which may be opened in a spreadsheet application can be downloaded using the Download CSV template button.

The final file can be uploaded by clicking the Upload CSV list button and selecting the file from your local directory.

The current list can be downloaded by clicking the Download button. The CSV file will contain IP and MAC addresses, and VLAN tags.

L4 port names

Adding or removing entries

On top of this tab, a list of configured TCP- and UDP-port names is shown. Entries from this list can be removed by clicking the trashcan icon on the right of each entry line.

New port names can be created by clicking the Add port name button on the bottom of the list. A configuration dialog pops up and allows to select the protocol type (TCP or UDP) and configure the port number as well as the name.

Name display for user defined names

If a user defined name is configured for an IP or MAC address or VLAN tag, the name will be shown among the alternative names (which also include possible DNS, DHCP name, or other sources of information).

In the IP and MAC overview screenshots below, the IP or MAC column is highlighted to indicate such special entries for which a name is configured.

Ap-mm-ip-list-user-defined-name.png
 IP
Ap-mm-mac-list-user-defined-name.png
 MAC


In the detailed page for a single IP or MAC address, you can click on the pencil symbol to directly set a name for this specific address.

Ap-mm-ip-alternative-names.png
 IP
Ap-mm-mac-alternative-names.png
 MAC

Filtering

It is possible to enter the category or user defined name for IP and MAC filters.

Also, the name check in complex filters matches the user defined name, like in this example:

(name=systemA)


It is also possible to filter for a specific category by using the category check:

(category=server)

In this example, the list would only show those elements for which a user defined name is set and its category contains the string server.

DNS resolve

The Allegro Network Multimeter can resolve IP addresses by using the DNS server known to the management interface. A reverse lookup is being performed and the retrieved naming information is shown next to the IP address in various modules.

The DNS resolving can also be configured to run periodically after an interval passed and try to resolve IPs of certain given subnets. To prevent high load on the DNS server, only 5 queries may be active in parallel.

Traceroute

(Starting from v4.0)

The Allegro Network Multimeter can perform a traceroute to IP addresses using the management interface. Discovering the network hops to reach the target can take a considerable amount of time. To trade between a swift and complete result, the following settings can be adjusted to meet the requirements:

  • Ping count on each network hop: higher values can compensate occasional packet losses and make the displayed packet loss ratio more representative, but increase the traceroute duration
  • Maximum TTL value: upper limit of discoverable network hops; lower values reduce traceroute duration but may cut off some network hops closer to the target IP
  • Timeout per network hop: duration of milliseconds to wait for a hop response before it fails as timed out; higher values may discover more network hops at the expense of an increased traceroute duration

The currently displayed settings will be applied after clicking the Save settings button. To show the currently used settings, the Reload settings button needs to be clicked. The default values can be shown by clicking the Load default settings button, they are not automatically applied.

Retrieved from "https://allegro-packets.com/wiki/index.php?title=Names_and_look-ups&oldid=4449"