{section}
{column}

h1. Introduction

The probes available in the Petals internals and components are able to send JMX notifications when they detect a defect. These notifications can be sent to Nagios with a dedicated monitoring command of Petals CLI that receive JMX notifications and write them in the channel of Nagios passive checks.

{gliffy:name=Nagios passive checks|size=L|align=center|version=2}

The daemon *{{petals-cli-nagios}}* listen JMX notifications coming from Petals ESB nodes using a dedicated Petals CLI command. When it receives a JMX notification, it formats and prints an external command for Nagios. The host and service emitting the JMX notification are transformed into Nagios host and Nagios service through a mapping file.

{column}
{column:width=350px}
{panel:title=Table of contents}{toc:outline=true}{panel}
{panel:title=Contributors}{contributors:order=name|mode=list|showAnonymous=true|showCount=true|showLastTime=true}{panel}
{column}
{section}

h1. Installation

These integration of Petals ESB, Petals CLI and Nagios is available on Debian-based system and is packaged as a Debian package: {{petals-cli-cmd-monitoring-so-nagios}}.
{tip}To run on other operating system, we need your contribution to port the daemon script wrapping Petals CLI on this operating system.{tip}
See [Installing Petals CLI using the Debian packages] to get more information on this Debian package.

h1. Configuration

Once your Nagios installation is configured to accept external commands, you must verify in {{/etc/petals-cli/petals-cli-nagios}} that the expected Nagios pipe file is set according to your Nagios installation. The default value is the one associated to the Debian package of Nagios.

To add a new defect subscription to sent to Nagios:
# create a new file in the directory {{/etc/petals-cli/nagios-subscriptions-available}} from the template {{/etc/petals-cli/nagios-subscriptions-available/nagios-subscription-template}}:
{code}
# JMX connection information to the Petals ESB container
#
host=localhost
port=7700
username=petals
password=petals

# The subscription object and its arguments
#
subscription-object=petals-bc-soap
extra-args=-n petals-bc-soap -t file:///etc/petals-cli/nagios-mapping-rules.properties
{code}

> sudo /usr/bin/petals-cli-nagios <your-defect-subscription-file>
{code}

h2. Components

h3. Petals BC SOAP

The defects of the BC SOAP are supported by the subscription object '*petals-bc-soap*'.

The defect emitter identifier is based on the template: *{{<component-id>@<hostname>}}*, where <component-id> is the JBI identifier of the BC SOAP sending the defect from the Petals ESB container running on <hostname>.

The following defects can be notified:
|| Defect || Identifier ||
| HTTP thread pool exhausted | *{{org.ow2.petals.bc.soap.httpserver.threadpool.exhausted}}* |
| Web-service client pool exhausted | *{{org.ow2.petals.bc.soap.serviceclientspool.exhausted}}* |