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 assumes your cpu plugin is configured this way:
<Plugin cpu> ValuesPercentage false ReportByCpu true </Plugin cpu>
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>
Aggregated CPU frequency per host
This example plots the average CPU frequency for a given host. It changes the GroupBy to "PluginInstance" to group all fields.
<Plugin "aggregation"> <Aggregation> Plugin "cpufreq" Type "cpufreq" GroupBy "Host" GroupBy "PluginInstance" CalculateAverage true </Aggregation> </Plugin>