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:
- Output a status message to STDOUT
- Output one or more metrics if it succeeds in obtaining them to STDOUT
- Contain an appropriate license header
- Contain example alarm criteria
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:
- string
- float
- double
- int32
- int64
- uint32
- uint64
- gauge
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.
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).