The sensu-run package

[ Tags: bsd3, program, system ] [ Propose Tags ]

sensu-run is a command line tool to send command execution results to Sensu monitoring server.

[Skip to Readme]


Versions 0.0.0, 0.1.0, 0.1.1,, 0.2.0, 0.3.0, 0.4.0,,,,
Change log
Dependencies aeson (>=0.11 && <1.3), base (>=4.9 && <4.11), bytestring (==0.10.*), filepath (>=1.4.1 && <1.5), http-client (>=0.5.6 && <0.6), http-types (>=0.9.1 && <0.13), lens (>=4.15 && <4.17), network (>=2.2.3 && <2.7), optparse-applicative (>=0.12 && <0.15), process (>=1.4 && <1.7), temporary (>=1.1 && <1.3), text (>=1.2.2 && <1.3), time (>= && <1.10), unix, unix-compat (<0.6), vector (>=0.11 && <0.13), wreq (>=0.5.0 && <0.6) [details]
License BSD3
Copyright Copyright (C) 2016-2018 Mitsutoshi Aoe
Author Mitsutoshi Aoe
Category System
Home page
Bug tracker
Uploaded Tue Jan 30 14:04:30 UTC 2018 by MitsutoshiAoe
Distributions LTSHaskell:, NixOS:, Stackage:, openSUSE:
Executables sensu-run
Downloads 1600 total (94 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Last success reported on 2018-01-30 [all 3 reports]
Hackage Matrix CI


Maintainer's Corner

For package maintainers and hackage trustees

Readme for sensu-run-

[back to package description]


Hackage Hackage-Deps Stackage LTS Stackage Nightly Build Status Build status

sensu-run runs a command and send its result to Sensu server using the client socket input or via the Sensu API. It is useful to monitor cron jobs for example.


Binary releases are available at GitHub Releases. Currently supported platforms for the binary releases are:

  • Ubuntu (64bit)
  • macOS
  • Windows (x64)

You can also build it yourself using stack:

stack install sensu-run

will install the sensu-run command in ~/.local/bin.


% sensu-run --help
Usage: sensu-run ([-n|--name NAME] [--source SOURCE] [--ttl SECONDS]
                 [--timeout SECONDS] [--handler HANDLER] ([--port PORT] |
                 [--server URL]) [--dry|--dry-run] [-s|--shell] [COMMAND] |

Available options:
  -h,--help                Show this help text
  -n,--name NAME           The name of the check
  --source SOURCE          The check source, used to create a JIT Sensu client
                           for an external resource
  --ttl SECONDS            The time to live in seconds until check results are
                           considered stale
  --timeout SECONDS        The check executaion duration timeout in seconds
  --handler HANDLER        Sensu event handler(s) to use for events created by
                           the check
  --port PORT              Send results to the local sensu-client listening on
                           the specified port (default: 3030)
  --server URL             Send results to the specified Sensu server
  -s,--shell               Execute the command using the shell

--dry-run option is useful to check the JSON output:

% sensu-run --name check-home-src-size --handler foo --dry-run -- du -s $HOME/src | jq .
  "name": "check-home-src-size",
  "command": "du -s /home/maoe/src",
  "issued": 1501041549,
  "executed": 1501041549,
  "duration": 1.674895,
  "status": 0,
  "output": "55513524\t/home/maoe/src\n",
  "handlers": [
  "user": "maoe"

Use the --shell option if you want to use shell functions:

% sensu-run --name check-home-src-size --handler foo --dry-run --shell -- "cd $HOME/src; du -s ." | jq .
  "name": "check-home-src-size",
  "command": "cd /home/maoe/src; du -s .",
  "issued": 1501041568,
  "executed": 1501041568,
  "duration": 1.224157,
  "status": 0,
  "output": "55513524\t.\n",
  "handlers": [
  "user": "maoe"

Without the --dry-run option, sensu-run sends the output to localhost:PORT, which is expected to be listened by sensu-client.

sensu-run sets the status field depending on the command exit code and timeout:

| command exit code | status field | |-------------------|----------------| | 0 | 0 (OK) | | non-zero | 2 (CRITICAL) | | command timed out | 3 (UNKNOWN) |

Sensu API

sensu-run supports posting check results via Sensu API as well. Use --server option to specify Sensu server addresses. If multiple servers are specified, sensu-run tries them one by one until it succeeds.

sensu-run --name check-true --handler foo --server --server --dry-run -- du -s $HOME/src