Observium was designed to auto-discover as much as possible. The auto-discovery process begins by using SNMP to gather information about a device. This information allows Observium to discover all the internal sensors and interfaces of this device. Next, Observium finds all the neighbors of this device by using protocols such as
EDP, and gathering neighbor information from routing protocols such as
When Observium sees a neighboring device that it doesn't yet know about, it'll try to contact that device using the pre-set SNMP communities in the configuration file. If Observium can successfully connect with the new device, the auto-discovery process will now run on this device. Observium will continue discovering until the entire network has been mapped.
All of these items are required for auto-discovery to work correctly:
- SNMP must be enabled on your devices and be reachable by Observium
- SNMP settings on your devices must match what you have configured in
- Access control lists (ACL) on the device must permit the IP of Observium
- Devices must return valid, resolvable
sysNames. If the
sysNamereported by a device is not resolvable, the device won't be added. There are several ways to correct this:
Best method: Add DNS records that match the hostnames and domains that you have configured in your devices. Here is an example if you are using the BIND name server:
device1 IN A 192.168.186.1 device2 IN A 192.168.186.2
Alternative: Add lines to the
/etc/hosts file on Observium that match the hostnames and domains that you have configured in your devices. For example:
# IPaddress Hostname 192.168.186.1 device1.domain.com 192.168.186.2 device2.domain.com
Observium will try to add any devices it sees via
LLDP to its database if the identifier of the device doesn't match any sysName in the database.
Observium will try to add any devices it sees as neighbours in
OSPF to its database if the IP address of the neighbour isn't present in the database.
OSPF device auto-discovery is currently disabled as default, and needs to be manually enabled in the config file.