Amazon MQ
Developer Guide

Amazon MQ Document History

The following table lists changes to the Amazon MQ Developer Guide. For Amazon MQ feature releases and improvements, see Amazon MQ Release Notes.

Date Documentation Update
July 19, 2019 Modified and added content on encryption management in the following sections:
April 22, 2019 Added the following sections for tag-based policies and resource-level permissions:
March 4, 2019 Improved the documentation for configuring dynamic failover and the rebalancing of clients for a network of brokers. Enable dynamic failover by configuring transportConnectors along with networkConnectors configuration options.
January 5, 2019 Improved documentation on some per-minute metrics. For more information, see the following: Destination (Queue and Topic) Metrics.
December 19, 2018
December 11, 2018 Updated documentation to reflect availability of ActiveMQ version 5.15.8.
December 5, 2018 Added the Tagging resources section.
October 26, 2018 Added the Avoid Slow Restarts by Recovering Prepared XA Transactions section.
October 15, 2018 Updated the Limits in Amazon MQ section.
October 3, 2018 Corrected outdated links in the Setting Up Amazon MQ and Amazon MQ Tutorials sections.
October 1, 2018 Corrected the information in the Next Steps section.
September 27, 2018
September 18, 2018 Added the following note to the Creating and Managing Amazon MQ Broker Users section: You can't configure groups independently of users. A group label is created when you add at least one user to it and deleted when you remove all users from it.
August 31, 2018
August 15, 2018 Corrected the information in the Create an ActiveMQ Broker section.
August 13, 2018 Added the Accessing the ActiveMQ Web Console of a Broker without Public Accessibility section.
August 2, 2018
  • Added the Troubleshooting CloudWatch Logs Configuration section.

  • Added the following admonition throughout this guide:

    Important

    In the following example code, producers and consumers run in a single thread. For production systems (or to test broker instance failover), make sure that your producers and consumers run on separate hosts or threads.

August 1, 2018 Corrected the information in the following sections:
July 31, 2018
July 30, 2018
July 19, 2018
July 5, 2018
June 29, 2018
June 26, 2018 Added a link to a related resource to the Migrating to Amazon MQ section.
June 4, 2018

In addition to GitHub, HTML, PDF, and Kindle, the Amazon MQ Developer Guide release notes are available as an RSS feed.

May 29, 2018

Made the following changes in the Working Java Example section:

  • Added a STOMP+WSS Java example. The STOMP+WSS example Java code connects to a broker, creates a queue, and publishes and receives a message.

  • Improved the MQTT Java example.

  • Improved the OpenWire Java example.

May 24, 2018 Corrected the wire-level protocol endpoint port in the MQTT Java example in the Working Java Example section.
May 22, 2018 Corrected the information in all Java dependency sections.
May 17, 2018 Corrected the information in the Limits Related to Users section.
May 15, 2018 Corrected the information in the Ensuring Effective Amazon MQ Performance section.
May 8, 2018
May 7, 2018
May 1, 2018 Clarified the information about the maintenance window for active/standby brokers in the following sections:
April 27, 2018 Rewrote the following sections and optimized example Java code to match the recommendation to use connection pooling only for producers, not consumers:
April 26, 2018 Added an MQTT Java example to the Working Java Example section. The MQTT example Java code connects to a broker, creates a topic, and publishes and receives a message.
April 4, 2018 Renamed the Communicating with Amazon MQ section to Connecting to Amazon MQ.
April 3, 2018 Clarified and corrected the information in the Disable Concurrent Store and Dispatch for Queues with Slow Consumers section.
April 2, 2018 Moved the Concurrent Store and Dispatch for Queues in Amazon MQ section to the Disable Concurrent Store and Dispatch for Queues with Slow Consumers section.
March 27, 2018
March 22, 2018 Clarified the following statement throughout this guide: Amazon MQ encrypts messages at rest and in transit using encryption keys that it manages and stores securely. For additional security, we highly recommend designing your application to use client-side encryption. For more information, see the AWS Encryption SDK Developer Guide.
March 19, 2018 Clarified the following statement throughout this guide: An Active/standby broker is comprised of two brokers in two different Availability Zones, configured in a redundant pair. These brokers communicate synchronously with your application, and with a shared storage location.
March 15, 2018
March 12, 2018
March 9, 2018
March 8, 2018
March 6, 2018 Added the following note throughout this guide:

Note

Using the mq.t2.micro instance type is subject to CPU credits and baseline performance—with the ability to burst above the baseline level (for more information, see the CpuCreditBalance metric). If your application requires fixed performance, consider using an mq.m5.large instance type.

March 1, 2018
February 28, 2018 Corrected image display in GitHub.
February 27, 2018 In addition to HTML, PDF, and Kindle, the Amazon MQ Developer Guide is available on GitHub. To leave feedback, choose the GitHub icon in the upper right-hand corner.

February 26, 2018
  • Made regions consistent in all examples and diagrams.

  • Optimized links to the AWS console and product webpages.

February 22, 2018 Clarified and corrected the information in the following sections:
February 21, 2018 Corrected the Java code in the following sections:
February 20, 2018 Clarified and corrected the information in the Amazon MQ Security and Best Practices for Amazon MQ sections.
February 19, 2018
February 16, 2018
February 15, 2018
February 14, 2018 Updated the following sections:
February 13, 2018
January 25, 2018
January 24, 2018
January 19, 2018 Updated the information in the Apache ActiveMQ Resources section.
January 18, 2018 Clarified and corrected the information in the Limits in Amazon MQ section.
January 17, 2018 Reinstated the recommendation to prefer virtual destinations over durable subscriptions, with an improved explanation.
January 11, 2018
January 3, 2018 Added DescribeConfigurationRevision to the API Authentication and Authorization for Amazon MQ section.
December 15, 2017 Removed the recommendation against durable subscriptions from the Best Practices for Amazon MQ section.
December 8, 2017
December 7, 2017
December 5, 2017
December 4, 2017
December 1, 2017