Sensu wrapper-sensu-summit

Sensu Wrapper
Lee Briggs
Senior Infrastructure Engineer
15/08/2017

© 2016 Apptio, All rights reserved (v2.5)2
$(whoami)
 Based in Seattle (formerly London)
 (One of) Maintainers of sensu-puppet
 Work for Apptio
 We are hiring! (remote US, remote EMEA, remote APAC)
 Using Sensu since 2012
 Over 5500 sensu clients in dev & prod
 Github:
https://github.com/jaxxstorm
 Twitter:
https://twitter.com/briggsl
 Blog:
https://www.leebriggs.co.uk

Piping data to Sensu
 Sensu client accepts data using UDP, TCP and even HTTP Socket
 The sensu client page has some examples in bash:
 echo '{"name": "app_01", "output": "could not connect to
mysql", "status": 1}' > /dev/tcp/localhost/3030
 echo '{"name": "app_01", "output": "could not connect to
mysql", "status": 1}' | nc localhost 3030
 However, adding this to your scripts and reworking commands is
cumbersome
https://sensuapp.org/docs/1.0/reference/clients.html#what-is-the-sensu-client-socket

Origins
 Originally, there was sensu-shell-helper
 https://github.com/solarkennedy/sensu-shell-helper
 Written in bash
 Manipulating JSON in bash isn’t fun
 So I wrote sensu-wrapper
 Originally in ruby
 Wasn’t fun to install or maintain
 So I rewrote it again in Go
 Single binary
 Easy to install
 Great JSON marshalling/demarshalling support
 Excellent stdlib

What does it do?
 Encapsulates any command, runs it and returns the stdout/stderr and the
exit code
 If the command fails, it returns a Nagios compliant exit code for Sensu
 It will then create some JSON which is piped to the sensu-client socket,
creating a Sensu event

Getting Started
 Install it easily using curl
 curl http://github.com/jaxxstorm/sensu-
wrapper/releases/download/v0.3.2/sensu-wrapper_linux_amd64.tar.gz -o
sensu-wrapper_linux_amd64.tar.gz
 Untar it
 Get started!

Options

Options
 Dry run: see what JSON sensu-wrapper would produce
 sensu-wrapper -d -n "test_check" ls
 {"name":"test_check","command":"ls
.","status":0,"output":"DockerfilenREADME.mdnapincommandndis
tnoutputnsensu-wrapper.gon"}
 Add source, handlers and command execution timeout
 sensu-wrapper -d -n "test_check" -H "default" -s
"my_macbook" -T 10 ls
 {"name":"test_check","command":"ls
.","status":0,"output":"DockerfilenREADME.mdnapincommandndis
tnoutputnsensu-
wrapper.gon","source":"my_macbook","handlers":["default"]}

More Options
 If you’re monitoring a cron job, you want an alert if you haven’t heard
from the job in a while
 Add a TTL to sensu-wrapper:
 sensu-wrapper -d -n "test_check" -H "default" -s "my_macbook" -T
10 --ttl 100 ls .
 You can also add arbitrary JSON from a file or when creating the check
 Many custom handlers need arbitrary JSON included
 sensu-wrapper -d -n "test_check" -H "default" -s "my_macbook" -T
10 --ttl 100 -j '{"some_value": "testing"}' ls .

API
 You can also send results directly to the sensu API
 Perfect for stuff that doesn’t have a sensu-client (yet)
 Because it’s written in Go, it’ll run on any Linux based OS
 Other uses:
 F5 big-ips
 Kubernetes
 init containers
 Kubernetes cron jobs
 Cisco switches
 Netapps

Puppet
 Puppet Module to download and install sensu-wrapper:
 https://github.com/jaxxstorm/puppet-sensu_wrapper
 If you use Puppet, you can get sensu-wrapper for free by using my cron
puppet module:
 https://github.com/jaxxstorm/puppet-cron

We still need
 I’m not a good developer
 The code is bad
 If you can help with:
 Better quality code
 Tests
 General bugfixes
 New features
 They will all be gratefully received!

Sensu wrapper-sensu-summit

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to Sensu wrapper-sensu-summit

Similar to Sensu wrapper-sensu-summit (20)

Recently uploaded

Recently uploaded (20)

Sensu wrapper-sensu-summit