Aggregators main page

• General information about interfaces: Aggregator
• Available implementations: Implementations of aggregators
• How to customize: Custom aggregators
• Aggregation interval
  
  

General info

Aggregators are processing raw data to get final measurement results that will be saved to database.
Aggregators are executed after all measurements are finished. Main goal for them is to reduce number of data values available after measurement
Simplest example: after measurement there are 1000 points, but you want to save only 200 points to database
So you are applying averaging aggregator that takes average value for every 5 points from raw data and saves it to DB as single value.

Example of aggregators setup in XML:

Simple example:

            <!-- begin: following section is used for docu generation - standard aggregator usage -->
            <metric id="CustomSuccessRateSummary" xsi:type="metric-success-rate" saveSummary="true">
                <metric-aggregator xsi:type="metric-aggregator-avg"/>
            </metric>
            <!-- end: following section is used for docu generation - standard aggregator usage -->

Example with additional setting for aggregation:

            <!-- begin: following section is used for docu generation - metrics with aggregators -->

            <!-- Math functions with aggregators with settings -->
            <!-- Normalize metric value by seconds -->
            <metric id="constant1-sum-normalized-1s" xsi:type="metric-custom" calculator="constant" plotData="true" saveSummary="true">
                <metric-aggregator xsi:type="metric-aggregator-sum" normalizeBy="SECOND"/>
            </metric>

            <!-- Set number of points in the plots for this metric -->
            <metric id="increase1-sum-point-count-10" xsi:type="metric-custom" calculator="alwaysIncrease" plotData="true" saveSummary="true">
                <metric-aggregator xsi:type="metric-aggregator-sum" pointCount="10"/>
            </metric>

            <!-- Set exact interval between points in the plots for this metric -->
            <metric id="sin1-sum-point-interval-2s" xsi:type="metric-custom" calculator="sin" plotData="true" saveSummary="true">
                <metric-aggregator xsi:type="metric-aggregator-sum" pointInterval="2000"/>
            </metric>

            <!-- end: following section is used for docu generation - metrics with aggregators -->

Aggregators XML elements

metricAggregatorAbstract - what aggregators can be used in XML elements. See 'Sub Types' section of man page
How aggregators mentioned above are implemented you can see in section: Implementations of aggregators

Aggregation interval

Aggregation interval defines how many values will be saved to database and displayed in plots.
In property file you can decide what parameter you will set.
You can set either number of points on the plot or directly aggregation interval.

# begin: following section is used for docu generation - Aggregation interval

# # # Number of points displayed in plots # # #
# Properties will influence aggregation interval of measured parameters
# You can define exact interval between points,
#   or you can define count of points and interval will be calculated
# It is also possible to set interval or point count for every measured parameter separatly
# See Aggregators documentation for more info

chassis.engine.e1.reporting.task.type=count
# chassis.engine.e1.reporting.task.type=interval

# Exact interval between plot points in milliseconds

chassis.engine.e1.reporting.task.point.interval=5000

# Count of points

chassis.engine.e1.reporting.task.point.count=100

# end: following section is used for docu generation - Aggregation interval

In the picture below you can see comparison of both settings:
for session 26 - point count was set
for session 29 - interval

Aggregation interval setup