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. if you have to have active sessions. This means that a stream with a Data aggregator function needs to be run at least once.
To navigate to the Inspect tab, double-click on the Data aggregator function icon from the stream editor canvas, then click Inspect at the top right of the page.
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 |
|---|---|
View | View or copy the individual session data in JSON format. |
Edit Timeout | Edit the timeout date and time on a session before a timeout window has passed. 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. |
Note!
You cannot delete a solution, stream, or data aggregator function that has active aggregation sessions. You must first delete the aggregation sessions and then delete the functions, streams, and solutions they were a part of.
Toolbar buttons
Filter
Note!
The filter option is available for up to 10,000 records in the Inspect tab. If there are more than 10,000 records the filter will be disabled. This limit helps to maintain smooth and efficient stream execution in Usage Engine and ensures optimal system performance during large-scale data processing.
Filter panel fields | Description |
|---|---|
Planned timeout | Select from the dropdown list or select Custom and enter the from and to dates and times. |
Session created | Select from the dropdown list or select Custom and enter the from and to dates and times. |
Fields | Select the Field and Type of field from the dropdown lists. Depending on the Type of field selected (String, Number, or Boolean) different options will become available. For example, if the Type of field is Number, then the Operator field will appear where you can select the relevant Operator from the dropdown list, like, Less than, Greater than, Equal to etc.. Finally, enter the value(s) of the field - this option will also change depending on the Type of field selected. |
+ Add field | Add up to 5 fields in the filter |
Display options panel
Enable or disable the Overview widgets and select which columns to display in the data table. You can also toggle the Overview widgets on and off in this panel.
Refresh data
Use 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.
Example- metadata for an aggregated session
{"origin":"Data_Aggregator","count":7,"flushType":"TIMEOUT","firstEvent":"2022-04-08T17:35:53.239Z","lastEvent":"2022-04-08T17:38:17.315Z","lastCall":false}
Property name | Description |
|---|---|
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 |