messages.log (Tools/APIs)
Background Information
InterSystems IRIS reports general messages, system errors, certain operating system errors, and network errors through an operator console facility. On Windows, there is no operator console as such and all console messages are sent to the messages.log file in the InterSystems IRIS system manager directory (install-dir/mgr). For InterSystems IRIS systems on UNIX® platforms, you can send operator console messages to the messages.log file or the console terminal.
For more information, see “Monitoring Log Files” in the chapter “Monitoring InterSystems IRIS Using the Management Portal” in the Monitoring Guide.
The directory location of this file is configurable; see the ConsoleFile entry in Configuration Parameter File Reference.
Available Tools
Provides the WriteToConsoleLog() method, which you can use to write to the messages.log file.
Availability: All namespaces.
Provides the ModifyConsoleFile() method.
Availability: All namespaces.
Enable you to set up structured logging, which will write the same messages seen in messages.log to a machine-readable file that can be ingested by your choice of monitoring tool. See the article “Setting Up Structured Logging.”
Availability: %SYS namespace.
Reminder
The special variable $SYSTEM is bound to the %SYSTEM package. This means that instead of ##class(%SYSTEM.class).method(), you can use $SYSTEM.class.method().
