Welcome to new Sensu Plugins!

Posted Jan 27, 2015 by Matt Jones

Welcome to the new Sensu Plugins website and repos!

There are a lot changes dropping in the next few months and all of them should greatly benefit the community. A few of the changes have already been made, this site being a major one. The Developer Guidelines have also been updated to reflect some of the new features dropping over the next several months and the new policies that these bring.

Before we get too deep into things let me assure you that there will be no forced upgrades, changes in license/functionality, or anything else to harm our precious, held-together-with-duct-tape-and-perlruby, monitors. Sensu plugins was always designed to be an integral part of an open framework and that will not change. What is going to change is the manner in which the plugins are written, test, built, and delivered.

This has always been a community project built upon the hardwork and input of many people, sometimes though people don’t realize they can or should contribute. This post is a great example of how things will be done from now on.

Sensu Plugins Blog

Whenever major changes are coming or hot issues, bugs, etc present themselves we can now create a simple blog post that gives an overview of the topic with a direct link back to the original post. This post will be much more accesible then an Issue or a Pull Request buried among two dozen plus repos. The RSS feed, for those that want to utilize it, will be ideal for keeping up with community developments and codebase changes.

New Repositories

Why so many repos? One of the major changes, if not the main change, will be the splitting up of the Sensu Community Plugins repo in the many smaller repositories. Extensions, handlers, and mutators will be broken out completely into their own repositories as well. These repos will be organized by application and contain all plugins used by the application. This will allow much more granular deployments and easier versioning. It will no longer be necessary to bump the entire project for a simple typo in a single plugin. Issue 985 has been created for this discussion.


In the very near future each of these smaller repos will also be built into their own gem and released to RubyGems. This will allow you to add ‘sensu-plugins-aws’ to your cookbook, manifest, or bundle and get either the latest version or a version of your choice. At specific intervals throughout the year, the current thinking is quarterly, a meta-gem will be released containing the latest stable builds of every gem for those who would like to go the monolithic route.

A user could also create their own meta-gems if they would like, consisting of every gem needed for their own stack.

The timeline, reasoning, and further details can be found here and Issue 847 but in a nutshell there will be ample time for people to transition to this new concept. New features will continue to be accepted into the old repo till at least May 2015 while a build and release pipeline is stabilized. Around this time the old repo will be frozen for all feature requests, bug and security fixes will still be actively merged till at least June. I stress this timeline is very movable and dependent on a lot of hard work by several people.

When the community feels it is ready and has faith in the new pipeline and build process, the old repo will be hard frozen and archived in place.


Due to the nature and use of these plugins and the fact that some of the monitors can be fairly invasive to a production system, all sensu-plugins gems will be signed. While many of the dependencies we rely upon are not, and no solution is perfect every little bit helps. As gems get released documentation will be created and posted on how to take advantage of this if your environment or personal predilections desire this feature. For those who are not concerned a standard bundle install or gem install will still work without issue, but for the sake of your system and piece of mind I urge you to utilize this.


Documentation for the plugins will be automatically generated from RDoc sources, built into each gem and also served from a central location on this site.

I hope to continue helping to build and work with this great community and I am always open to new ideas, ways of thinking, or being told I am flat-out wrong.

Sensu Plugins

The home for all Sensu Community plugins, handlers, and mutators. Open Source under MIT License.

Copyright © 2015-2017 Sensu-Plugins and contributors.

Sensu - sensuapp.org

Monitor servers, services, application health, and business KPIs. Get notified about failures before your users do. Collect and analyze custom metrics. Give your business the competitive advantage it deserves. Open Source under MIT License.

Join in on the fun!

We welcome contributions and usually accept pull requests within a week! Pick any of our 150+ plugins and hack away!


Watch Star