Difference between revisions of "Plugin:Aggregation/Config"

From collectd Wiki
Jump to: navigation, search
m (Aggregated CPU statistics per host: fix example as suggested by user on IRC)
(add loading of match plugin)
Line 31: Line 31:
 
If you don't want to keep the per-CPU statistics around, you can use the [[Chains|filter mechanism]] to get rid of them:
 
If you don't want to keep the per-CPU statistics around, you can use the [[Chains|filter mechanism]] to get rid of them:
  
 +
LoadPlugin "match_regex" # we want to use this for our Matching
 
  <Chain "PostCache">
 
  <Chain "PostCache">
 
   <Rule> # Send "cpu" values to the aggregation plugin.
 
   <Rule> # Send "cpu" values to the aggregation plugin.

Revision as of 14:13, 18 June 2014

This page contains some example configurations for the Aggregation plugin. This page is meant as a cookbook, so if you have a configuration for an aspect not handled here or a daemon not present, please feel free to add anything that's useful for you.

Aggregated CPU statistics per host

The following configuration aggregates the CPU statistics of all CPUs into one set using the sum and average consolidation functions.

<Plugin "aggregation">
  <Aggregation>
    Plugin "cpu"
    Type "cpu"
    
    GroupBy "Host"
    GroupBy "TypeInstance"
    
    CalculateSum true
    CalculateAverage true
  </Aggregation>
</Plugin>

This will result in a per-CPU-state set of values for each host. The values will be names according to this schema:

host.example.com/aggregation-cpu-sum/cpu-idle
host.example.com/aggregation-cpu-sum/cpu-user
host.example.com/aggregation-cpu-sum/cpu-system
…
host.example.com/aggregation-cpu-average/cpu-idle
host.example.com/aggregation-cpu-average/cpu-user
host.example.com/aggregation-cpu-average/cpu-system
…

If you don't want to keep the per-CPU statistics around, you can use the filter mechanism to get rid of them:

LoadPlugin "match_regex" # we want to use this for our Matching
<Chain "PostCache">
  <Rule> # Send "cpu" values to the aggregation plugin.
    <Match regex>
      Plugin "^cpu$"
      PluginInstance "^[0-9]+$"
    </Match>
    <Target write>
      Plugin "aggregation"
    </Target>
    Target stop
  </Rule>
  <Target write> # Write everything else via "rrdtool".
    Plugin "rrdtool"
  </Target>
</Chain>

See also