In Usage Engine, streams are created inside solutions. Once inside a solution, you can create a new stream. However, you can also import a stream using the JSON schema or simply drag and drop your JSON file. There are example streams curated by the team for you to import and start exploring Usage Engine. In the following image, each row depicts a stream.
You can also click on Import Stream to open the stream import dialog box. Here, streams can be imported either by dragging a JSON file onto the upper part of the modal. The stream export file contents can alternatively be pasted in the input box. Click on the Import button to confirm the stream entry and add the stream.
Clicking Create Stream takes you to the Stream Editor where you can create the stream of your choice using the Functions that are part of your subscription package.
Note!
When creating streams, depending on your subscription package, you will be presented with an option to configure your stream according to the number of records it needs to process. This is to support the concept of Performance and Scalability when handling streams in Usage Engine.
After clicking Create Stream, you must select the number of records to be processed per stream execution or stream run. Each stream is configured to process a maximum of 10,000,000 records per execution. If you want to process more than 10,000,000 records, you can configure stream replica(s) to process a large number of records without compromising on the performance of Usage Engine. You can choose the number of replicas you wish to create to effectively process your records with the least impact on performance.
However, there are some prerequisites that you need to ensure before configuring replicas. For more information about this, refer to Performance and Scalability.
All streams you create in that solution are listed in a table. If you have several streams in the solution, you can search for streams, and by selecting the streams in the table, you can manage them using actions and create Stream Groups.
Action Toolbar
Selecting a single stream enables the following actions for that stream. You can access the same options using the More menu that is available under the Actions column.
The following actions are available for a stream:
Action | Action Toolbar Icon | Description |
---|---|---|
Start | Starts the selected stream. | |
Schedule | Shows the Schedule Settings dialog box. Different scheduling options are available from this dialog box. Using one of the buttons the users can designate the desired frequency: Minute, Hour, Day, Week, and Month. For each option, different scheduling rules can be selected:
| |
Audit | This opens the Audit Dashboard. | |
Log | This opens the Logs screen. | |
Data Correction | — | This opens the Data Correction tab showing errors for the current stream. |
Set Notifications | This opens the notifications screen. From here email notification options can be designated for each Notification Group. The following options can be toggled as needed:
Click on the Apply button to confirm the notifications setup and close the window. | |
Export | This will open up the Export Stream modal used to copy down the content of the given stream. You can either copy the contents using the Copy to Clipboard button or download the stream content in a JSON file format. | |
Duplicate | This creates a copy of the selected stream. The duplicate will have "Copy" in its title to differentiate it from the original. | |
Delete | This will delete the selected stream. |
Selecting two or more streams removes the actions mentioned above and gives you the choice to delete the streams together or create a stream group.
In this section, the following chapters can provide more insight into the functioning of streams and provide example streams for further understanding: