Federation tasks

Step 1: Create a task

1. Log on to the ApsaraMQ for RabbitMQ console.

2. In the left-side navigation pane, click Federation Tasks.

3. On the Federation Tasks page, click Create Task.

Step 2: Authorize the service

When you create a federation task for the first time, the system automatically creates a service-linked role named AliyunServiceRoleForEventBridgeRabbitMQPlugin.

In the Alibaba Cloud Service Authorization dialog box, review the authorization details and click Confirm.

Role description: AliyunServiceRoleForEventBridgeRabbitMQPlugin is a service-linked role that allows EventBridge to implement the RabbitMQ plugin capability.

Step 3: Configure cluster information

On the federation task configuration page, configure the source and destination cluster information.

Step 4: Configure task parameters

On the task parameters page, configure the task settings.

Step 5: Verify the task status

On the Federation Tasks page, you can see the task you created. The initial status is Starting.

When the status changes to Running, the federation task is successfully started.

1. Plan Max hops carefully

• For simple point-to-point synchronization, set the value to 1.

• For multi-hop federation topologies, set the value based on the actual topology depth.

• Avoid setting an excessively large value to prevent messages from being forwarded in a loop.

2. Use precise exchange expressions

• Use precise regular expressions to match only the exchanges you need to synchronize.

• Avoid broad expressions such as .* to prevent synchronizing unnecessary exchanges.

• Examples:

  • Match all exchanges that start with "order": ^order.*

  • Match specific exchanges by name: ^(order|payment|inventory)$

3. Choose the right ordering mode

• Concurrent: Best for scenarios where message ordering is not critical. Provides higher throughput.

• Sequential: Best for scenarios that require strict message ordering, such as order processing or state transitions.

4. Monitor and set up alerts

• Periodically check the federation task status.

• Configure alerts for message backlogs.

• Monitor synchronization latency to detect issues early.

5. Plan your network

• Make sure that the network latency between the source and destination clusters is within an acceptable range.

• For cross-region synchronization, consider using Express Connect or a VPN to improve network stability.

• Plan your VPC and security group rules to ensure network connectivity.

The federation task is stuck in the "Starting" state. What should I do?

Check the following items:

1. Verify that the source and destination clusters have network connectivity.

2. Verify that the cluster credentials (username and password) are correct.

3. Verify that EventBridge is activated and authorized.

4. Check the console for error messages and troubleshoot accordingly.

How do I troubleshoot message synchronization delays or losses?

1. Delays: Check the network bandwidth usage and consider optimizing message sizes or increasing bandwidth.

2. Losses: Verify that the message size limit on the destination instance is at least equal to the limit on the source instance. Check whether the Max hops setting is appropriate. Verify that the exchange expression correctly matches the target exchanges.

Can I modify a federation task after it is created?

Federation tasks cannot be modified after creation. To change the configuration, delete the existing task and create a new one.

Does federation support bidirectional synchronization?

Federation tasks are unidirectional. To achieve bidirectional synchronization, create two federation tasks in opposite directions.