Amazon MQ - Developer Guide

1 Amazon MQDeveloper GuideAmazon MQ Developer GuideAmazon MQ: Developer GuideCopyright 2019 Amazon Web Services, Inc. and/or its affiliates. All rights 's trademarks and trade dress may not be used in connection with any product or service that is not Amazon 's, in any mannerthat is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon . All other trademarks notowned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored MQ Developer GuideTable of ContentsWhat is Amazon MQ? .. 1 What Are the Main Benefits of Amazon MQ?

2 1 How Is Amazon MQ Different from Amazon SQS or Amazon SNS? .. 1 How Can I Get Started with Amazon MQ? .. 2We Want to Hear from You .. 2 Frequently Viewed Topics .. 3 Setting Up .. 4 Step 1: Create an AWS Account and an IAM Administrator User .. 4 Step 2: Create an IAM User and Get Your AWS Credentials .. 4 Step 3: Get Ready to Use the Example Code .. 5 Next Steps .. 5 Getting Started .. 6 Prerequisites .. 6 Step 1: Create an ActiveMQ Broker .. 6 Step 2: Connect a Java Application to Your Broker .. 7 Prerequisites .. 7 Create a Message Producer and Send a Message .. 8 Create a Message Consumer and Receive the Message.

3 9 Step 3: Delete Your Broker .. 10 Next Steps .. 10 Tutorials .. 12 Creating and Configuring a Broker .. 12 Step 1: Configure Basic Broker Settings .. 12 Step 2: (Optional) Configure Advanced Broker Settings .. 13 Step 3: Finish Creating the Broker .. 14 Accessing the ActiveMQ Web Console of a Broker without Public Accessibility .. 15 Creating and Configuring a Network of Brokers .. 16 Prerequisites .. 17 Step 1: Allow Traffic between Brokers .. 17 Step 2: Configure Network Connectors for Your Broker .. 18 Next Steps .. 19 Editing Broker Preferences .. 20To Edit Broker Engine Version, CloudWatch Logs, and Maintenance Preferences.

4 20 Creating and Applying Configurations .. 21 Step 1: Create a Configuration from Scratch .. 21 Step 2: Create a New Configuration Revision .. 21 Step 3: Apply a Configuration Revision to Your Broker .. 22 Editing Configurations and Managing Configuration Revisions .. 23To View a Previous Configuration Revision .. 23To Edit the Current Configuration Revision .. 20To Apply a Configuration Revision to Your Broker .. 25To Roll Back Your Broker to the Last Configuration Revision .. 25 Connecting a Java Application to Your Broker .. 26 Prerequisites .. 26To Create a Message Producer and Send a Message .. 27To Create a Message Consumer and Receive the Message.

5 28 Listing Brokers and Viewing Broker Details .. 29To List Brokers and View Broker Details .. 29 Creating and Managing Broker Users .. 30To Create a New User .. 31To edit an existing user .. 31To Delete an Existing User .. 32 Rebooting a Broker .. 32To Reboot an Amazon MQ Broker .. 32iiiAmazon MQ Developer GuideDeleting a Broker .. 33To Delete an Amazon MQ Broker .. 33 Accessing CloudWatch Metrics .. 33 AWS Management Console .. 34 AWS Command Line Interface .. 35 Amazon CloudWatch API .. 35 How Amazon MQ Works .. 36 Basic Elements.. 36 Broker .. 36 Configuration.

6 41 Engine.. 42 User.. 42 Broker Architecture .. 43 Single-Instance Broker .. 43 Active/Standby Broker for High Availability .. 44 Network of Brokers .. 45 Broker Configuration Lifecycle .. 52 Broker Configuration Parameters .. 53 Working with Spring XML Configuration Files .. 53 Permitted Elements .. 54 Permitted Attributes .. 56 Permitted Collections .. 63 Working Java Examples .. 69 Prerequisites .. 71 Tagging resources .. 76 Tagging for Cost Allocation .. 76 Managing Tags in the Amazon MQ Console .. 77 Managing Using Amazon MQ API Actions .. 78 Migrating to Amazon MQ.. 79 Without Service Interruption.

7 79To migrate to Amazon MQ without service interruption .. 80 With Service Interruption .. 81To migrate to Amazon MQ with service interruption .. 82 Best Practices .. 84 Using Amazon MQ Securely .. 84 Prefer Brokers without Public Accessibility .. 84 Always Use Client-Side Encryption as a Complement to TLS .. 84 Always Configure an Authorization Map .. 85 Always Configure a System Group .. 85 Connecting to Amazon MQ.. 85 Never Modify or Delete the Amazon MQ Elastic Network Interface .. 85 Always Use Connection Pooling .. 86 Always Use the Failover Transport to Connect to Multiple Broker Endpoints.

8 87 Avoid Using Message Selectors .. 87 Prefer Virtual Destinations to Durable Subscriptions .. 87 Ensuring Effective Amazon MQ Performance .. 87 Disable Concurrent Store and Dispatch for Queues with Slow Consumers .. 87 Choose the Correct Broker Instance Type for the Best Throughput .. 88 Configure Your Network of Brokers Correctly .. 89 Avoid Slow Restarts by Recovering Prepared XA Transactions .. 89 Limits.. 91 Brokers .. 91 Configurations.. 91 Users.. 92 Data Storage.. 92 API Throttling .. 92ivAmazon MQ Developer GuideMonitoring and Logging.. 94 Monitoring Brokers Using CloudWatch .. 94 Broker Metrics.

9 94 Destination (Queue and Topic) Metrics .. 96 Logging API Calls Using CloudTrail .. 97 Amazon MQ Information in CloudTrail .. 97 Example Amazon MQ Log File Entry .. 99 Configuring Amazon MQ to Publish Logs to CloudWatch Logs .. 100 Understanding the Structure of Logging in CloudWatch Logs .. 100 Add the CreateLogGroup Permission to Your Amazon MQ User .. 101 Configure a Resource-Based Policy for Amazon MQ.. 101 Troubleshooting CloudWatch Logs Configuration .. 102 Security .. 103 API Authentication and Authorization.. 103 IAM Permissions Required to Create an Amazon MQ Broker .. 103 REST API Permissions Reference.

10 104 Messaging Authentication and Authorization.. 105 Related Resources .. 106 Amazon MQ Resources .. 106 Apache ActiveMQ Resources .. 106 Release Notes .. 108 Document History .. 112 AWS Glossary .. 120vAmazon MQ Developer GuideWhat Are the Main Benefits of Amazon MQ?What Is Amazon MQ? Amazon MQ is a managed message broker service for Apache ActiveMQ that makes it easy to migrateto a message broker in the cloud. A message broker allows software applications and componentsto communicate using various programming languages, operating systems, and formal MQ works with your existing applications and services without the need to manage, operate, ormaintain your own messaging What Are the Main Benefits of Amazon MQ?