This repository contains contributed custom plugins for the Rackspace Cloud Monitoring agent. For details about installing plugins, see agent plugin check documentation.
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
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.
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
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.