Sensu-Plugins-StackStorm

Functionality

Files

st2_handler.rb

Installation

You can easily install this pack using sensu-install as following.

$ sudo sensu-install -p stackstorm

Usage

st2_handler.rb

usage: st2_handler.rb [-h] [--verbose] [--unauthed] [--ssl-verify]

StackStorm sensu event handler.

optional arguments:
  -h, --help        show this help message and exit
  --verbose, -v     Verbose mode.
  --unauthed, -u    Allow to post to unauthed st2. E.g. when auth is disabled
                    server side.
  --ssl-verify, -k  Turn on SSL verification for st2 APIs.

Configuration

This is the configuration parameters that st2_handler refers.

parameter	description	default value
st2_username	Username that is authenticated by the StackStorm	`st2admin`
st2_password	Password that corresponds to the Username to be authenticated	`password`
st2_api_key	API Key value to authenticate API access (see also: api-keys)
st2_api_base_url	The base URL to access to the st2api	`http://localhost:9101/v1/`
st2_auth_base_url	The base URL to access to the st2auth	`http://localhost:9100/`

You can set these configurations in a Sensu configuration source file (e.g. /etc/sensu/conf.d/st2_handler.json) as following.

{
  "st2_handler": {
    "st2_username": "testu",
    "st2_password": "testp",
    "st2_api_key": "",
    "st2_api_base_url": "http://localhost:9101/v1/",
    "st2_auth_base_url": "http://localhost:9100/"
  }
}

(see also: sensu-configuration-source)

Confirmation

After installing this plugin by sensu-install command, you can manually dispatch StackStorm trigger sensu.event_handler of Sensu pack with the message of Sensu Events for confirmation the normality. If the setup goes well, you can get following result.

$ echo '{"client": {"name": 1}, "check":{"name": 2}, "id": "12345"}' | /opt/sensu/embedded/bin/st2_handler.rb
Sent sensu event to st2. HTTP_CODE:                 202

sensu-plugins / sensu-plugins-stackstorm

readme