NINO - TechDoc

NINO Overview

NINO is a web based network management solution. It uses SNMP (Simple Network Management Protocol), WMI and HTTP/TCP service response to monitor hosts and network devices. NINO is running on a web server and NINO can be accessed by any computer with a web browser.

The main functions of NINO are:

• Device & Status view
• Monitoring
• Event management
• Reporting

NINO Services

NINO uses a web server to serve web pages. NINO uses a database to store events and the NINO services to collect monitoring data.

• Apache webserver - GUI & Reporting
• NINO services - Monitoring
• MySQL database - Storage of events and configuration
• AT scheduler - Schedule reports and network scans

All NINO processes are controlled by the services process.

Processes:

• Monitoring queues
  • Fast, cycle 60 seconds, used for fast monitoring: 1 minute Load, Ping etc.
  • Default, cycle 300 seconds, used for normal monitoring: IfOctets, 5 minute Load etc.
  • Slow, cycle 900 seconds, used for slow monitoring: IfErrors, 15 minute Load etc.
  • Internet, cycle 600 seconds, used for service response monitoring: HttpGet etc.
• event action, used for event recovery, e-mail alerts etc.
• trapd, SNMP trap listener
• status, status check for all nodes

By default NINO has several monitoring queues to handle monitoring. Each queue can be configured with a cycle duration in seconds. The services process will control all monitoring queues, such as manual stop or start, automatic restart if the queue is down or hanging. It is possible to create new monitoring queues and alter cycle times. Also test queues can be defined to test new monitoring presets or realtime troubleshooting with a cycle refresh of 10 seconds.

NINO Directory structure

The NINO directory and file structure:

NINO module structure

The NINO perl modules are located in de $httpdir/$cgidir/lib directory:

NINO is able to use the UCD / NetSNMP API or the Net::SNMP API from D. Town. The NetSNMP API is preferred, because it is faster and takes less CPU resources. However, the NetSNMP package is not always available on older systems, so the native Perl Net::SNMP API is can also be used. WMI is only available for Windows systems, so a dummy WMI module must be installed on Unix/Linux systems. If compatibility modules are required, please copy them from the $httpdir/$cgidir/libcompat directory to the $httpdir/$cgidir/lib directory and rename the file (remove -dummy, -dtown, -ucd). The NINO compatibility modules are located in de $httpdir/$cgidir/libcompat directory:

NINO monitoring presets

NINO uses monitoring presets to collect monitoring data. The monitoring preset properties are stored in the snmp.ini configuration file. The monitoring preset contains the following data:

The formula uses monitoring data as input. All OID, hosts and ports must match. This must be defined using this format:

   host:port:OID

The host and port are empty by default, but can be used to create one monitoring preset for multiple hosts. Multiple hosts setup could be in clustered environments, e.g. user serssions on multiple application servers. There are also functions available to take care of counter data.

Example preset IfOctets:

Example preset definitions (Export):

IfOctets:

oid_IfOctets = .1.3.6.1.2.1.2.2.1.10, .1.3.6.1.2.1.2.2.1.16
hosts_IfOctets = 
descr_IfOctets = &smart_ifdescr
formula_IfOctets = 8 * (counter32(::.1.3.6.1.2.1.2.2.1.10) + counter32(::.1.3.6.1.2.1.2.2.1.16)) / duration
ipport_IfOctets = 
factor_IfOctets = Bit/s
scalecalc_IfOctets = true
version_IfOctets = 1
queue_IfOctets = default
command_IfOctets = snmp
script_IfOctets = 
graph_IfOctets = line

Disks:

oid_Disks = .1.3.6.1.2.1.25.2.3.1.6,.1.3.6.1.2.1.25.2.3.1.5
in_Disks = 
out_Disks = 
hosts_Disks = 
descr_Disks = .1.3.6.1.2.1.25.2.3.1.3
formula_Disks = 100 * ::.1.3.6.1.2.1.25.2.3.1.6 / nzero( ::.1.3.6.1.2.1.25.2.3.1.5)
ipport_Disks = 161
factor_Disks = %
scalecalc_Disks = false
version_Disks = 1
queue_Disks = slow
command_Disks = snmp
script_Disks = 
graph_Disks = line

ATG Dynamo requests using 4 instances running or 2 servers, showing just one (!) graph:

oid_ATG_WEB1drpTotalReqsServed = .1.3.6.1.4.1.2725.1.4.3,.1.3.6.1.4.1.2725.1.4.3,.1.3.6.1.4.1.2725.1.4.3,.1.3.6.1.4.1.2725.1.4.3
in_ATG_WEB1drpTotalReqsServed = 
out_ATG_WEB1drpTotalReqsServed = 
hosts_ATG_WEB1drpTotalReqsServed = atg01,atg01,atg02,atg02
descr_ATG_WEB1drpTotalReqsServed = 
formula_ATG_WEB1drpTotalReqsServed = counter32(atg01:8871:.1.3.6.1.4.1.2725.1.4.3)/duration , counter32(atg01:8872:.1.3.6.1.4.1.2725.1.4.3)/duration,counter32(atg02:8871:.1.3.6.1.4.1.2725.1.4.3)/duration,counter32(atg02:8872:.1.3.6.1.4.1.2725.1.4.3)/duration
ipport_ATG_WEB1drpTotalReqsServed = 8871,8872,8871,8872
factor_ATG_WEB1drpTotalReqsServed = request/s
scalecalc_ATG_WEB1drpTotalReqsServed = true
version_ATG_WEB1drpTotalReqsServed = 2c
queue_ATG_WEB1drpTotalReqsServed = dynamo
command_ATG_WEB1drpTotalReqsServed = snmp
script_ATG_WEB1drpTotalReqsServed = 
graph_ATG_WEB1drpTotalReqsServed = sum

HTTP examples:

HttpGet:

oid_HttpGet = 
in_HttpGet = 
out_HttpGet = 
hosts_HttpGet = 
descr_HttpGet = 
formula_HttpGet = 
ipport_HttpGet = 80
factor_HttpGet = ms
scalecalc_HttpGet = false
version_HttpGet = 
queue_HttpGet = internet
command_HttpGet = http
script_HttpGet = 
graph_HttpGet = sum

Apache server-status:

oid_apacheStatus = Accesses;Bytes
in_apacheStatus = 
out_apacheStatus = 
hosts_apacheStatus = http://$ipaddr/server-status?auto
descr_apacheStatus = requests/s;kBytes/s
formula_apacheStatus = counter32(::apacheStatus) / duration
ipport_apacheStatus = 
factor_apacheStatus = 
scalecalc_apacheStatus = true
version_apacheStatus = 
queue_apacheStatus = internet
command_apacheStatus = http
script_apacheStatus = 
graph_apacheStatus = line


Execute script:
 
oid_HostProcs = 
in_HostProcs = 
out_HostProcs = 
hosts_HostProcs = 
descr_HostProcs = 
formula_HostProcs = 
ipport_HostProcs = 
factor_HostProcs = none
scalecalc_HostProcs = 
version_HostProcs = 
queue_HostProcs = slow
command_HostProcs = script
script_HostProcs = $inivar{perl} $inivar{httpcgidir}$inivar{slash}hostprocs.pl
graph_HostProcs = line