InfluxDB

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

Overview

Send metrics to InfluxDB using the InfluxDB HTTP API.

When handling events with check type of metric this integration will attempt to translate measurements from the specified output_format to InfluxDB measurements.

When handling events without check type of metric specified, this integration will record annotations to a measurement named sensu_events. These annotations are time series data which describe the status of a given check at a specific point in time, using the following attributes from the event:

annotation columns
time influxdb timestamp
check name of the check
status check status
client client name
action action of the event
description output from the check
occurrences event occurrence count

Annotation data can be used to overlay the status of Sensu checks on a graph of other metrics recorded in InfluxDB.

Configuration

Example(s)

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

{
  "influxdb": {
    "host": "8.8.8.8",
    "port": 8086,
    "username": "root",
    "password": "Bfw3Bdrn5WfqvOl1",
    "api_version": "0.9",
    "tags": {
      "dc": "us-central-1"
    }
  }
}

Integration specification

influxdb attributes

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

host
description The InfluxDB host address.
required false
type String
default 127.0.0.1
example
"host": "8.8.8.8"
port
description The InfluxDB HTTP API port.
required false
type Integer
default 8086
example
"port": 9096
username
description The InfluxDB username.
required false
type String
default root
example
"username": "sensu"
password
description The InfluxDB user password.
required false
type String
default root
example
"password": "secret"
database
description The InfluxDB database (name) to use.
required false
type String
default db
example
"database": "sensu"
api_version
description The InfluxDB API version.
required false
type String
allowed values 0.8, 0.9
default 0.8
example
"api_version": "0.9"
tags
description Configurable custom tags (key/value pairs) to add to every InfluxDB measurement. PRO TIP: Augment the tags applied to each measurement by specifying additional InfluxDB tags in check and client definitions. See the Sensu Core reference docs to configure InfluxDB check attributes and client attributes.
required false
type Hash
default
{}
example
"tags": {
  "dc": "us-central-1"
}
http_proxy
description The URL of a proxy to be used for HTTP requests.
required false
type String
example
"http_proxy": "http://192.168.250.11:3128"
timeout
description The InfluxDB HTTP API POST timeout (write).
required false
type Integer
default 10
example
"timeout": 3
ssl
description Enables communication over HTTPS.
required false
type Boolean
default false
example
"ssl": true