No commit activity in last 3 years
No release in over 3 years
The Sensu Core built-in deregistration handler
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

 Project Readme

Sensu::Extensions::Deregistration

NOTE: This extension is considered experimental and needs testing!

For each event recieved, this handler extension deletes the corresponding client via the /clients API

Installation

  1. Install this gem using sensu-install

    $ sensu-install -e sensu-extensions-deregistration
  2. Configure Sensu to load the extension, as documented here.

    {
      "extensions": {
        "deregistration": {
          "gem": "sensu-extensions-deregistration"
        }
      }
    }

Configuration

With the extension loaded, the "deregistration" handler is now available for use with client deregistration attributes:

{
  "client": {
    "name": "1-424242",
    "...": "...",
    "deregister": true,
    "deregistration": {
      "handler": "deregistration"
    }
  }
}

With this configuration in place, clients will be automatically deregistered when sensu-client process recieves a SIGTERM.