Troubleshooting Amazon MQ
This section describes common issues you might encounter when using Amazon MQ brokers, and the steps you can take to resolve them.
For general troubleshooting, see Troubleshooting: General Amazon MQ. For troubleshooting your specific
engine version, see the following sections.
Troubleshooting ActiveMQ on Amazon MQ
| Troubleshooting topic |
Description |
| General troubleshooting |
Use the information in this section to help you diagnose
and resolve common issues you might encounter when working with ActiveMQ on Amazon MQ brokers. |
| BROKER_ENI_DELETED |
ActiveMQ on Amazon MQ will raise a BROKER_ENI_DELETED alarm when you delete a broker’s Elastic Network Interface (ENI). |
| BROKER_OOM |
ActiveMQ on Amazon MQ will raise a BROKER_OOM alarm when the broker undergoes a restart loop due to
the insufficient memory capacity |
Troubleshooting RabbitMQ on Amazon MQ
| Troubleshooting topic |
Description |
| General troubleshooting |
Diagnose common issues
you might encounter when working with RabbitMQ brokers. |
| RABBITMQ_MEMORY_ALARM |
RabbitMQ will raise a high memory alarm when the broker's memory usage, identified by CloudWatch metric
RabbitMQMemUsed, exceeds the memory limit, identified by RabbitMQMemLimit. |
| RABBITMQ_INVALID_KMS_KEY |
RabbitMQ on Amazon MQ will raise an INVALID_KMS_KEY critical action required code when a broker created
with a customer managed AWS KMS key(CMK) detects that the AWS Key Management Service (KMS) key is disabled. |
| RABBITMQ_INVALID_ASSUMEROLE |
RabbitMQ on Amazon MQ will raise an INVALID_ASSUMEROLE critical action required code when the IAM role ARN specified in aws.arns.assume_role_arn cannot be assumed by Amazon MQ. |
| RABBITMQ_INVALID_ARN_LDAP |
RabbitMQ on Amazon MQ will raise an INVALID_ARN_LDAP critical action required code when the LDAP service account password ARN is invalid or inaccessible. |
| RABBITMQ_INVALID_ARN |
RabbitMQ on Amazon MQ will raise an INVALID_ARN critical action required code when one or more ARNs in the broker configuration are invalid or inaccessible. |
| RABBITMQ_DISK_ALARM |
Disk limit alarm is an indication that the volume of disk used by a RabbitMQ node has decreased due to
a high number of messages not consumed while new messages were added. |