0
0
Fork 0
mirror of https://github.com/alerta/alerta-contrib.git synced 2025-03-18 06:12:51 +00:00
alerta_alerta-contrib/plugins/pubsub/README.md
Arindam Choudhury 17cfa4dcf9
updated readme
2017-11-09 09:02:03 +01:00

55 lines
1.5 KiB
Markdown

Google Cloud Pub/Sub Plugin
===========================
Send alerts to Google Cloud Pub/Sub.
For help, join [Gitter chat](https://gitter.im/alerta/chat)
Installation
------------
You need to install following python packages:
$ sudo pip install --upgrade google-cloud
$ sudo pip install --upgrade oauth2client
Follow this to configure [authentication](https://googlecloudplatform.github.io/google-cloud-python/stable/pubsub-usage.html#authentication-configuration)
Clone the GitHub repo and run:
$ python setup.py install
Or, to install remotely from GitHub run:
$ pip install git+https://github.com/alerta/alerta-contrib.git#subdirectory=plugins/pubsub
Note: If Alerta is installed in a python virtual environment then plugins
need to be installed into the same environment for Alerta to dynamically
discover them.
Configuration
-------------
Add `pubsub` to the list of enabled `PLUGINS` in `alertad.conf` server
configuration file and set plugin-specific variables either in the
server configuration file or as environment variables.
```python
PLUGINS = ['pubsub']
PROJECT_ID='google project id'
```
if you want to use google service account for pubsub. You need to set it in `alertad.conf`:
```python
SERVICE_ACCOUNT_FILE='path to service account json file'
```
References
----------
* What is Google Cloud Pub/Sub? https://cloud.google.com/pubsub/docs/overview
License
-------
Copyright (c) 2017 Arindam Choudhury. Available under the MIT License.