No release in over 3 years
Low commit activity in last 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
2025
2026
 Dependencies

Development

Runtime

 Project Readme

Warning

This repository is scheduled to be archived on 13th November 2026.

After that date it will be read-only: no new commits, issues, or pull requests, and no further maintenance or security updates will be issued.

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.