Skip to main content
Loading

Configure routing in the outbound YAML file

Overviewโ€‹

This page describes how to configure the routing section of the /etc/aerospike-esp-outbound/aerospike-esp-outbound.yml which controls how Aerospike records are routed to an ESP destination that was configured in the destinations section.

The following routing modes are available.

  • static-multi-destination List of destinations to route to.
  • skip Skip dispatch of record to the destination and ack success to XDR.
  • custom Route with custom code.

Static Multi Destination Routingโ€‹

This routing sends the same change notification record to multiple destinations.

danger

The connector sends a successful ack to XDR if and only if a record shipping succeeds on all the destinations. If any of the destination fails, XDR receives a failure ack and the same change notification record is triggered again. The caveat here is that all the destinations will receive the change notification record again, even though some of them successfully processed in the previous attempt.

For static-multi-destination routing, the configuration options are:

OptionRequiredDefaultDescription
modeyesUse static-multi-destination .
destinationsyesList of destination names configured the destinations section.

Exampleโ€‹

  routing:
mode: static-multi-destination
destinations:
- "xdr-proxy1"
- "xdr-proxy2"

Skip routingโ€‹

For skip routing, the configuration options are:

OptionRequiredExpected valueDescription
modeyesskipSkip dispatch of record to the destination and ack success to XDR.

Exampleโ€‹

routing:
mode: skip

Custom Routingโ€‹

Record can be also be routed with custom code. See Routing Transform.

Exampleโ€‹

routing:
mode: custom
class: com.aerospike.connect.outbound.example.GenerationRouter