Built-in Handlers

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

Reference documentation

• What are built-in handlers?
• How to use built-in handlers?
  • Examples
• List of built-in handlers

What are built-in Handlers?

Sensu Enterprise ships with several built-in third-party integrations, which provide Sensu event handlers. These built-in handlers can be used to handle events for any check. The Enterprise integrations use their own global configuration namespaces in combination with enterprise contact routing to provide granular controls over how events should be handled in a variety of circumstances.

How to use built-in handlers

After configuring one or more enterprise handlers, you can specify which ones are used per check or create a default handler set to specify those used by default.

Examples

The following is an example of how to configure a Sensu check to use the built-in email integration (i.e. Enterprise handler).

/etc/sensu/conf.d/checks/load_balancer_listeners.json

{
  "checks": {
    "load_balancer_listeners": {
      "command": "check-haproxy.rb -s /var/run/haproxy.sock -A",
      "subscribers": [
        "load_balancer"
      ],
      "interval": 20,
      "handler": "email"
    }
  }
}

The following is an example of how to configure the Sensu default handler in order to specify one or more built-in enterprise handlers. The default handler is used when a check definition does not specify one or more event handlers. This example specifies the built-in email and slack enterprise handlers.

/etc/sensu/conf.d/handlers/default.json

{
  "handlers": {
    "default": {
      "type": "set",
      "handlers": [
        "email",
        "slack"
      ]
    }
  }
}

List of built-in handlers

Built-in event handlers:

• Email - send email notifications for events
• PagerDuty - create and resolve PagerDuty incidents for events
• Rollbar - Create and resolve Rollbar messages/items for Sensu events
• ServiceNow - create ServiceNow CMDB configuration items and incidents
• JIRA - create and resolve JIRA issues for Sensu events
• VictorOps - create and resolve VictorOps messages for events
• OpsGenie - create and close OpsGenie alerts for events
• Slack - send notifications to a Slack channel for events
• HipChat - send notifications to a HipChat room for events
• IRC - send notifications to an IRC channel for events
• SNMP - send SNMP traps to a SNMP manager
• Graylog - send Sensu events to Graylog
• Flapjack - relay Sensu check results to Flapjack
• Puppet - deregister Sensu clients without an associated Puppet node
• Chef - deregister Sensu clients without an associated Chef node
• EC2 - deregister Sensu clients without an allowed EC2 instance state
• Event Stream - send all Sensu events to a remote TCP socket
• InfluxDB - send metrics to InfluxDB. Learn how to easily route and translate data with InfluxDB and Sensu here.
• Graphite - send metrics to Graphite
• Wavefront - send metrics to Wavefront
• Librato - send metrics to Librato Metrics
• OpenTSDB - send metrics to OpenTSDB
• DataDog - create Datadog events
• TimescaleDB - send metrics to TimescaleDB