Logging for IBM MQ as a Service - AWS

IBM® MQ as a Service generates application logs that you can use to investigate abnormal activity and critical actions in your account, and troubleshoot problems.

You can access IBM MQ as a Service application logs through your AWS CloudWatch account. Logs are filtered by CRN, so that you can only view your own logs on CloudWatch.

The logs contain error and status messages generated by queue managers, and system messages relating to IBM MQ. (They are the equivalent to the logs described in Error logs in the main IBM MQ documentation.)

Note: You can also download these log files by using the IBM MQ as a Service UI, see Downloading queue manager logs and diagnostics.

Locations where logs are generated

AWS AP Northeast 1 (Tokyo)
AWS EU Central 1 (Frankfurt)
AWS US East 1 (North Virginia)
AWS SA East 1 (Sao Paulo)

Viewing logs

Use the AWS CloudWatch console to view the log entries. You can use the filter facilities in AWS CloudWatch to view particular log entries that you want to examine. When you find a log entry of interest, click on it to view the full log entry in JSON format.

Queue manager log entries contain a message code in the format AMQxxxx, you can search the main IBM MQ documentation for more information on particular message codes.

Fields by log type

For information about fields included in every platform log, see Fields for platform logs.

Label	Explanation
`message.ibm_messageId`	Starting `AMQ` - this value refers to the category of the IBM MQ diagnostic message, see AMQ messages in the main IBM MQ documentation for further detail
`message.ibm_version`	The IBM MQ version in the form `9.4.5.0`
`message.loglevel`	The level of log, for example `WARNING` or `ERROR`
`message.ibm_serverName`	The name of the QueueManager
`message.message`	The main message content for the IBM MQ error

For a full reference on all of the available fields for IBM MQ log messages, see the IBM MQ documentation for JSON format diagnostic messages.

Analyzing IBM MQ as a Service logs

You can set a filter to view logs from IBM MQ by adding the App filter. When you have logs from an IBM MQ service instance you can then select mqcloud in this filter and this will limit your view to only logs from your IBM MQ service instances.

If you want to isolate logs from a particular instance or queue manager you can use the following queries.

message.logSourceCRN can be used to isolate visible logs to a specific service instance. Get the CRN for your service instance and then set this query.

message.logSourceCRN:"<service-instance-crn>"

message.ibm_serverName can be used to filter on the name of your queue manager.

message.ibm_serverName:"QM1"