Configuration

This section explains each of the properties in the configuration blade.

Fig 1: Event Simulator Configuration Example

General

Property	Description
Collection	This associates the Agent to a specific Collection and defaults to that of the current Data Stream.

Refer to Collections and Stream Hosts to understand more about Collections.

Simulate

Property	Description
Polling Interval (Seconds)	The time interval between the generation of successive events.
No. of Events	The total number of records to generate. If zero (default), the Listener will output indefinitely until the Data Stream is stopped.
Events per polling interval	The number of records to generate per interval.
Micro Batch?	Tick to send the records per interval in batches of a configurable size. Unticked by default, i.e. records sent individually.
Batch Size	The number of records to send per micro-batch (applies when Micro Batch? is ticked). If the number of records per interval or the total number of records does not fit the batch size, a smaller batch with the remainder is produced.

Assuming the following:

• No. of Events: 15

• Events per polling interval: 10

• Micro Batch: enabled

• Batch Size: 4

3 micro batches will be sent in the first interval (4, 4, and 2); and 2 in the next interval (4 and 1). There will be no further batches as the maximum number of events has been reached.

Event Definition

Defines the shape of the data to be created. There must be at least one row in this grid. Adding a new row, or selecting an existing row, will open another blade to allow you to edit that property.

Fig 2: Range Event Definition Example

Fig 3: Fixed Event Definition Example

Property	Description
Name	The name of the property, which must be unique.
Type	Range: The property will have its value randomised within a certain range for every record. Fixed: The property will have a single value repeated for every record.
Value Type	The data type of the property (applies to Fixed Type only, all Range Type values are Double).
Minimum Value	The minimum numeric value created (applies to Range Type only).
Maximum Value	The maximum numeric value created (applies to Range Type only).
Fixed Value	The value that will be used for every record (applies to Fixed Type only). For Boolean type values, enter "true" or "false".

Spike Settings

This area is used to generate a "spike" in a running data stream.

Property	Description
Spike Value	The value to "force" for this property.
Generate Spike	Press this button to force the next record generated by the Listener to use the Spike Value for this property.

Unlike most configuration settings, it is not necessary to configure the Spike Value property before the Data Stream is published.

Although the Spike Value cannot be saved while the Data Stream runs, the Generate Spike button uses the current value. This allows you to spike a single property multiple times with different values.

The spike request is sent to a single Stream Host. It is most useful when demonstrating, testing, or developing a Data Stream in a collection with a single active stream host.

Endpoints

Name	Description
Output	The generated events are made available to this endpoint, with properties as configured in the Event Definition, plus: ReadingNo - a Long property that gives a count of records generated since the Data Stream was published. Timestamp - a DateTime property that states when that record was generated.
Error	Errors encountered during the execution of this Agent will be published on this endpoint.