Metadata-Version: 2.0
Name: nagios-notification-google-calendar
Version: 0.3.1
Summary: Notifications via Google Calendar Nagios plugin
Home-page: https://github.com/vint21h/nagios-notification-google-calendar
Author: Alexei Andrushievich
Author-email: vint21h@vint21h.pp.ua
License: GPLv3 or later
Download-URL: https://github.com/vint21h/nagios-notification-google-calendar/archive0.3.1.tar.gz
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Environment :: Plugins
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: Utilities
Requires-Dist: google-api-python-client (==1.0)
Requires-Dist: httplib2 (==0.7.7)
Requires-Dist: oauth2client (==1.0)

.. nagios-notification-google-calendar
.. README.rst

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 have ``notification_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`` where ``USERNAME`` - nagios contact name.
    * Add commands to the lists of service and host notifications commands for contact.
    * Configure google calendar for mobile devices.

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.


