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.

For information about interacting with the grid and form, see Standard Configuration Interface in Unified Assurance Concepts. The Devices interface has additional controls, described in Grid Details.

This user interface calls REST methods from the api/device/devices endpoints. See REST API for Unified Assurance Core for details..

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: Select a device and click this button to immediately start the SNMP discovery process for the device.

• Unmanage: Select a device and click this button to set the device state to Disabled.

• Remote -> SSH: Select a device and click this button to start a SSH session to the device from the presentation server.

• Device Overview: Select a device and click this button to open the Device Overview dashboard.

Form Fields

• State: The state of the device. This can show if a device is fully or partially discovered, if it is virtual, and so on.

  • 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, you must select a parent device.

• 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.

• 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.

• 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: The 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 metrics will be stored on.

• Discovery Information: If the device has been SNMP discovered, this information will be visible. You can use the Discover button to initiate discovery on this device. The SNMP Profile field is editable 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 metadata that have been added to the device.

Best Practice

You must specify at least one of the following when creating a device:

• DNS Name

• IP Address (IPv4)

• IP Address (IPv6)