messages.log (Tools/APIs)
Background Information
InterSystems IRIS® data platform 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.
The directory location of this file is configurable in the CPF file; see ConsoleFile.
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 Setting Up Structured Logging.
Availability: %SYS namespace.
Note
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().
