https://github.com/ccin2p3/collectd-plugins-riemann
Collectd plugin to query riemann
https://github.com/ccin2p3/collectd-plugins-riemann
Last synced: 2 months ago
JSON representation
Collectd plugin to query riemann
- Host: GitHub
- URL: https://github.com/ccin2p3/collectd-plugins-riemann
- Owner: ccin2p3
- License: other
- Created: 2015-04-23T14:55:44.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2015-04-30T13:44:27.000Z (about 10 years ago)
- Last Synced: 2025-01-23T14:41:28.586Z (4 months ago)
- Language: Perl
- Size: 164 KB
- Stars: 0
- Watchers: 11
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Collectd-Plugins-Riemann
# NAME
Collectd::Plugins::Riemann::Query - Collectd plugin for querying Riemann Events
# SYNOPSIS
To be used with [Collectd](https://metacpan.org/pod/Collectd).
- From the collectd configfile
Globals true
BaseName "Collectd::Plugins"
LoadPlugin "Riemann::Query"
Host myriemann
Port 5555
Protocol TCP
# Static plugin metadata
Query "tagged \"foo\" and service =~ \"bar%\""
Plugin foo
PluginInstance bar
Type gauge
# plugin metadata from riemann attributes
Query "tagged \"aggregation\""
PluginFrom plugin
PluginInstanceFrom plugin_instance
TypeFrom ds_type
TypeInstanceFrom type_instance
# Root block configuration options
- Host STRING
riemann host to query. defaults to localhost
- Port STRING
riemann port to query. defaults to 5555
- Protocol STRING
defaults to TCP
# Plugin block configuration options
- Query STRING
Riemann Query. Mandatory
- Host STRING
Static host part of collectd plugin. If unset, the host part of the riemann event will be used instead.
- PluginFrom/TypeFrom/PluginInstanceFrom/TypeInstanceFrom STRING
Dynamic plugin metadata: riemann attribute to be used to set corresponding collectd metadata. service and host are also possible. Defaults to plugin, type, plugin\_instance and type\_instance respectively.
- Plugin/Type/PluginInstance/TypeInstance STRING
Will be used instead if no \*From counterpart is used or found in riemann event. Can be used as a fallback. Default for Type is gauge and for Plugin is riemann service of the event.
# SUBROUTINES
Please refer to the [Collectd](https://metacpan.org/pod/Collectd) documentation.
Or `man collectd-perl`
# FILES
/etc/collectd.conf
/etc/collectd.d/
# SEE ALSO
* [collectd](https://github.com/collectd/collectd)
* [riemann](https://github.com/aphyr/riemann)
* [Collectd](https://github.com/collectd/collectd/blob/master/bindings/perl/lib/Collectd.pm) perl module
* [collectd-perl](https://github.com/collectd/collectd/blob/master/src/collectd-perl.pod) manpage
* [collmann](https://github.com/exoscale/collmann) embedding riemann into collectd
## INSTALLATION
To install this module, run the following commands:
perl Makefile.PL
make
make test
make install
## SUPPORT AND DOCUMENTATION
After installing, you can find documentation for this module with the
perldoc command.
perldoc Collectd::Plugins::Riemann
## DEVELOPMENT
https://gitlab.in2p3.fr/wernli/collectd-plugins-riemann
https://gitlab.in2p3.fr/wernli/collectd-plugins-riemann/issues