Select Supported Platforms

Select Supported Architectures

Select Tier

Github Name

Asset Definition
Release Notes
Release Assets


Proof of concept generic http handler

This handler should be considered experimental and entirely unsupported.

If you are interested in extending or fixing this, you are encourage to fork this repo.


sensu-http-handler --help
Proof of concept generic http handler

  sensu-http-handler [flags]
  sensu-http-handler [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  help        Help about any command
  version     Print the version number of this plugin

      --header stringToString   Add additional HTTP header in format key=value (ex: 'X-Sensu-Header=test value') can be used multiple times (default [])
  -h, --help                    help for sensu-http-handler
      --insecure-skip-verify    Skip TLS verifications for https urls
  -m, --method string           The http(s) method: POST and PATCH supported (default "POST")
  -u, --url string              The http(s) url
  -d, --data                    The data to pass, will be treated as a template
  -v, --verbose                 Verbose logging

Important Arguments


Required. This is the full path to the http(s) endpoint you need to POST/PATCH


The HTTP method, currently supported POST and PATCH. Defaults to POST


This allows you to add headers using a key=value pattern. You can use this multiple times, each time calling a different key to set multiple headers.


The POST or PATCH body. Treated as a Sensu template and processed with the event object.

Environment Variables

Argument Environment Variable

What it's suppose to do.

Ideally this handler should allow you to post json representation of Sensu events to a random http endpoint (like a webhook).

The json passed in is treated as a Sensu template and processed with the event object.

Why not just use curl in a shell script as a handler command?

Good question. This is exactly what I would normally do.
But there are situations where using Sensu assets are preferred and curl is difficult to package as an asset because of its library dependencies. And a call to curl is not able to be treated as a Sensu template.

So here we are, This golang executable should be relatively easy to package as a Sensu asset, and should expose just enough http configuration to allow you to send data to a simple webhook url expecting json data.

It will not be as featureful as a curl script, though. So if you need advanced http features like proxy support or private cert, this proof-of-concept handler problably isn't going to get there out of the box.

Are you sure you want to report this asset?

Please describe the reason for reporting this asset. Our moderators will be notified and will disable the asset if it is found to be inappropriate.


You must be signed in to report this asset.

Sign In with Github



Either download the source code:

Download Source

Or download the asset definition: