Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Image RemovedImage Added

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 which you can import that have been curated by the team for you to play around import and explore start exploring Usage Engine.  In the following image, each row depicts a stream.

...

Note
titleNote!

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 in order 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 scalabilityScalability.


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

Image Added

Action Toolbar

Selecting a single stream on the table enables the following actions for that stream:

...

This will open up the Export Stream modal used to copy down the content of the given stream. 

Image Removed

The following information is listed in the dialog box: 

  • Stream name – Shows the name of the selected stream. 
  • Stream Content

Copy to Clipboard button is available allowing the users to copy the stream content to their computer's clipboard. The Export file will save the stream content to a JSON file that will be downloaded to the users' computer. 

...

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.

The Actions menu available for each stream lists the following options: 

...

. 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: 

ActionAction Toolbar IconDescription
Start

Image Added

Starts the selected stream.
Schedule

Image Added

Shows the Schedule Settings dialog box. 

Image Modified

There are different

Different scheduling options

that

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

there are

, different scheduling rules

that

can be selected: 

  • Minute  – Run every 15, 20, or 30 minutes. 
  • Hour – Run every 1 hour, 2 hours, 3 hours, 4 hours, 6 hours, or 12 hours. 
  • Day – This option works by designating both a Start Time and defining the Timezone. Additional schedule rules can be added by clicking on the Add time button. 
  • Week – The scheduling rules are defined by choosing the selected days of the week, the start time, and the timezone. Additional times can be entered by clicking on the Add time button. 
  • Month – This is the most complex scheduling option. The scheduling rules allow for select days of the month to be entered in the designated field, the associated start time is entered below it, and the associated timezone is to be selected on the right. 
Audit

Image Added

This opens the Audit Dashboard
Log

Image Added

This opens the Logs screen
Data Correction
This opens the Data Correction tab showing errors for the current stream.
Set NotificationsImage Added

This opens the notifications screen. From here email notification options can be designated for each

notifications group. The two

Notification Group. The following options can be toggled as needed: 

  • Send an email when no file is found
  • Send an email when the stream fails 
  • Send an email when a stream executes successfully
  • Send an email when there is a new error in Data Correction.

Click on the Apply button to confirm the notifications setup and close the window. 

ExportImage Added

This

shows the export action which is the same as the one available from the toolbar. Duplicate

will open up the Export Stream modal used to copy down the content of the given stream. 

Image Added

You can either copy the contents using the Copy to Clipboard button or download the stream content in a JSON file format.

Duplicate

Image Added

This creates a copy of the selected stream. The duplicate will have "Copy" in its title to differentiate it from the original.
Delete

Image Added

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 on into the functioning of streams and provide example streams for further understanding:

...