nagios-for-i

Warning

This package is currently no longer supported or maintained. The repository has been archived to reflect this status and may be unarchived if it becomes actively maintained in the future

If you are looking for actively supported Nagios integration, you are invited to explore products in the IBM i ecosystem, for instance:

• AAG from Shield Advanced
• Control for i from m81

Description

Nagios provides enterprise-class Open Source IT monitoring, network monitoring, server and applications monitoring.
We provide several customized plugin for monitoring IBM i systems.
You could refer to the this link for more details.

The nagios plugin for i has two methods.

• You can run the plugin with a daemon server to handle and dispatch the request to worker thread.
  You could start the daemon server by script server_start.sh.
• You can also run the plugin without the server. Then every request will be handled by separate processes. It would be more simple but consumes more resources.

The plugins support to monitor following matrix

  plugin            matrix

  CPU               Retrieve the CPU utilization for the entire system

  SpecificJobCPU    Retrieve the CPU usage for a specific job

  DiskUsage         Retrieve the disk usage status

  DiskConfig*       Retrieve the disk health status

  ASPUsage          Retrieve the ASP usage percentage of the entire system

  ActiveJobs        Retrieve the number of active jobs on the system

  BasicInfo         Retrieve the basic information of an IBM i system

  CurSignOnUsers    Retrieve the number of users that currently log on to the system

  LongRunSQL        Retrieve the longest running SQL

  Message           Retrieve the messages from a specific message queue

  SpecificMessage   Retrieve the status whether a specific message ID is found in a specific message queue

  PageFaults        Retrieve the page faults

  SubsystemJobs     Retrieve job information in a specific subsystem

  CustomSQL         The user could leverage SQL services to create self-defined matrix

  TempStorageJobs   Retrieve top N jobs that have the most temp storage usage

  DaemonServer      Retrieve the daemon server status

* DiskConfig is no longer supported in 7.5 and beyond.

## Installation and upgrade

Nagios Core

For the version of Nagios Core, you could install the latest plugins by service pack in directory service pack.
You could take Nagios Plugin for IBM i Install and Configure Guidelines.txt for detail steps.

Nagios XI

The wizards for monitoring IBM i should be installed in the base shipment for Nagios XI (As of Jan 2021 this is not the case). To update or install the plugins you should do the following.

• Download the Wizards and store locally
  
  • ibmiservice.zip
    
  • ibmicustomsql.zip
    
• Open the web interface.
  
  • Select the Admin page
    
  • Select Manage Config Wizards (left hand column of links)
    
  • Select Browse to select the zip file
  • Select the Upload and Install button to install the Wizard

The wizards should now be available to monitoring the IBM i.

Information from Nagios about installing wizards which has a lot more information can be found here.