Log files

There are various system logs that you can use to help with problem determination and troubleshooting. You can set the logging level, change the log location, and view log location information by using REST Administration APIs.

There are five different log files available:
imaserver-default.log
This log file shows all log entries about the operation of the server. High severity entries that are shown in other logs are also logged in this log.
imaserver-connection.log
This log file shows log entries that are related to connections. These entries can be used as an audit log for connections, and also indicates errors with connections.
imaserver-admin.log
This log file shows log entries that are related to running administration commands. It records all changes to the configuration of the server, and attempted changes.
imaserver-security.log
This log file shows log entries that are related to authentication and authorization. This log can be used as an audit log for security-related items.
imaserver-mqconnectivity.log
This log file shows log entries that are related to MQ Connectivity function. These entries include problems found connecting to queue managers. The log can help with diagnosing problems in connecting Eclipse Amlen to IBM® MQ.

If you are using an Eclipse Amlen RPM on a host OS, the log files are in /var/messagesight/diag/logs

If you are using Eclipse Amlen in a Docker container, identify the volume mounts that were used when you issued the Docker run command. For example, issue the following command:

# docker inspect IMA | grep -A 12 Mounts    
"Mounts": [
{            
"Source": "/data/messagesight/var",            
"Destination": "/var/messagesight",            
"Mode": "",            
"RW": true
},
{
"Source": "/data/messagesight/tmp",
"Destination": "/var/tmp",
"Mode": "",
"RW": true
}
The log files are located at the location that is the first mount location suffixed with a relative path of diag/logs. In the example, the location of the log files is /data/messagesight/var/diag/logs

For more information about log files, see Configuring log files.

When troubleshooting Eclipse Amlen, you might be required to change the logging levels to log the messages that indicate the cause of the problem. For information about setting the log levels, see Setting the logging level.