We have a video series on adding devices. If you have missed any information in the videos, keep scrolling down.

For more information on adding a device using SNMP v3, go to the solution article under our FAQs.

What is a device?

A device is a piece of hardware from which we can collect data. The device will have a hostname and an IP address and we can collect data using:




 Devices are made up of different components.


Here are some examples:
Some traffic shaping policies
Various environmental monitors
Power supplies


Each of these components has a unique identifier. For example, an interface might be called fe0/1, a policy map might be called gold or silver, a CPU might reside on a line card or on the router chassis itself. These unique names make up the elements of the device.


Managing Devices

Managing devices includes adding or removing devices that are monitored by Iris. You are also able to change the IP address, the poller or polling routines for a particular device.

When adding devices, you can do this manually or you can auto-discover devices on your network. Autodiscover is discussed under Discover Devices.

Adding a new device

This is how to manually add a device.


Click on Configuration on the navigation bar at the top of the screen.


Select Devices and Manage Devices from the drop-downs.

On the Devices page, click to add a new device.

Hostname: This is the name of the device that exactly matches the hostname as is configured on the device. No spaces or unusual characters allowed as per RFC1123 which is the standard for internet hostnames.
Alias: An alias is a friendlier user-defined name that is used to describe the device in reports instead of the hostname or base tag.
Class: The class is just a designation that is given to a router so that we can make some decisions about topology. Select the closest match from the list.
Type: Choose the device type from the drop-down of the device to be polled. To monitor an IP address, use IP Host as the Device Type.
Vendor: Select the vendor from the drop-down list.
IP Address: Enter the IP address of this device.
Use hostname: To use the hostname instead of the IP address, select Use hostname.
Monitoring profile: A Monitoring Profile is used to tell Iris how to poll a device. Choose the profile from the drop-down list. A new profile can be added under Devices>Manage Monitoring Profiles or clicking on the plus sign next to this field (depending on the version of Iris that you have installed).
Multi-tenant: A device is multi-tenant if its elements can be assigned to different views. In the case of PE device, this is usually what you want. CE devices are usually only assigned to the customer’s view, so you’d not want it to be multi-tenanted. Similarly, servers and core devices are typically also only assigned to a single view.
Connection port:
DCE Connection Port:
Shared Poller: 
Netflow port:
Pollers: Choose a poller to poll the device. Your primary poller should be closest to the device in terms of network topology. A secondary poller can also be used to poll this device for redundancy.
SNMP version: If the device supports SNMP, you can use SNMP string.
SNMP Community: The SNMP community will need to match the SNMP string used on the router config. You have the option of using a Read Only <RO> or a read/write string <RW>.
Active Monitoring: Select the relevant option from the drop-down menu. Click on help for more information on Active Monitoring.
Config backup: You have the option of backing up the config of the device if it supports it. IF the device doesn’t support it, then several fields will not be visible here.
Login User and Password: Type in the username and password.
Auth secret: Type in the auth secret.
Views: It is usually best practice to put the device into a view.
Notes: Sometimes it is useful to have notes for any additional info you would like to include for this device.

Click Check to confirm that everything is correct. If everything checks out, click Save.

Edit a device

From the Devices page, select the device that you would like to edit. Either click on the edit icon at the top of the screen or in the actions column in the row of the applicable device.

If you would like to change the Hostname, click Change and the Change Hostname pop-up will be displayed.

Type in the hostname that you would like to use for the device or edit the existing hostname.

Note: The device will remain in change pending state for several hours to avoid data loss for the duration of the change. During this time, you may see graphs for both the old and new hostname.

Click Change and Save.


Manage Monitoring Profiles

A Monitoring Profile is used to tell Iris how to poll a device.

Select Devices and Manage Monitoring Profiles from the drop-downs.

To add a new monitoring profile, click the + at the top of the screen.

Name and Description: Give the Monitoring Profile a name and a description so that you can easily search for it.

Polling: Select the relevant Poll Routine and then click on the arrow so that it will be enabled for this profile. You can select as many polling routines as required. A list of available polling routines is available on our support portal. You can also click the link in this pop-up.

You can monitor the device primary IP and the “other side” of the connected interfaces via both ICMP and SNMP. Select what is relevant for you.

To add a TCP Port, click Add another TCP port. Add the Port, the send and close string and then select the severity from the drop-down.

To enable a config backup (Rancid) or WMI for the device, complete this tab.

You will need to have a username and password and the secret/auth string for the device.

For WMI, Iris will require a Domain Admin (or local for non-AD environments) user account with either Admin Rights or WMI permissions.

Edit a monitoring profile

You can edit an existing monitoring profile.

Select the profile that you would like to edit from the Monitoring Profiles page. Click on the edit icon at the top of the screen or in the actions column and edit the fields as you would for setting up a new monitoring profile.

Create a monitoring profile from a copy

You can create a new monitoring profile from a copy. This would be useful when you would like most of the settings to stay the same, but you might need to change one or two things.

On the Monitoring Profiles page, select the profile that you would like to copy. Click on the copy icon in the actions column.

The Create new Monitoring Profile from copy pop-up will be displayed. Change the name of the monitoring profile. Edit the fields and tabs as required and click Save.

Discover Devices

It is possible to discover some devices in Iris automatically from the front end.

Select Devices and Discover Devices from the drop-downs.

On the Discover Devices page type in the CIDR range and the SNMP community string. Select the poller from the drop-down list and then click Discover.

For the next article, click on the track that you are following:

TRACK 2: User

TRACK 3: Administrator

To return to the contents page, click on the track that you are following:

TRACK 2: User

TRACK 3: Administrator