Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel2
typeflat

...

When you set up a query as an aggregation task, it will give you great performance when you use it to feed widgets in an Activeboard, and also Devo applications. This is because an aggregation task creates a background task that continually updates and aggregates the query's values. This way new data is more quickly reflected in the widget the aggregation task is feeding. There is a blue rocket icon on widgets that can be optimized using aggregation tasks.

Info

Using aggregation tasks (former data sources) in Activeboards

Keep in mind that in Activeboards, aggregation tasks generated from a widget's source query are automatically used to optimize the widget performance, so you don't need to do anything more afterwards. Learn more about Activeboard widgets and how they work in Using widgets.

What permission do I need?

To create and manage aggregation tasks you need to have the manage version of the Domain aggregation tasks permission. The view version allows you to see existing aggregation tasks but not to manage them or create new ones (know more about permissions here).

...

Creating aggregation tasks

...

Rw ui steps macro
Rw step

Go to Data Search and run the query that generates the data you require for your widgets.

Info

Not with lookups

To use aggregation tasks effectively, you must not create them using queries with lookups, otherwise, they might not work as expected. This is so because of technical reasons related to the interaction between the components behind them.

Rw step

Click the options menu in the toolbar and select New → Aggregation task.

Info

Group your data

You must group your data to create an aggregation task. The option will be disabled if you didn’t or if you did it multiple times.

Be aware that if you use a non-time-based grouping, you will not be able to later use the eventdate field in the aggregation task query. If you do, you will get an error message explaining this.

Rw step

The New aggregation task window appears. Enter the required information and click Create

This table lists and describes the fields in this window. 

NameRequired

Enter a name for the aggregation task (max 1024 characters).

Description

Enter a description of the aggregation task (max 1024 characters).

Tags

Enter tags that help categorize the aggregation task.

Build From

Enter the date from which you want to start collecting data.

Minimum grouping period

Select how often you want data to be aggregated. Choose between 1 minute5 minutes, or 30 minutes or Auto (default option).

In real time

Check this option if you want data to be sent in real-time. If not checked, use the Delay field to specify the maximum acceptable time difference between the current time and the last event displayed.

Rw step

The system notifies you that generating the aggregation task from the aggregation task may take a few minutes. Click Yes. You will see a notification message once the aggregation task is generated.

Info

Limited number of aggregation tasks

Since they have an impact on the overall system, Devo limits the number of active aggregation tasks per user so make sure you use them wisely.

...

Administrator users can check all aggregation tasks and activate/deactivate them in the Aggregation Tasks tab of the Administration → Data Management area. Go to the Aggregation task article to learn more about this.

...