A nagios-notification-google-calendar documentation
nagios-notification-google-calendar is a Nagios-plugin that send Nagios notifications via google calendar SMS reminder
Contents
Attention
Google disable SMS notifications for calendar events after June 27, 2015. Therefore after this date this plugin useless.
Installation
- Obtain your copy of source code from git repository:
git clone https://github.com/vint21h/nagios-notification-google-calendar.git
. Or download latest release from https://github.com/vint21h/nagios-notification-google-calendar/tags. - Run
python ./setup.py install
from repository source tree or unpacked archive under root user. Or use pip:pip install nagios-notification-google-calendar
.
Configuration
- Read and understand Nagios documentation.
- Create Nagios commands definitions like this:
# "host-notify-by-sms" command define command{ command_name notify-host-by-sms command_line /usr/bin/notification_google_calendar.py -u $CONTACTNAME$ -m "Host '$HOSTALIAS$' is $HOSTSTATE$ - Info: $HOSTOUTPUT$" -C $CONTACTADDRESS1$ -t $CONTACTADDRESS2$ } # "service-notify-by-sms" command define command{ command_name notify-by-sms command_line /usr/bin/notification_google_calendar.py -u $CONTACTNAME$ -m "$NOTIFICATIONTYPE$ $HOSTNAME$ $SERVICEDESC$ $SERVICESTATE$ $SERVICEOUTPUT$ $LONGDATETIME$" -C $CONTACTADDRESS1$ -t $CONTACTADDRESS2$ }
- Go to https://code.google.com/apis/console/ and create new project.
- Enable calendar API for project.
- Create an OAuth 2.0 client ID for project with
Installed application
type and download JSON client secrets file. - Copy
/usr/share/doc/nagios-notification-google-calendar/notification_google_calendar.ini
to/etc/nagios
with your settings. Attention: nagios user must havenotification_google_calendar.ini
read permissions, and credentials directory read/write permissions. -
- Modify contacts definitions:
-
- Add
addressX
option to contact definition with contact google calendar ID. - Add
addressX
option to contact definition with contact preferred timezone (in human readable format from TZ database). This is dirty hack, but i don't know how do this better way. - Get and save credentials by run
notification_google_calendar.py -g -u USERNAME
whereUSERNAME
- nagios contact name. - Add commands to the lists of service and host notifications commands for contact.
- Configure google calendar for mobile devices.
- Add
Licensing
nagios-notification-google-calendar is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. For complete license text see COPYING file.
Contacts
Project Website: https://github.com/vint21h/nagios-notification-google-calendar
Author: Alexei Andrushievich <vint21h@vint21h.pp.ua>
For other authors list see AUTHORS file.