racker/rackspace-monitoring-agent-plugins-contrib

Name: rackspace-monitoring-agent-plugins-contrib

Owner: racker

Description: Contributed Rackspace Monitoring Agent plugins

Created: 2012-12-05 18:24:28.0

Updated: 2018-02-01 08:34:48.0

Pushed: 2018-03-01 04:42:31.0

Homepage: null

Size: 249

Language: Python

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Rackspace Monitoring Agent Custom plugins

This repository contains contributed custom plugins for the Rackspace Cloud Monitoring agent. For details about installing plugins, see agent plugin check documentation.

How to Contribute

You can contribute your plugins by first forking the repo, committing your changes, and then opening a pull request through github. If you have any questions, feel free to reach out to us on #cloudmonitoring on freenode IRC.

Plugin Requirements

Each plugin must fulfill the following properties:

Status

The status message should be of the form status $status_string, For example, it might be:

status ok succeeded in obtaining metrics

or

status err failed to obtain metrics

The status string should be a summary of the results, with actionable information if it fails.

Metrics

The metrics message should be of the form metric $name $type $value [unit], for example:

metric time int32 1 seconds

The units are optional, and if present should be a string representing the units of the metric measurement. Units may not be provided on string metrics, and may not contain any spaces.

The available types are:

Alarm Criteria

Each script should contain, just below the license header, in a comment, an example alarm criteria that can be used for the plugin. See the Rackspace Cloud Monitoring Documentation for how to write alarm criteria.

Submodules

Submodules of repositories are stored in the contrib folder in this repo.
There are more plugins in that folder, some of these plugins have dependencies and their own readmes.

The contrib directory contains submodules of more custom plugins that have been used by other teams, including those from openstack and rackspace. These are older plugins for Icehouse/Juno, newer plugins for Kilo can be found at rcbops/rpc-openstack or inside contrib/rpc-openstack/maas/plugins.

You can pull the submodules with

pull --recurse-submodules
submodule update --recursive
License Header

The exact content will depend on your chosen license, but we recommend BSD, Apache 2.0, or MIT Licenses. Regardless of license choice the header should contain the author's (or authors') name(s) and email address(es).


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.