# 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, collectd-perl, 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