nagiosAck

Project Notes

Usage: nagiosAck |<-?> [OPTION]... COMMAND -a, --add Add acknowledgement -r, --remove Remove acknowledgement(s) -i, --info Get acknowledgement details -?, --help Display this help text -V, --version Display version info OPTIONS Searching: --older-than Older than @tag --since-last-remove Since last remove time --use-ack-comment Use attributes from acknowledgement comment --no-end-time Acks with no end time --type Regex of definition type --host Regex of host --service Regex of service --author Regex of author --comment Regex of comment --commentid Regex of comment id Other: --test Do nothing except display actions that would be performed --email-report Send an email report --logfile Log to file -v, --verbose Verbose output -d, --debug Debug output IMPORTANT Ensure that "retention.dat" is up to date before running this program (ie. reload Nagios). TAGS The following tags can be specified in an acknowledgement comment or with the --older-than option (don't forget to persist the comment): @period:[nd] [nh] [nm] [ns] @until:yyyy-mm-dd hh:mm[:ss] EXAMPLES Removing: Remove all acknowledgements (use with caution, or add --test): # nagiosAck.pl -r Remove any acknowledgement older than 8 days 7 hours 6 minutes and 5 seconds (ie. 716765 seconds): # nagiosAck.pl -r --older-than="@period:8d 7h 6m 5s" Remove any acknowledgement older than Thu Jan 12 21:15 2016: # nagiosAck.pl -r --older-than="@until:2016-01-21 21:15" Remove acknowledgements based on the @tag in its acknowledgement comment: # nagiosAck.pl -r --use-ack-comment Remove useless acknowledgements from all 'nagios.org' subdomains older than 31 days: # nagiosAck.pl -r --host=".*.nagios.org" --comment="test" --older-than="31d" Adding: Add a host acknowledgement: # nagiosAck.pl -a --host="old.nagios.com" --author="admin" --comment="@until:2016-01-015 09:00" Add multiple service acknowledgements for multiple hosts: # nagiosAck.pl -a --host="exchange.nagios.com,assets.nagios.com" --service="ping,ssh" --author="admin" --comment="@period:15m" Searching: Find all host acknowledgements from host 'webserver': # nagiosAck.pl -i --type="host" --host="webserver" Find all service acknowledgements with 'test' in the comment: # nagiosAck.pl -i --type="service" --comment="test" Find all acknowledgements created by user1: # nagiosAck.pl -i --author="user1" Reporting: Remove host acknowledgements matching "test*123" and send a report to a list of email recipients: # nagiosAck.pl -r --host="test.*d+" --email-report="root@localhost,[email protected]" Logging: Log remove-all actions to a file: # nagiosAck.pl -r --logfile="/tmp/acks.log" For more information and advanced options, see the source code. Also refer to the "External Commands" section of the Nagios server documentation.