Welcome to docs.opsview.com

This is an old revision of the document!


Opsview's Auto-discovery feature will find hosts on your network allow you to edit information and assign host templates to them quickly and easily. It can then import the hosts into Opsview, ready for monitoring.

Note: Times displayed in the Auto-discovery application are based on the browser's time zone, not the server time zone that other screens use. This makes it easier for users to understand the scan times and the scheduled scan times based on their local timezone. In future, Opsview will use the browser time zone for all times.

Scan Management

This page lists all the scans.

This grid view will automatically refresh every 10 seconds.

Note: Only one scan can be running at a time.

You can configure two types of scan:

  • Network Scan - looks for all hosts on an IP address range
  • VMware Scan - looks for all running guests on a VMware host. See our VMware detection page


A scan will transition between the following states:

State Description
Configured The scan has been configured with appropriate information
Pending The scan is queued, ready to be run
Running The scan is running. Only one scan can be running at a time
Completed The scan has finished. You can now enter the sandbox view


You can take the following actions via the buttons on the right hand side, or via a right click contextual menu in the grid:

Action Description
Start This starts the scan
Stop This stops, or cancels a scan if it is already running
Show Log This open a window with the log of the current scan with information about hosts discovered
Open Results This shows the results of the scan in a new tab. Also known as the sandbox view
Edit Allows you to edit an existing scan
Clone Allows you to clone a scan. It is not possible to rerun a scan, so you will need to clone an existing one
Delete Deletes the scan and its results

Only certain actions will be possible to select based on the scan's current state.

In addition, you can take certain actions in the toolbar:

Action Description
New Scan This creates a new scan configuration
Cancel All Scans This cancels all pending or running scans

Scan Configuration

You can enter in the configuration options for the scan.

The Save button will be disabled until all necessary information is entered.

Fields marked with an asterix are required.

Job Title

This is arbitrary text for the job name.

Run On

This defines which Opsview server the auto-discovery will run on, so you can do detection from distributed slaves.

If you have a slave cluster, auto-discovery will run from the 1st node in the cluster.

Network Address

For a Network Scan, enter the network address range to scan. You can enter a comma or line separated list.

Network ranges can be in the following format:

  • A.B.C.D - W.X.Y.Z
  • A.B.C.D/24

There is a hard limit of 100,000 hosts that you can enter in one scan configuration.

When you have saved, there will be an estimated time for the completion of the scan. This is based on 75% of the worst case scenario - you will get different results based on the devices on the network.

VMware Hosts

For a VMware scan, you can select which VMware hosts to query for VMware guest systems.

More information at the VMware detection page.

Default Host Icon

This is the initial host icon used for detected hosts. You can edit this value in the sandbox.

This is set to SYMBOL - Server for new scans.

Default Host Group

This is the initial host group used for detected hosts. You can edit this value in the sandbox.

Default Template

This will be added to the templates for detected hosts. More templates will be added based on technologies detected.

This is set to Network - Base for new scans.

Primary Address Based on

In the sandbox view, if the primary address is based on IP, then the IP will be used. Otherwise, it will be the DNS name.

Strip Base Domains for Host Titles

If DNS name is used, then the following list of base domains will be removed from any DNS name found.

Detect Network Settings

If Detect network services is selected, then the following services will be automatically detected:

Service TCP Port
FTP 21
SSH 22
DNS 53
Kerberos 88
POP3 110
NNTP 119
NTP 123
IMAP 143
LDAP 389
RDP 3389

Host Agent Detection

You can select if you want auto-discovery to detect for Opsview agents or NRPE agents.

SNMP Detection

You can select if you want auto-discovery to detect for SNMP. You have to enter the credentials you want to use.

Note: if you select SNMP v2, there will be a fallback to SNMP v1 with the same credentials.

WMI Detection

You can select if you want WMI (agentless Windows) detection.

VMware Host Detection

You can select if you want auto-discovery to detect for a VMware host system. This option is not available for a VMware Scan.

Scanning Logic

The scan will attempt to contact each IP by using check_icmp. Up to 10 hosts will be checked at once.

If a host responds to the ICMP check, then detection of services and agents will be attempted.

Note: A host must respond to ICMP/ping otherwise the IP is considered to be not available.

Scan Log

This shows the current debug output from a scan. It will update automatically and scroll to the bottom.


This shows the settings for Auto-discovery.

You can use the exclusion list to exclude specific IPs from being scanned. Click Add to add more IP addresses. Valid syntax:


You can also associate a comment with your entry.

You can enter more than one entry in the Add window and each one will be given its own row.

If you double click on a row, you can edit the IP address or the comment.

You can use the search button to find entries. This will do a case insensitive string comparison of all rows.

Nothing is saved until the form is submitted. Duplicated entries will be automatically stripped out when saving.

The exclusion list will take effect for any future scans. Historical scans are not changed.

Excluded IP addresses will be logged at the time of scanning.

Scheduled Scans

If you have selected Start Date and Repeat based on a weekday or a month date, then Opsview will calculate when the next run of the auto discovery will be using the chosen days or month date after the Start Date.

Note: Date and times are based on the browser time zone.


The sandbox is where all the discovered hosts are placed for you to check and edit before importing into Opsview.

Grid View

The grid is the main view for all the discovered hosts.

If you select the tick all box in the header, it will select all rows.

Note: If there has been a row already imported into Opsview, the tick all box will not be ticked.

The first column is a selection column if you want to import a large number of hosts in one go, or if you want to bulk edit all hosts. Note: If there is 1 or more hosts already imported into Opsview, the selection will not include these hosts and the tick box in the grid header will not be activated.

The 2nd column shows if an import has already happened for a sandbox host. If a host matches either in its name or its IP address, then it is marked as maybe already imported into Opsview for manual resolution.

In the sandbox view, you can edit certain cells. As changes are being made, Opsview will automatically save to the database. You can double click on a cell within the following columns:

  • Primary Address
  • Host Title
  • Host Details
  • Parents
  • Icon
  • Assigned Templates

You can show or hide columns in the grid by clicking on a column header's contextual menu:

Primary Address

This is the address used by Opsview when monitoring this host.

Host Title

This field denotes the name of the host in the monitoring system.

Host Details

This is a free text description for the host.


This denotes the parents of this host, from a network reachability point of view from the Opsview monitoring server.


This is the host icon for the host.

Assigned Templates

These are the host templates that this host has assigned to it.


This lists the agents detected on the host. This can be:

  • Opsview - runs Opsview agent version >= 4.2
  • Nagios - runs an NRPE agent or Opsview agent < 4.2
  • SNMP - runs SNMP
  • VMware - is a VMware host. This text can be clicked to bring up a window to enter the VMware username and password. If the host has been imported, then clicking will bring up the New VMware Scan window
  • WMI - runs WMI agent

Network Services

Lists the ports detected on this host.


You can take actions by selecting the hosts with the checkbox on the left and then choosing the button in the toolbar.

You can also get actions from a contextual menu, for each row in the grid, by right clicking.

Import into Opsview

When ready, select the hosts you want to import and click the Import into Opsview button. This will validate that all the necessary information is included and proceed to import into Opsview.

When a host has been imported into Opsview, it is not possible to re-import or edit any fields in the sandbox for that host.

Bulk Edit

Use this button if you want to change parameters for multiple sandbox hosts at once. A window will appear with configuration options.

Single Edit

Use this button if you want to change parameters for a single sandbox host. A window will appear with configuration options.

If the sandbox host has VMware detected, a VMware username and password field will need to be completed. When the save button is pressed, Opsview will check that the username and password are correct before saving to the database.

Add to Exclusion List

This option is only available from the contextual menu.

This is a handy shortcut to add this specific IP address to the list of Excluded IPs in the Settings. The comment will be set to the host title and the host detail, if any.

Access Permissions

The Autodiscovery application is limited to users with CONFIGUREHOSTS access.

All users can see all scans and all results.

If the user has a restriction on their host groups, then only those host groups will be listed for selection, and only the hosts that the user is restricted to will be listed for selection as parents.

If the user has a restriction on their monitoring servers, then only those monitoring servers will be listed for selection. If this user attempts to edit an existing scan for a different monitoring server, then they can only save from their restricted list of monitoring servers.

To import hosts into Opsview, the user requires CONFIGURESAVE, otherwise the Import button will be disabled.


Jobs Remaining in a Running State

If the SSH tunnels to slaves are broken during the scan, then the scan will go back into a Configured state. However, it is possible that the job remains in a Running state. If the job is definitely not running, then restarting Opsview will cause the scan job to return to a configured state: /etc/init.d/opsview restart.

Changes to Opsview During a Scan

If you change the current Opsview configuration during a scan, then the population of the sandbox grid may fail. You may need to rerun the scan job.

If you add or remove monitoring servers, host groups or host templates while the Auto-discovery application is running in the browser, you will need to reload the Auto-discovery application to get the latest information as there is a local copy of some parts of the Opsview configuration.

If a monitoring server has been removed during the scan, then imported hosts will default to the Master monitoring server.

If a host group has been removed during the scan, then the sandbox grid will insist on setting a host group before you are allowed to import the host into Opsview.

Internet Explorer 9 Browser Displaying Wrong Images

It is possible that IE9 shows some wrong images, such as the yellow button highlight which has changed in Opsview 4.3. It seems that IE9 caches images too aggressively. To clear its cache, go to Tools ⇒ Internet Options ⇒ General Tab ⇒ Browsing History ⇒ Delete, then tick just Temporary Internet Files and then Delete.

Scan Hanging

If a scan appears to be hanging, it might be because the system has reached the maximum number of open file descriptors allowed. One way to mitigate the chance of this happening is to lower concurrent_ad_jobs, a new Opsview configuration variable added in 4.6.1 (see opsview.conf). The fewer jobs running, the lower the chance of the system running out of file descriptors.

However, a better approach might be to increase the allowed number of file descriptors. This is done outside of Opsview, at the system level. Enter the following in /etc/security/limits.d/90-opsview.conf:

nagios hard nofile 64000
nagios soft nofile 64000

Be sure to completely log out the nagios user, log back in, and restart Opsview for this change to take effect.