Observium scanner #11
Description
Problem
I want to use cabestan to gather my assets list from Observium
Rest API
doc : https://docs.observium.org/api/
- list all devices :
GET {base_url}/api/v0/devices/ - list all info on a device :
GET {base_url}/api/v0/devices/1/
result :
{
"status": "ok",
"count": 2,
"devices": {
"277": {
"device_id": "277",
"hostname": "router-1.company.com",
"sysObjectID": ".1.3.6.1.4.1.9.1.620",
"sysDescr": "Cisco IOS Software, 1841 Software (C1841-IPBASE-M), Version 15.0(1)M4, RELEASE SOFTWARE (fc1)\r\nTechnical Support: http://www.cisco.com/techsupport\r\nCopyright
(c) 1986-2010 by Cisco Systems, Inc.\r\nCompiled Thu 28-Oct-10 15:40 by prod_rel_team",
"version": "15.0(1)M4",
"hardware": "CISCO1841",
"features": "IPBASE",
"os": "ios",
...
<most device data removed for brevity>
},
"278": {
"device_id": "278",
"hostname": "router-b.company.com", }
"sysObjectID": ".1.3.6.1.4.1.9.1.620",
"sysDescr": "Cisco IOS Software, 1841 Software (C1841-IPBASE-M), Version 15.0(1)M4, RELEASE SOFTWARE (fc1)\r\nTechnical Support: http://www.cisco.com/techsupport\r\nCopyright
(c) 1986-2010 by Cisco Systems, Inc.\r\nCompiled Thu 28-Oct-10 15:40 by prod_rel_team",
"version": "15.0(1)M4",
"hardware": "CISCO1841",
"features": "IPBASE",
"os": "ios",
...
<most device data removed for brevity>
}
}
}Auto-discovery
doc : https://docs.observium.org/autodiscovery/
Observium provide an auto-discovery method which uses :
- "SNMP to gather information about a device. This information allows Observium to discover all the internal sensors and interfaces of this device."
- "Observium finds all the neighbors of this device by using protocols such as CDP, LLDP, FDP, or EDP, and gathering neighbor information from routing protocols such as OSPF."
Auto-discovery needs modifications in the configuration files of the Observium instance.
Observium Auto-discovery shouldn't be configured from cabestan :
- We can document the process for user using the Observium scanner
- We can be inspired by the existing auto-discovery feature for or own SNMP scanner SNMP network scanner #7