Skip to content
Shims for Log Insight 3.3+ and vRealize Operations Manager 6.0+
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
loginsightwebhookdemo moogsoft, fix #70 (#71) Apr 6, 2018
samples Fixed vR Ops in vRO shim, added example and readme Nov 15, 2016
tests Add shim for Microsoft Teams (#69) Apr 5, 2018
venv-webhookshims Moogsoft Shim (#43) Oct 3, 2017
.gitignore Moogsoft Shim (#43) Oct 3, 2017
.travis.yml Added tests, fixed bugs, other enhancements Dec 8, 2016
CONTRIBUTING.md Update docs, reintroduce pivotaltracker tests (#57) Feb 26, 2018
LICENSE
README.rst Update README.rst (#72) Apr 12, 2018
requirements.txt
runserver.py * Refactored parse to make it easier to add incoming webhook formats Sep 27, 2016
setup.py Remove circular dependency on importing package in setup.py Oct 31, 2017
test-requirements.txt Added dependency to kafka to test-requirements Aug 3, 2017
tox.ini Updated to v2 of OpsGenie API Feb 27, 2018

README.rst

Build Status https://coveralls.io/repos/github/vmw-loginsight/webhook-shims/badge.svg?branch=master

Translation Shims for Log Insight and/or vRealize Operations Manager Webhooks

Translate webhooks from Log Insight 3.3+ and vRealize Operations Manager 6.0+ (recommended 6.2+) to other services. Get alerts in your team chatroom, open an incident ticket or kick off a remediation workflow.

Log Insight and vRealize Operations Manager send alert notifications as HTTP POST with a JSON body. However, most third-party solutions expect incoming webhooks to be in a proprietary format. If the receiving system lacks native support for the webhook format, a shim between them can translate the webhook format as needed. This repository provides several example shims design to work with Python 2.7+.

Installation

Three installation methods exist. Please select the one you are most comfortable with.

Docker

docker run -it -p 5001:5001 vmware/webhook-shims

Photon OS 1.0

tdnf install wget -y
wget https://bootstrap.pypa.io/get-pip.py
python get-pip.py
pip install virtualenv
tdnf install git -y
virtualenv loginsightwebhookdemo
cd loginsightwebhookdemo
source bin/activate
git clone https://github.com/vmw-loginsight/webhook-shims.git
cd webhook-shims/
pip install -r requirements.txt

Photon OS 2.0

tdnf install wget python2 python2-xml -y
wget https://bootstrap.pypa.io/get-pip.py
python get-pip.py
pip install virtualenv
tdnf install git -y
virtualenv loginsightwebhookdemo
cd loginsightwebhookdemo
source bin/activate
git clone https://github.com/vmw-loginsight/webhook-shims.git
cd webhook-shims/
pip install -r requirements.txt
iptables -A INPUT -p tcp --dport 5001 -j ACCEPT

Manual

virtualenv loginsightwebhookdemo
cd loginsightwebhookdemo
source bin/activate
git clone https://github.com/vmw-loginsight/webhook-shims.git
cd webhook-shims/
pip install -r requirements.txt

Modify and run the shim:

  • Some services require credentials or URLs. Edit individual services under loginsightwebhookdemo/ to modify constants as needed. (Note: For basic auth, ~/.netrc will take prescendence.)
  • Run python runserver.py [port] - the Flask webserver starts and reports listening - default http://0.0.0.0:5001/
  • Open your browser pointed to the Flask webserver for a list of available URLs.

Documentation

Documentation for this shim can be found under the Installation section above. Once the shim is running, documentation for all endpoint can be found at the root path. With the shim running, you need to configure sources to point to the shim. Configuration information for Log Insight and vRealize Operations Manager are listed below.

Log Insight webhook configuration

There are two places in LI where webhooks can be configured:

  1. System notification: under the General page in the Administration section
  2. User alerts: while creating a new user alert or by editing an existing user alert

vRealize Operations Manager webhook configuration

REST plugin: under Administration > Outbound Settings

Developing and Contributing

We’d love to get contributions from you! Once you are up and running, take a look at the Contribution Document to see how to get your changes merged in.

Licensing

Provided under Apache License 2.0. For more information, see the LICENSE file.

Support

Please report problems via GitHub issues.

You can’t perform that action at this time.