Amazon MQ Document History - Amazon MQ

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
August 22, 2022

Created separate parent chapters for Amazon MQ for ActiveMQ and Amazon MQ for RabbitMQ engines. These parent chapters now contain engine details, tutorials, and best practices:

January 13, 2022

Added a new troubleshooting section that lists the status codes that Amazon MQ returns when a broker is in an unhealthy state, along with detailed information about diagnosing, and recovering the broker.

November 8, 2021

Added new tutorial that describes setting up a Python Pika client with Amazon MQ for RabbitMQ brokers.

October 8, 2021

Added the following troubleshooting topics for both Amazon MQ for ActiveMQ and Amazon MQ for RabbitMQ broker engines:

September 22, 2021

Added the following topics for troubleshooting common connection, and authorization issues with Amazon MQ for ActiveMQ brokers:

August 12, 2021

Added the following section to describe troubleshooting common issues when working with Amazon MQ brokers.

July 29, 2021

Added the following sections to describe Amazon MQ for RabbitMQ version management and upgrading Amazon MQ brokers to new minor and major engine versions as they are supported.

July 21, 2021

Added the following sections to describe connecting an Amazon MQ broker to AWS Lambda as an event source.

July 16, 2021

Added the following sections to describe Amazon MQ broker maintenance windows, and how to adjust a maintenance window using the AWS Management Console, AWS CLI, or the Amazon MQ API.

June 7, 2021

Added the following sections to describe Amazon MQ for ActiveMQ version management and upgrading Amazon MQ brokers to new minor and major engine versions as they are supported.

May 18, 2021

Added the following section to describe Amazon MQ for RabbitMQ broker defaults

May 5, 2021

Added the following section for describing AWS managed policies for Amazon MQ and updates to these policies:

February 16, 2021

Added the following tutorial section for Amazon MQ for RabbitMQ:

November 4, 2020
December 16, 2019
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: ActiveMQ 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 Quotas in Amazon MQ section.
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 ActiveMQ 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 broker web console 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 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 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 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 Amazon EFS.
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 Security in Amazon MQ and Best Practices 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 Amazon MQ for ActiveMQ resources section.
January 18, 2018 Clarified and corrected the information in the Quotas 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 sections section.
December 8, 2017
December 7, 2017
December 5, 2017
December 4, 2017
December 1, 2017
  • Updated and improved the screenshots in all the tutorials.

  • Clarified the following explanation throughout this guide: Making changes to a configuration revision or an ActiveMQ user does not apply the changes immediately. To apply your changes, you must wait for the next maintenance window or reboot the broker. For more information, see Amazon MQ broker configuration lifecycle.