The Assimilation Project based on Assimilation version 0.5.1427809010
The current thinking is that over time we will expend a good bit of energy discovering things so that we can present them to the client for them to choose whether they want to monitor the things we've discovered.
Simple/auto/self-configuration needs to be a hallmark of this project. This and scalability are its raison-d'etre.
The preferred method of discovery is to have the client be discover machines being communicated with via our local agents (probes), then get these agents installed on the newly discovered machines.
Once installed, these agents monitor the server and discover services and so on as described below. The admins would in turn be prompted to monitor the discovered services (or at least services of types we know about).
Of course, some of the discovered systems will not be able to run our agents (network switches, appliances, etc), so we need the ability to do network-discovery of services on these machines through port scanning, and similar techniques.
And lastly we will still need the ability to just add a service manually.
In the client code, we implement a Discovery class hierarchy to discover local discovery. As of this writing, the only thing we discover is Link-Level switch configuration stuff via LLDP or CDP (using the SwitchDiscovery class). But we will eventually discover things like ARP cache partner IP and MAC addresses, local services running, network ports in use, and so on. Some like the SwitchDiscovery class tell us when things have changed. Others will need to be polled for. The Discovery class base class has provisions for both kinds of discovery mechanisms.
Most discovery information will be represented as JSON objects. That is, the run-of-the-mill discovery agents (plugins, whathaveyou) will produce their discovery data in JSON in a particular format according to the type of information being discovered. The only exception to this rule planned at the current time is to transmit CDP and LLDP packets in binary - to avoid putting full decoding CDP and LLDP decoding information into the nanoprobes. Below is sample JSON data for documenting discovered network configuration.
There are at least two ways in which other systems can be discovered without sending out any packets. These are:
For UNIX systems, there is a set of directories and files which describe all the services which are installed (for example, /etc/init.d). In addition the netstat commands can also produce details on which services are being provided on listening ports (netstat -utnlp).