XWall · The Mail Filter
Nagios (IT Infrastructure Monitoring)

XWall has an interface to query the status of the queue that can be used to signal the status to Nagios.

How it works

A Perl script opens a connection on port 25 to XWall and sends a special ESMTP command.

XWall will then return the current state of the queue ( e.g. OK, WARNING or CRITICAL) and the amount of messages in the queue.

Nagios gets the output of the script and based on the rules, it triggers an action.

A sample connection looks like:

Connection opened by yourmrtg.domain.com [10.0.0.1]
> 220 yoursrv.domain.com ESMTP XWall
< HELO yournagios.domain.com
> 250 yoursrv.domain.com
< XBNAGIOS
> 250 WARNING - (S-O: 17; S-I: 0; E-O: 0; E-I: 0)
< QUIT.0.0.1]

XWall configuration

By default XWall does not allow access to the data.

NAGIOS=True
NAGIOSAllowIP=10.0.0.1

Note: Substitute 10.0.0.1 with the IP address of your Nagios machine.

The default values for warnign and critical are:

SMTP Queue:

SMTP Queue:
NAGIOSLimitWarnInboundSMTP=15
NAGIOSLimitWarnOutboundSMTP=15
NAGIOSLimitCritInboundSMTP=30
NAGIOSLimitCritOutboundSMTP=30

Exchange Queue:

NAGIOSLimitWarnInboundExch=15
NAGIOSLimitWarnOutboundExch=15
NAGIOSLimitCritInboundExch=30
NAGIOSLimitCritOutboundExch=30

Connections:

NAGIOSLimitWarnInboundCon=10
NAGIOSLimitWarnOutboundCon=10
NAGIOSLimitCritInboundCon=20
NAGIOSLimitCritOutboundCon=20

Installation:

Download nagios.zip

Extract check_xwall.pl and copy it to /usr/local/nagios/libexec

Make the script executable using

cmod 755 /usr/local/nagios/libexec/check_xwall.pl
cmod 755 /usr/local/nagios/
libexec/check_xwall.pl

Add the command definition from sample-nagios.cfg to your nagios cfg file

Bind a Nagios service and/or host to the command

On the XWall server, add the commands from sample-xwall.ini to XWall. ini to permit Nagios to query the XWall server

Run the script manually to see if there is any problem using a command line like

/usr/local/nagios/libexec/check_xwall.pl -H yourxwall.yourdomain.com --debug
/usr/local/nagios/
libexec/check_xwall.pl
-H yourxwall.yourdomain.com
--debug

Note: The sample assumes that the Nagios plug-in are installed in /usr/local/nagios/libexec If they are in a different direcory, then you need to change the direcory in the samples and also in check_xwall.pl

Download the sample files and the Perl script

© 1996-2017 DataEnter GmbH
Wagramerstrasse 93/5/10 A-1220 Vienna, Austria
support@dataenter.co.at
2017-01-04 / Phone
2017-01-04 / Tablet
Changed: 2017-01-04
Server
Desktop
Copyright © 1996-2017 DataEnter GmbH
Wagramerstrasse 93/5/10 A-1220 Vienna, Austria
Fax: +43 (1) 2020770
support@dataenter.co.at