Devices
Devices is a standard configuration interface for displaying all the devices that Unified Assurance has discovered through the various pollers and discovery agents. From this list, administrators can manually add and edit devices as well as modify device settings such as custom name, IP address, and device state. This list can also be easily exported for inventory or accounting purposes.
Refer to the Standard Configuration Interface guide for details on interacting with the grid and form, and there are additional controls that are explained in the Grid Details section below.
This user interface calls REST methods from api/device/devices.
The UI path for this interface is Configuration -> Device Catalog -> Devices.
Grid Details
This interface contains the following additional options in the Button Bar:
-
Discover - After an existing device has been selected, clicking this button will immediately start the SNMP discovery process for the device.
-
Unmanage - After an existing device has been selected, clicking this button to set the device state to "Disabled".
-
Remote -> SSH - After an existing device has been selected, clicking this button will start a SSH session to the device from the presentation server.
-
Device Overview - After an existing device has been selected, clicking this button will open the "Device Overview" dashboard.
Form Fields
-
State - The state of the device. This can show if a device is fully/partially discovered, if it is virtual, etc.
-
Disabled - A Device that will no longer be discovered or polled.
-
Discovered - Device has SNMP access. Set after SNMP Discovery.
-
New - Device has not been auto or SNMP discovered.
-
Non-discoverable - A Device that can not be discovered.
-
Verified - Device can be pinged, set after initial auto discovery.
-
Virtual - Virtual devices cannot be discovered. They are for display of devices that do not actually exist or you cannot connect to. They must have a Parent Device.
-
-
Parent Device - When State is set to "Virtual", a parent device must be selected.
-
DNS Name - The DNS Name for the device.
-
Custom Name - A possible alternate name for the device. If added, this will be displayed instead of the DNS Name or an IP Address.
-
IP Address (IPv4) - The v4 IP address of the device. If the field is blank when clicked on, the presentation server will attempt to lookup the IPv4 address based on the DNS Name field available above.
-
IP Address (IPv6) - The v6 IP address of the device. If the field is blank when clicked on, the presentation server will attempt to lookup the IPv6 address based on the DNS Name field available above.
-
Priority - Can be used to multiply the event severity by this value, and then put into the "Score" field. When configured via an event filter, a higher score will place events generated by this device higher on the event list.
-
Zone - Device Zone the device belongs to. Used to split up polling and devices by location as needed.
-
Static Category - The category of the device. If this field is set to anything other than [Discovered], the value chosen will be considered a static override and will always be displayed. If it is set to [Discovered], the information used by SNMP discovery will be used to determine the category.
-
Discovered Category - The discovered category of the device by SNMP discovery.
-
GeoLocation - The geographic coordinates of the device which can be used in Topology Graph views, Vision, and other places.
Note:
The coordinates must be in the order longitude, then latitude, for example:
{"type":"Point","coordinates":[LONGITUDE,LATITUDE]} -
Shard - The shard the device events and metrics will be stored on.
-
Discovery Information - If the device has been SNMP discovered, this information will be visible. The Discover button can be used to initiate discovery on this device. SNMP Profile can be changed, but all other fields are read-only.
- SNMP Profile - The SNMP Access Profile that will be used when connecting to the device.
-
Meta Tags - Any meta tags and meta data that have been added to the device.
Best Practices
- You must enter at least one of DNS Name, IPv4 or IPv6 when creating a device