The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Collectd::Plugins::Riemann::Query - Collectd plugin for querying Riemann Events

SYNOPSIS

To be used with Collectd.

From the collectd configfile
 <LoadPlugin "perl">
   Globals true
 </LoadPlugin>

 <Plugin "perl">
   BaseName "Collectd::Plugins"
   LoadPlugin "Riemann::Query"
   <Plugin "Riemann::Query">
     Host     myriemann
     Port     5555
     Protocol TCP
     # Static plugin metadata
     <Plugin foo>
       Query          "tagged \"foo\" and service =~ \"bar%\""
       Plugin         foo
       PluginInstance bar
       Type           gauge
     </Plugin>
     # plugin metadata from riemann attributes
     <Plugin>
       Query              "tagged \"aggregation\""
       PluginFrom         plugin
       PluginInstanceFrom plugin_instance
       TypeFrom           ds_type
       TypeInstanceFrom   type_instance
     </Plugin>
   </Plugin>
 </Plugin>

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 documentation. Or man collectd-perl

FILES

/etc/collectd.conf /etc/collectd.d/

SEE ALSO

Collectd, collectd-perl, collectd