WSO2Event Event Receiver

WSO2Event event receiver is used to receive events in the WSO2Event format via Thrift or binary protocols. By default it uses the following ports to retrieve events.

For Thrift:
- TCP port:7611
- SSL port:7711
For Binary:
- TCP port:9611
- SSL port:9711

Use the tcp://<HOSTNAME>:<PORT> and ssl://<HOSTNAME>:<PORT> URLs to send events to the server as follows.

Use the following format for load-balancing:
{tcp://<HOSTNAME>:<PORT>,tcp://<hostname>:<PORT>, ...}
Use the following format for failover:
{tcp://<HOSTNAME>:<PORT>|tcp://<hostname>:<PORT>| ...}
Use the following format to send messages to more than one cluster of endpoints (cluster is defined using "{}") :
{tcp://<HOSTNAME>:<PORT>|tcp://<hostname>:<PORT>| ...},{tcp://<hostname>:<PORT>}
In the above format, the event is delivered to one endpoint on the first cluster of endpoints in a failover manner. Also, the same message is delivered to the endpoint defined in the second cluster.

Creating a WSO2Event event receiver

For instructions on creating a WSO2Event event receiver, see Configuring Event Receivers.

Configuring adapter properties

Specify the Adapter Properties, when creating a WSO2Event event receiver using the management console as shown below.

After entering the above adapter properties, select the Event Stream to which you want to map the incoming events, and the Message Format which you want to apply on the receiving events. Also, click Advanced to define custom input mappings based on the Message Format you selected. For more information on custom input mapping types, see Input Mapping Types.

You can also define the respective adapter properties of the event receiver based on the transport type within the <from> element of the event receiver configuration in the <PRODUCT_HOME>/repository/deployment/server/eventreceivers/ directory as follows.

<eventReceiver name="WSO2EventReceiver" statistics="disable" trace="disable" xmlns="http://wso2.org/carbon/eventreceiver">
    <from eventAdapterType="wso2event">
        <property name="events.duplicated.in.cluster">false</property>
    </from>
    ...................
</eventReceiver>

The above adapter properties are described below.

Adapter Property	Description	Configuration file property	Example
Is events duplicated in cluster	In a cluster whether the same event can reach two receiver nodes	events.duplicated.in.cluster	true/false

Related samples

For more information on wso2event event receiver type, see the following samples.