Smart Routing

General
KubeMQ smart routing is In-flight and routing tables messaging feature which allows to multicast a messages to many destinations in single operation.
Multicast Destinations
RPC and Queues senders can multicast a message to many channels at once, even to a different messaging pattern. Separate each destination with a ; and specify the message pattern type with :.
Message Pattern Format
Pattern
Format
Example
Events
events:
events: events.foo.bar;events: events.foo.bar.1
Events Store
events_store:
events_store: store.foo.bar;events_store: store.foo.bar.1
Queues
queues:
queues: q1.foo.bar; queues: q2.foo.bar
Predefined Routes - Smart routes
A predefined routes rule can be set with KubeMQ Smart Routing configuration and can be used like that:
Pattern
Format
Will routes
Routes
routes: all-foo-bar
to all destinations defined by all-foo-bar route
Mixing Message Pattern destinations
Mixing message pattern destination is allowed. for example, an events sender can send a message to events_store subscriber and to a queues subscriber at the same time.
Examples
Sends From
Channel Destinations
Will routes to
Events
foo.bar;foo.bar.1;events_store: store.foo;queues: q1
events->foo.bar, events->foo.bar.1, events_store->store.foo, queues->q1
Events Store
foo.bar.store;events: bar.1;queues:q2; routes:my-route
events_store->foo.bar.store, events-> bar.1, queues -> q2, all destinations defined by my-route
Queues
q1.foo.bar;events: bar.1;events_store:store.foo.1
queues-> q1.foo.bar, events-> bar.1, events_store-> store.foo.1
Smart Route Preload Configuration
A routing rule is defined by a record with two fields:
Field
Type
Description
Key
string
unique key name for the routing rule
Routes
string
channel destinations separated by ;
Routes cannot point to another Route Key
Example:
Two routing rules:
[
   {
      "Key":"all-to-foo-bar",
      "Routes":"events:foo.bar;events_store:foo.bar;queues:foo.bar"
   },
   {
      "Key":"sink-to-events-channel",
      "Routes":"events:sink"
   }
]
The Smart Route preload configuration feature is available only on KubeMQ Enterprise Edition.
Register for free 30 days license here.

Channels

Grouping

Last modified 3yr ago

Pattern	Format	Example
Events	events:	events: events.foo.bar;events: events.foo.bar.1
Events Store	events_store:	events_store: store.foo.bar;events_store: store.foo.bar.1
Queues	queues:	queues: q1.foo.bar; queues: q2.foo.bar

Pattern	Format	Will routes
Routes	routes: all-foo-bar	to all destinations defined by all-foo-bar route

Sends From	Channel Destinations	Will routes to
Events	foo.bar;foo.bar.1;events_store: store.foo;queues: q1	events->foo.bar, events->foo.bar.1, events_store->store.foo, queues->q1
Events Store	foo.bar.store;events: bar.1;queues:q2; routes:my-route	events_store->foo.bar.store, events-> bar.1, queues -> q2, all destinations defined by my-route
Queues	q1.foo.bar;events: bar.1;events_store:store.foo.1	queues-> q1.foo.bar, events-> bar.1, events_store-> store.foo.1

Field	Type	Description
Key	string	unique key name for the routing rule
Routes	string	channel destinations separated by ;