Nagios Core External Commands

< Back to external commands list

SEND_CUSTOM_HOST_NOTIFICATION

Command Format:
SEND_CUSTOM_HOST_NOTIFICATION;<host_name>;<options>;<author>;<comment>
Description:

Allows you to send a custom host notification. Very useful in dire situations, emergencies or to communicate with all admins that are responsible for a particular host. When the host notification is sent out, the $NOTIFICATIONTYPE$ macro will be set to "CUSTOM". The <options> field is a logical OR of the following integer values that affect aspects of the notification that are sent out: 0 = No option (default), 1 = Broadcast (send notification to all normal and all escalated contacts for the host), 2 = Forced (notification is sent out regardless of current time, whether or not notifications are enabled, etc.), 4 = Increment current notification # for the host (this is not done by default for custom notifications). The comment field can be used with the $NOTIFICATIONCOMMENT$ macro in notification commands.

Shell Script Usage Example:
#!/bin/sh
# This is a sample shell script showing how you can submit the SEND_CUSTOM_HOST_NOTIFICATION command
# to Nagios. Adjust variables to fit your environment as necessary.

now=`date +%s`
commandfile='/usr/local/nagios/var/rw/nagios.cmd'

/bin/printf "[%lu] SEND_CUSTOM_HOST_NOTIFICATION;router;3;Ethan;I'm trapped in the NOC - help!  BTW, is it normal for smoke to be coming from the router?!?\n" $now > $commandfile    
Command Categories:

Hosts
Notifications

Nagios Version(s):

3.x, 4.x

Nagios, Nagios Core, NRPE, NSCA, and the Nagios logo are trademarks, servicemarks, registered servicemarks or registered trademarks of Nagios Enterprises. All other trademarks, servicemarks, registered trademarks, and registered servicemarks mentioned herein may be the property of their respective owner(s). The information contained herein is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE WARRANTY OF DESIGN, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE.