lita-nagios
lita-nagios is a handler for Lita that allows interaction with Nagios monitoring solution. It listens for notifications on a HTTP endpoint and uses nagiosharder to send commands to the Nagios instance.
Note: Colors in notifications are not enabled yet, because it relies completely on the adapter and no abstraction layer is implemented nor designed as of now.
Installation
Add lita-nagios to your Lita instance's Gemfile:
gem "lita-nagios"
Configuration
HTTP interface
default_room
(String) - Default chat room for notifications
nagiosharder
config)
Nagios commands (cgi
- Nagios CGI URLuser
- Nagios user with system commands authorizationpass
- User passwordversion
- Nagios version, default: 3time_format
- default: "iso8601"verify_ssl
- default:true
Example
Lita.configure do |config|
config.handlers.nagios.default_room = "#admin_room"
config.handlers.nagios.cgi = "http://nagios.example.com/cgi-bin/nagios3"
config.handlers.nagios.user = "lita"
config.handlers.nagios.pass = "xxxx"
config.handlers.nagios.version = 3
config.handlers.nagios.time_format = "iso8601"
config.handlers.nagios.verify_ssl = true
end
Usage
Display notifications in channel
lita-nagios provides a HTTP endpoint to receive Nagios notifications:
POST /nagios/notifications
Request parameters must include those fields:
-
type
-host
orservice
-
room
- notifications destination (seedefault_room
in configuration section) -
host
- Nagios'$HOSTNAME$ or$HOSTALIAS$ -
output
- Nagios'$HOSTOUTPUT$ or$SERVICEOUTPUT$ -
state
- Nagios'$HOSTSTATE$ or$SERVICESTATE$ -
notificationtype
- Nagios'$NOTIFICATIONTYPE$ -
description
- Nagios'$SERVICEDESC$ (only forservice
type)
An example Nagios configuration (contact, commands) to send alerts to channels is provided in contrib folder
Send commands to Nagios
lita: nagios enable notif(ication(s)) <-h | --host HOST> [-s | --service SERVICE] - Enable notifications for given host/service
lita: nagios disable notif(ication(s)) <-h | --host HOST> [-s | --service SERVICE] - Disable notifications for given host/service
lita: nagios recheck <-h | --host HOST> [-s | --service SERVICE] - Reschedule check for given host/service
lita: nagios ack(nowledge) <-h | --host HOST> [-s | --service SERVICE] [-m | --message MESSAGE] - Acknowledge host/service problem with optional message
lita: nagios (fixed|flexible) downtime <-d | --duration DURATION > <-h | --host HOST> [-s | --service SERVICE] - Schedule downtime for a host/service with duration units in (m, h, d, default to seconds)