Table of Contents
.rb, .sh, .exe, etc). Extensions are unfortunately necessary for Sensu to be able to directly exec plugins and handlers on Windows. All scripts should also be made executable using chmod +x plugin` or a similar method. There is a rake task that is run by Travis that will automatically make all files in /bin executable if this is not done.option :port,
short: '-p PORT',
long: '--port PORT',
description: 'Port',
#! /usr/bin/env ruby
#
# <script name>
#
# DESCRIPTION:
#
# OUTPUT:
# plain text, metric data, etc
#
# PLATFORMS:
# Linux, Windows, BSD, Solaris, etc
#
# DEPENDENCIES:
# gem: sensu-plugin
#
# USAGE:
#
# NOTES:
#
# LICENSE:
# <your name> <your email>
# Released under the same terms as Sensu (the MIT license); see LICENSE
# for details.
#
When at all possible preference is given to pure Ruby implementations. There should only be system or platform dependencies in the specific gems that use them such as sensu-plugins-windows.
The preferred license for all code associated with the project is the MIT License, other compatible licenses can certainly be looked at by the community as whole.
Any code that is written is owned by the developer and as such the copyright, if they desire, should be set to themselves. This is an open source project and built upon the collective code of all who contribute, no one person or entity owns everything. If for whatever reason they wish to not assign copyright to themselves then it can be assigned to sensu-plugins.
All documentation will be handled by Yard using the default markup at this time. A brief introduction to Yard markup can be found here. All scripts should have as much documentation coverage as possible, ideally 100%. Coverage can be tested by installing Yard locally and running
rake yard
The change log should follow the format listed here. Please keep this changelog up to date, if you make changes to the repo and submit a PR please update the changelog accordingly. Please follow the guidelines below when updating the changelog with respect to which number to bump.
Dependencies (ruby gems, packages, etc) and other requirements should be declared in the header of the plugin. Try to use the standard library or the same dependencies as other plugins to keep the stack as small as possible. Questions about using a specific gem feel can be opened as issues on Github or feel free to ask the mailing list.
If you see something wrong or come across a bug please open up an issue, try to include as much data in the issue as possible. If you feel the issue is critical than tag a team member and we will respond as soon as is feasible.
Pull requests need to follow the guidelines below for the quickest possible merge. These not only make our lives easier, but also keep the repo and commit history as clean as possible.
git pull --rebase both before you start working on the repo and then before you commit. This will help ensure the most up to date codebase, Rubocop rules, and documentation is available. It will also go along way towards cutting down or eliminating(hopefully) annoying merge commits.Tracking the status of your PR or issue, or seeing all open tickets in the org regardless of repo is simple using Github filters. To get started click on the Github logo in the upper left and select either Pull Requests or Issues. In the search box you will see several terms predefined for you, change author:name to user:sensu-plugins to see across the entire org.
Please do not not abandon your pull request, only you can help us merge it. We will wait for feedback from you on your pull request for up to sixty days. A lack of feedback in after this may require you to re-open your pull request.
If you would like to make a pull request and the repo does not already exist then please feel free to directly contact a member of the team using our public email address or open an issue in the Feature Request repo and we will create a repo for you. As a general rule if you ask to have a repo created you will also be given write access to it by default.
Each gem has metadata that can easily be queried and is designed to allow a user or contributor to get a good quick read on the current status of the gem and how stable it is. This functions much like the Milestone idea that Logstash plugins are built around, thanks goes out to @hatt for suggesting this.
s.metadata = { 'maintainer' => ''}
The maintainer field can be anyone, feel free to reach out to the team about adding your github handle to the gem and assuming ‘ownership’ of it. Many of these plugins require specialized knowledge and by their very nature many people depend upon them to be high quality.
s.metadata = { 'development_status' => ''}
The development_status filed allows users know the development state of a plugin:
active => active development is on going by a developer or maintainer
maintenance => no active refactoring or development but someone is watching out for any new pr’s or things to do.
unmaintained => the community as a whole is keeping an eye on this but no one has staked a claim to it (most plugins will end up here)
s.metadata = { 'production_status' => ''}
The production_status field gives a quick glance on whether the gem should be used for production grade monitoring or if some review and care should be taken.
production grade => near 100% rspec and yardoc coverage
stable - review recommended => incomplete rspec and yardoc coverage
stable - review required => little/no rspec and/or yardoc coverage
unstable - testing recommended => throw stuff at the wall and hope it sticks (currently most gems are here)