Configuring Sensu as an event source

You can set up an integration with Netcool® Operations Insight® to receive notifications created by Sensu. Sensu can monitor servers, services, application health, and business KPIs.

Before you begin

The following event types are supported for this integration:
  • event management supports the default Sensu events. The use of mutators is not recommended.
  • Sensu Core 2.0 Beta is not supported.
The following criteria apply to configuring Sensu as an event source:
  • The CEM event handler plug-in must be installed in the location from where it will be used to send events to event management.
  • Install Ruby before you use the CEM event handler. When you install Sensu, Ruby can be embedded and found under the following directory (example): /opt/sensu/embedded/bin/ruby --version.

Procedure

  1. Click Administration > Integrations with other systems.
  2. Click New integration.
  3. Go to the Sensu tile and click Configure.
  4. Enter a name for the integration.
  5. Click Download file to download and extract the cem-event-handler-plugin.zip file.
    Important: The download file contains credential information and must be stored in a secure location.
  6. Copy cem.json to /etc/sensu/conf.d.
  7. Copy cem.rb to /etc/sensu/plugins.
  8. Run sudo chmod +x /etc/sensu/plugins/cem.rb.
    Example: copy cem-event-handler-plugin.zip to a directory and then run the following command at the directory to extract all files and grant execution permission to cem.rb (for this example unzip must be installed and permission to run sudo is required):
    unzip cem-event-handler-plugin.zip 'cem.rb' -d /etc/sensu/plugins; unzip cem-event-handler-plugin.zip 'cem.json' -d /etc/sensu/conf.d; sudo chmod +x /etc/sensu/plugins/cem.rb
  9. Add the CEM event handler to each Sensu check definition to send events to event management.
    Example:
    {
      "checks": {
       "check_mem": {
          "command": "check-memory-percent.rb -w 50",
          "interval": 60,
          "subscribers" : [
           "dev"
          ],
          "handler": "cem"
        }
      }
    }
  10. Restart the Sensu services.
  11. To start receiving alert notifications from Sensu, verify that Enable event management from this source is set to On..