Graphite

ENTERPRISE: Built-in integrations are available for Sensu Enterprise users only.

Overview

Send metrics to Graphite, using the plaintext protocol over TCP. The graphite enterprise handler is also capable of sending metrics to Hosted Graphite, using the prefix attribute to prefix metric names with the Hosted Graphite API key. This handler uses the output_format mutator.

Configuration

Example(s)

The following is an example global configuration for the graphite enterprise handler (integration).

{
  "graphite": {
    "host": "graphite.example.com",
    "port": 2003,
    "prefix_source": false,
    "prefix": "production"
  }
}

Integration Specification

graphite attributes

The following attributes are configured within the {"graphite": {} } configuration scope.

PRO TIP: You can override graphite attributes on a per-contact basis using contact routing.

host
description The Graphite Carbon host address.
required false
type String
default 127.0.0.1
example
"host": "carbon.hostedgraphite.com"
port
description The Graphite Carbon port.
required false
type Integer
default 2003
example
"port": 3003
prefix_source
description If the Sensu source (client name) should prefix (added to) the metric names.
required false
type Boolean
default false
example
"prefix_source": true
prefix
description A custom metric name prefix - this can be used to prefix the Hosted Graphite API key.
required false
type String
example
"prefix": "production"
retry_limit
description The number of times the integration will attempt to re-send metrics after encountering an error.
required false
type Integer
default 3
example
 "retry_limit": "3"
retry_delay
description How long the integration will wait between retries, in seconds.
required false
type Integer
default 1
example
 "retry_delay": "1"