/
Data aggregator - Inspect tab

Data aggregator - Inspect tab

 

Cloud_Edition_button.webp

The Inspect tab in the Data aggregator function allows you to manage individual aggregation sessions, including viewing, inspecting, and deleting them. There are a few ways to access the Inspect tab, via the Data aggregator function as documented below, and via the Aggregation tab, see Aggregation tab for more details.

Note!

The Inspect tab of the Data aggregator function is only accessible after the stream has been executed at least once.

To open the Inspect tab, double-click the Data aggregator function icon from the stream editor canvas, then click on the Inspect tab at the top right of the page.

Stream_point_to _aggregator.png
Stream editor canvas

Page navigation:

Widgets

The widgets provide a snapshot of the number of active sessions, the oldest ongoing session, and the most recently initiated session. You can hide the widgets by going to Display options and switching off the Overview widgets toggle.

Inspect tab table

The table on the Inspect tab displays the data related to the sessions.

Actions on the Inspect tab table

Under More you have the following options:

Action

Description

Action

Description

 View

Shows you the state of an aggregation session. You can copy the data if required.

Example - Aggregated session data in JSON format

This is an example of the JSON file that can be seen in view. It shows the session data after aggregation.

{ "data": { "printerId": 104, "minute_30_timestamp": "2025-01-12T11:30", "sum_sheets": 31 }, "createdAt": "2025-02-07T14:22:39.426Z", "meta": { "count": 1, "firstEvent": "2025-02-07T14:22:38.625Z", "lastEvent": "2025-02-07T14:22:38.625Z" }, "timeoutAt": "2025-02-08T10:00:00.000Z", "updatedAt": "2025-02-07T14:22:39.426Z" }

"data":
This section displays the aggregated fields from the configuration.

"createdAt": "2025-02-07T14:22:39.426Z"
This marks the start time of the aggregation session, showing when the session was created.

"count": 1
The number of events that have been processed in this session so far. In this example, only 1 event has been processed.

"firstEvent": "2025-02-07T14:22:38.625Z", and “lastEvent": "2025-02-07T14:22:38.625Z"
The timestamp of the earliest and most recent event(s) in this session.

"timeoutAt": "2025-02-08T10:00:00.000Z"
The timestamp when this session becomes eligible for flushing based on the configured timeout conditions. The actual flush timing depends on the stream type:

  • Batch stream – The session will be flushed the next time the stream runs.

  • Realtime stream – The session is checked every 60 seconds, and if the timeoutAt time has passed, it will be flushed in the next processing cycle.

"updatedAt": "2025-02-07T14:22:39.426Z"

The timestamp of the last update to this aggregation session.

  • If more events are processed before flushing, this value will update accordingly.

  • It typically updates when new data is added to the session.

Note!
These metadata fields can be used when creating custom scripts for aggregated data. See, Metadata, at the bottom of this page for more details.

Edit Timeout

Edit the timeout date and time on a session before a session is flushed. This allows you to change when a timeout will happen before a session gets flushed.

Delete

Delete the session. A warning message and confirmation dialogue will pop up.

Toolbar buttons

Filter panel

Click on the Filter button to open the Filter panel.

You can filter the aggregated sessions based on the following:

Setting

Description

Setting

Description

Session creation

Select from the dropdown list or select Custom and enter the from and to dates and times.

Planned timeout

Select from the dropdown list or select Custom and enter the from and to dates and times.

Fields

Use this option to filter by the Field and Value of a specific attribute. For example, after selecting a numeric Field, you can choose an Operator like Less than, Greater than, Equal to, or you can filter according to Range of values or Is not equal to.

Display options panel

Click on the Display options button to open the Display options panel. Here you can enable or disable the Overview widgets and select which columns to display in the data table.

Refresh data

Click on this button to update and view the most current state of the aggregation sessions or data being displayed.

Metadata

There may be instances where you want to apply certain rules to aggregated data, such as applying a discount or adjusting values based on specific business rules. You can achieve this by using the Script function. If you need to reference metadata from aggregated sessions, such as the number of records or timestamps, you can access it using the meta-variable as described in Supported variables/APIs.

Property

Description

Property

Description

origin

This indicates that the data comes from the Data Aggregator component of the stream

count

Number of aggregated records

flushType

The reason for the session being flushed out. Shows any of the values: ALL_FILES, EACH_FILE, TIMEOUT, and CONDITION. During preview, the value will be empty.

firstEvent

Date and time of the first aggregated record in the session

lastEvent

Date and time of the last aggregated record in the session

 

Related content