Select Supported Platforms

Select Supported Architectures

Select Tier

Github Name

v0.1.0 · public · Published 6 months ago

Asset Definition
Release Notes
Release Assets


Table of Contents


The Sensu OpenTSDB Handler is a Sensu Event Handler that sends metrics to
an OpenTSDB server via its telnet API.

Sensu can collect metrics using check output metric extraction or the
statsd listener. Those collected metrics pass through an event pipeline,
allowing Sensu to deliver normalized metrics to the configured metric event

This OpenTSDB handler enables extracting, tagging and storing that metric data
into an OpenTSDB database.

Usage Examples


an opentsdb handler built for use with sensu

  sensu-opentsdb-handler [flags]
  sensu-opentsdb-handler [command]

Available Commands:
  help        Help about any command
  version     Print the version number of this plugin

  -h, --help                       help for sensu-opentsdb-handler
      --host string                OpenTSDB host to send metrics to
      --port string                OpenTSDB port to send metrics to (default "4242")
      --prefix string              Prefix metrics name with this string
      --prefix-entity-name         Prefix metrics name with the entity name
      --retries uint               Number of times to try to connect to the server (default 3)
      --retry-delay uint           Delay in seconds between connection attempts (default 1)
      --space-replacement string   String to replace spaces with if the entity name or tags contain any (default "-")
      --tag-host                   Add a host tag holding the entity name to metrics (default true)
      --tags stringToString        Add these tags to metrics (default [])


Asset registration

Assets are the easiest way to make use of this handler. If you're using
sensuctl 5.13 with sensu-backend 5.13 or later, you can use the following
command to add this handler as an asset:

sensuctl asset add sensu/sensu-opentsdb-handler

If you're using an earlier version of Sensu, you can find the asset on the
Bonsai Asset Index.

Resource definition

type: Handler
api_version: core/v2
  name: send-metrics-to-opentsdb
  namespace: default
  command: sensu-opentsdb-handler --host localhost --prefix sensu --tags type=system,source=sensu
  - sensu-opentsdb-handler
  type: pipe

Installation from source

The preferred way of installing and deploying this handler is to use it as an asset. If you would
like to compile and install the plugin from source or contribute to it, download the latest version
or create an executable script from this source.

From the local path of the sensu-opentsdb-handler repository:

go build


For more information about contributing to this plugin, see Contributing.

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: