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 IBM® IoT MessageSight to IBM MQ.
If you are using an IBM IoT MessageSight RPM on a host OS, the log files are in /var/messagesight/diag/logs
If you are using IBM IoT MessageSight 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 IBM IoT MessageSight, 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.