Manage Recurrent Data Streams
Data Streams of the Streaming type will run polling Agents at a set interval, for instance, every 10 seconds, whereas Recurrent Data Streams run on a customizable schedule, for instance, once a day at 12 AM. This may be useful if you only want to read data or perform an action with the data at certain points during the day, or if you want to perform actions on the data once a week, month or year.
Note
It is recommended that you read the articles listed below to improve your understanding of Data Streams.
Creating Recurrent Data Streams
The streaming type of the Data Stream can be configured at the time of the Data Stream's creation.
- Click on add Data Stream from the left-hand menu.
- Change the Type to be Recurring.
- Click on Save.
To change an existing Data Stream to recurring, go into the properties menu and change the type to be recurring.
- Click on Properties.
- Change the Type to be Recurring.
- Click on Save.
Configuring Recurrence for Agents
When a Data Stream is set to be recurring, opening the configuration menu for listeners or context providers will allow you to make changes to the schedule for when they occur.
To configure recurrence for Agents, follow the steps below:
- Add Agents to the Data Stream Canvas.
- Click on Configure for an Agent. Instead of polling intervals, the configuration menu will ask you to configure recurrence.
- Configure the schedule for the Agent.
Recurrence
The following table describes the Recurrence configuration properties:
| Property | Description |
|---|---|
| Start Repeat | Specify whether the Agent's schedule should start Immediately when the Data Stream is published or On a configured date and time. Note: If the Start Repeat (On) is already in the past at the time the Data Stream is published, the Agent waits to execute on the next scheduled Repeat. |
| Repeat | The schedule's unit of time. The available options are: Seconds, Minutes, Hourly, Daily, Weekly, Monthly, or Yearly. |
| Repeat Every | How frequently the repeat interval occurs. For example, every 30 seconds, every 2 weeks, etc. |
| Repeat On | Specify when the Repeat occurs (applies to Weekly, Monthly, and Yearly): • For Weekly, select one or more days of the week (e.g., Monday, Wednesday, Friday). • For Monthly, choose the day of the month (1-31). • For Yearly, select the month and day. |
| Repeat At | The time of day that the Agent executes (applies to Daily, Weekly, Monthly, and Yearly). |
| End Repeat | Choose for the recurrence to Never end, end On the specified date, or end After the specified number of occurrences. Note: If the Data Stream is published and the End Repeat conditions are already met (the On date is in the past, or the Start Repeat On date is in the past and calculated occurrences up to the current date have reached the set After value), the Agent will not execute. |
Warning
Execution Behavior Examples:
We always execute first on the configured Start Repeat. When Start Repeat and the scheduled Repeat fall on the same day, the Agent executes at the Start Repeat time but skips the Repeat At time to avoid duplicate execution on the same day. The regular schedule resumes on the next occurrence on a different day.
Example 1: If you configure Start Repeat On 15 January at 9:00 AM, Repeat Daily at 2:00 PM, and publish the Data Stream on 15 January at 8:00 AM, the Agent executes on 15 January at 9:00 AM, skips the 2:00 PM execution that same day, and then resumes the regular daily schedule at 2:00 PM on 16 January.
Example 2: If the Start Repeat is on Monday, and the Repeat is Weekly on Wednesday and Friday, publishing the Data Stream on a Sunday first executes on Monday, and proceed with the scheduled repeats on Wednesday and Friday.
Recommendation: To ensure predictable behavior, set the Start Repeat On date and time to match the next scheduled Repeat when using Daily or less frequent intervals.
Last modified: December 05, 2025