Nagios Probes for Argus (EMI-2 & EMI-3)

Installation

Prerequisites

• Python 2.4 or newer (not Python 3000)
• EMI-2 or EMI-3 repository installed
• Host certificate & IGTF-bundle
• Nagios server

Where to install

• This set of probes needs to be installed on the Nagios server only. On the client side (where the Argus services actually run), no action is required.

Install instructions

There is available a rpm called "nagios-plugins-argus", nagios-plugins-argus - v. 1.0.0 (EMI 2) & nagios-plugins-argus - v. 1.1.0 (EMI 3). It can be installed as follows:

yum install nagios-plugins-argus

This installs the plugins into the /usr/libexec/grid-monitoring/probes/ directory. It is up to the user to bind them into the local Nagios environment.

NOTE: If you use iptables you need to open the ports on client side (where the Argus services are installed):

for IPv4 do:

iptables -I INPUT 1 -p tcp --dport 8154 -j ACCEPT
iptables -I INPUT 1 -p tcp --dport 8152 -j ACCEPT
iptables -I INPUT 1 -p tcp --dport 8150 -j ACCEPT
/etc/init.d/iptables save
/etc/init.d/iptables restart

for IPv6 do:

ip6tables -I INPUT 1 -p tcp --dport 8154 -j ACCEPT
ip6tables -I INPUT 1 -p tcp --dport 8152 -j ACCEPT
ip6tables -I INPUT 1 -p tcp --dport 8150 -j ACCEPT
/etc/init.d/ip6tables save
/etc/init.d/ip6tables restart

Overview of probes

There are 9 different probes available, three for each service:

Service	Probe-Name
PAP	nagios-plugins-argus.PAP.memory
	nagios-plugins-argus.PAP.policies
	nagios-plugins-argus.PAP.status
PDP	nagios-plugins-argus.PDP.memory
	nagios-plugins-argus.PDP.status
	nagios-plugins-argus.PDP.traffic
PEPD	nagios-plugins-argus.PEP.memory
	nagios-plugins-argus.PEP.status
	nagios-plugins-argus.PEP.traffic

PAP probes

nagios-plugins-argus.PAP.status

checks if the service is available. This is done by a call to https://`hostname`:8150/pap/status, if there is a valid response the service is considered up and running.

Options

Mandatory	CLI shortcut	Description	Default
YES	--hostname=HOSTNAME	The hostname of the service
	--cert=CERT	The SSL client certificate	/etc/grid-security/hostcert.pem
	--key=KEY	The private key (the key must be unencrypted)	/etc/grid-security/hostkey.pem
	--capath=CAPATH	The directory where trust anchors are stored on the system	/etc/grid-security/certificates
	--help	show this help message and exit
	--port=PORT	The port of the service	8150
	--url=URL	The status endpoint URL of the service. Example: https://hostname:port/pap/status
	--version	show program's version number and exit
	--timeout=TIMEOUT	The TCP timeout for the HTTPS connection in seconds	20
	--verbose	verbose mode	False

nagios-plugins-argus.PAP.memory

the response of the call executed by the status probe is parsed. The value for the current memory consumption is read out and displayed in the Status information field of the Nagios control panel and written into the Performance Data tab of Nagios. Hence it can be displayed as a graph over time by Nagios add-ons, e.g. pnp.

Options

Mandatory	CLI shortcut	Description	Default
YES	--hostname=HOSTNAME	The hostname of the service
	--warning=MEM_WARN	Memory usage warning threshold in MB	224.0
	--critical=MEM_CRIT	Memory usage critical threshold in MB	256.0
	--cert=CERT	The SSL client certificate	/etc/grid-security/hostcert.pem
	--key=KEY	The private key (the key must be unencrypted)	/etc/grid-security/hostkey.pem
	--capath=CAPATH	The directory where trust anchors are stored on the system	/etc/grid-security/certificates
	--help	show this help message and exit
	--port=PORT	The port of the service	8150
	--url=URL	The status endpoint URL of the service. Example: https://hostname:port/pap/status
	--version	show program's version number and exit
	--timeout=TIMEOUT	The TCP timeout for the HTTPS connection in seconds	20
	--verbose	verbose mode	False

nagios-plugins-argus.PAP.policies

the response of the call executed by the status probe is parsed. The value for the current number of policies in the monitored PAP is read out and displayed in the Status information field of the Nagios control panel and written into the Performance Data tab of Nagios. Hence it can be displayed as a graph over time by Nagios add-ons, e.g. pnp.

Options

Mandatory	CLI shortcut	Description	Default
YES	--hostname=HOSTNAME	The hostname of the service
	--cert=CERT	The SSL client certificate	/etc/grid-security/hostcert.pem
	--key=KEY	The private key (the key must be unencrypted)	/etc/grid-security/hostkey.pem
	--capath=CAPATH	The directory where trust anchors are stored on the system	/etc/grid-security/certificates
	--help	show this help message and exit
	--port=PORT	The port of the service	8150
	--url=URL	The status endpoint URL of the service. Example: https://hostname:port/pap/status
	--version	show program's version number and exit
	--timeout=TIMEOUT	The TCP timeout for the HTTPS connection in seconds	20
	--verbose	verbose mode	False

PDP probes

nagios-plugins-argus.PDP.status

checks if the service is available. This is done by a call to https://`hostname`:8152/status, if there is a valid response the service is considered up and running.

Options

Mandatory	CLI shortcut	Description	Default
YES	--hostname=HOSTNAME	The hostname of the service
	--cert=CERT	The SSL client certificate	/etc/grid-security/hostcert.pem
	--key=KEY	The private key (the key must be unencrypted)	/etc/grid-security/hostkey.pem
	--capath=CAPATH	The directory where trust anchors are stored on the system	/etc/grid-security/certificates
	--help	show this help message and exit
	--port=PORT	The port of the service	8152
	--url=URL	The status endpoint URL of the service. Example: https://hostname:port/status
	--version	show program's version number and exit
	--timeout=TIMEOUT	The TCP timeout for the HTTPS connection in seconds	20
	--verbose	verbose mode	False

nagios-plugins-argus.PDP.memory

the response of the call executed by the status probe is parsed. The value for the current memory consumption is read out and displayed in the Status information field of the Nagios control panel and written into the Performance Data tab of Nagios. Hence it can be displayed as a graph over time by Nagios add-ons, e.g. pnp.

Options

Mandatory	CLI shortcut	Description	Default
YES	--hostname=HOSTNAME	The hostname of the service
	--warning=MEM_WARN	Memory usage warning threshold in MB	224.0
	--critical=MEM_CRIT	Memory usage critical threshold in MB	256.0
	--cert=CERT	The SSL client certificate	/etc/grid-security/hostcert.pem
	--key=KEY	The private key (the key must be unencrypted)	/etc/grid-security/hostkey.pem
	--capath=CAPATH	The directory where trust anchors are stored on the system	/etc/grid-security/certificates
	--help	show this help message and exit
	--port=PORT	The port of the service	8152
	--url=URL	The status endpoint URL of the service. Example: https://hostname:port/status
	--version	show program's version number and exit
	--timeout=TIMEOUT	The TCP timeout for the HTTPS connection in seconds	20
	--verbose	verbose mode	False

nagios-plugins-argus.PDP.traffic

the response of the call executed by the status probe is parsed. The value for the current number of requests executed and the number how many of them have been successful is read out and compared to the same numbers of the former test executed. Out of this the requests per second, the completed requests per second and the erroneous requests per second are computed and written into the Performance Data tab of Nagios. Hence it can be displayed as a graph over time by Nagios add-ons, e.g. pnp. Additionally the number of requests since the last test is written into the Status information field of the Nagios control panel.

Options

Mandatory	CLI shortcut	Description	Default
YES	--hostname=HOSTNAME	The hostname of the service
	--cert=CERT	The SSL client certificate	/etc/grid-security/hostcert.pem
	--key=KEY	The private key (the key must be unencrypted)	/etc/grid-security/hostkey.pem
	--capath=CAPATH	The directory where trust anchors are stored on the system	/etc/grid-security/certificates
	--tempdir=TEMP_DIR	Storage path for the needed temporary file	../../../../var/lib/grid-monitoring/nagios-plugins-argus
	--tempfile=TEMP_FILE	Name for the needed temporary file	hostname.nagios-plugins-argus.PDP.traffic.pickle
	--help	show this help message and exit
	--port=PORT	The port of the service	8152
	--url=URL	The status endpoint URL of the service. Example: https://hostname:port/status
	--version	show program's version number and exit
	--timeout=TIMEOUT	The TCP timeout for the HTTPS connection in seconds	20
	--verbose	verbose mode	False

PEP Server probes

nagios-plugins-argus.PEP.status

checks if the service is available. This is done by a call to https://`hostname`:8154/status, if there is a valid response the service is considered up and running.

Options

Mandatory	CLI shortcut	Description	Default
YES	--hostname=HOSTNAME	The hostname of the service
	--cert=CERT	The SSL client certificate	/etc/grid-security/hostcert.pem
	--key=KEY	The private key (the key must be unencrypted)	/etc/grid-security/hostkey.pem
	--capath=CAPATH	The directory where trust anchors are stored on the system	/etc/grid-security/certificates
	--help	show this help message and exit
	--port=PORT	The port of the service	8154
	--url=URL	The status endpoint URL of the service. Example: https://hostname:port/status
	--version	show program's version number and exit
	--timeout=TIMEOUT	The TCP timeout for the HTTPS connection in seconds	20
	--verbose	verbose mode	False

nagios-plugins-argus.PEP.memory

the response of the call executed by the status probe is parsed. The value for the current memory consumption is read out and displayed in the Status information field of the Nagios control panel and written into the Performance Data tab of Nagios. Hence it can be displayed as a graph over time by Nagios add-ons, e.g. pnp.

Options

Mandatory	CLI shortcut	Description	Default
YES	--hostname=HOSTNAME	The hostname of the service
	--warning=MEM_WARN	Memory usage warning threshold in MB	224.0
	--critical=MEM_CRIT	Memory usage critical threshold in MB	256.0
	--cert=CERT	The SSL client certificate	/etc/grid-security/hostcert.pem
	--key=KEY	The private key (the key must be unencrypted)	/etc/grid-security/hostkey.pem
	--capath=CAPATH	The directory where trust anchors are stored on the system	/etc/grid-security/certificates
	--help	show this help message and exit
	--port=PORT	The port of the service	8154
	--url=URL	The status endpoint URL of the service. Example: https://hostname:port/status
	--version	show program's version number and exit
	--timeout=TIMEOUT	The TCP timeout for the HTTPS connection in seconds	20
	--verbose	verbose mode	False

nagios-plugins-argus.PEP.traffic

the response of the call executed by the status probe is parsed. The value for the current number of requests executed and the number how many of them have been successful is read out and compared to the same numbers of the former test executed. Out of this the requests per second, the completed requests per second and the erroneous requests per second are computed and written into the Performance Data tab of Nagios. Hence it can be displayed as a graph over time by Nagios add-ons, e.g. pnp. Additionally the number of requests since the last test is written into the Status information field of the Nagios control panel.

Options

Mandatory	CLI shortcut	Description	Default
YES	--hostname=HOSTNAME	The hostname of the service
	--cert=CERT	The SSL client certificate	/etc/grid-security/hostcert.pem
	--key=KEY	The private key (the key must be unencrypted)	/etc/grid-security/hostkey.pem
	--capath=CAPATH	The directory where trust anchors are stored on the system	/etc/grid-security/certificates
	--tempdir=TEMP_DIR	Storage path for the needed temporary file	../../../../var/lib/grid-monitoring/nagios-plugins-argus
	--tempfile=TEMP_FILE	Name for the needed temporary file	hostname.nagios-plugins-argus.PDP.traffic.pickle
	--help	show this help message and exit
	--port=PORT	The port of the service	8154
	--url=URL	The status endpoint URL of the service. Example: https://hostname:port/status
	--version	show program's version number and exit
	--timeout=TIMEOUT	The TCP timeout for the HTTPS connection in seconds	20
	--verbose	verbose mode	False