The following guide can be used to assist you when creating your unique batch scaling solution. An important thing to remember is that you cannot mix standard agents with scaling agents in the same workflows. Workflows with standard agents save the state in Usage Engine, but workflows with batch agents save the state in Kafka
When creating a scalable batch workflow in Usage Engine, it’s important to ensure that all agents with storage capabilities are configured to use Kafka storage. Additionally, scalable workflows require scalable Inter Workflow Collection and Forwarding Agents, as regular Inter Workflow Agents are not compatible. Mixing agents with different storage types, such as a Data Aggregator agent configured with Kafka storage and another with file storage, within the same workflow is not supported.
Creating a scalable solution
...
Always start with a Batch Scaling Collection Workflow that collects from the original file source and forwards UDRs to Kafka.
...
The Batch Scaling Processing Workflows can be one or a series of workflows. Batch Duplication Check and Aggregation can be part of the same workflow. There can only be one Aggregation agent and one Deduplication agent per workflow.
...
(example)
These are high-level steps to creating a scalable batch solution in Usage Engine. The following example solution is made up of several profiles including the newly created Partition Profile (4.3) and Scalable Inter Workflow Profile (4.3), and two workflow types, Batch Scaling Collection and Batch Scaling Processing.
Decide on your scaling factor, this will be the maximum number of workflows that can effectively cooperate to process a batch. This is an important choice and will be difficult to change once your workflows are in production.
| Note |
|---|
Warning! |
You must choose one or more fields in your UDRs that will be used to partition data. These fields may be based on a record group like a customer ID or an account number
...
UI Parameters
...
Parameter
...
Comment
...
ID Field
...
Defines how to match a UDR to a partition.
...
Max Scale Factor
Number of partitions, which is the same as maximum number of workflows that can execute in parallel.
Note!
If any of the parameters needs to be changed, it is considered a new configuration, and they need to start with empty topics.
...
.
Create a Kafka Profile pointing to your cluster
Create a Partition Profile where you define your Max Scale Factor and your partitioning fields.
Create the Aggregation, Duplicate UDR, and Scalable Inter Workflow profiles and link the Partition Profile created in Step 2 to each.
Create your workflows.
Standard workflows - prepare data for scaling by sending it to the scalable InterWF Forwarder
Scalable processing workflows - collect data with a Scalable InterWF Collector.
| Note |
|---|
Warning! |
Note!
You can include multiple Aggregation and Duplicate UDR agents within the same workflow. These agents can either share the same Partition Profile or use different Aggregation and Duplicate UDR Profiles. For instance, you might use different profiles if you need to apply a different ID field as the Key in storage.
Scaling Batch Workflows
Usage Engine will scale out and in and re-balance scalable batch workflows automatically and you can schedule when to start a scale-out or scale-in.
...
Deploying a scale-out configuration with ECDs:
Add image
Use the regular ECD (Execution context deployment) definition using Use https://infozone.atlassian.net/wiki/x/IgMkEg with Dynamic Workflows to define how to package a scale-out. For instance:
A Collection Workflow scales with 1 extra Workflow per ECD.
A Processing Workflow scales with 3 extra Workflows per ECD.
...
Scheduling a scale-out configuration:
You can schedule the ECD and workflow to start or stop at specific times, alternatively, these can also be started manually. This is configured in… If no schedule for scaling is created, the system will scale automatically based on metrics.
Add an image of the setting for the manual schedule.
Use this table to explain the settings in the image.
...
Automatic Scaling
...
Manual Scaling
...
Based on Metric.
Should also have some “duration” of the metric to avoid oscillating behavior?
...
You can start up ECDs manually.
...
See the tabs on https://infozone.atlassian.net/wiki/x/VgQkEg for more information.