Skip to content

Devices

Devices is a standard configuration interface for displaying all the devices that Assure1 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".

  • SSH - After an existing device has been selected, clicking this button will start a SSH session to the device from the presentation server.

Form Fields

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

  • 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

Meta

Default Devices

  • Any server running the Assure1 Broker will be in the Device list.