MPS 2021.1 Help

Logging

The jetbrains.mps.baselanguage.logging  language contains statements for writing arbitrary information into the MPS log as well as to the Messages  tool view panel. The  LogLowLevelStatement concept (aka "log error ...") is used for logging using the system logger, while  MsgStatement (aka "message error...") is used for logging into the  Messages tool window.

Log6

The Messages tool window is located at the bottom of the screen:

Messages tool window

The MPS log file can be quickly navigated to using the menu:

Locate logs

The language supports different severities of log messages:

  • trace

  • info

  • debug

  • warn

  • error

  • fatal

Whenever you want to insert a log statement into code, start by typing either "log" or "message" followed by the desired severity:

Log1

Upon completion the log statement with an empty message will be inserted.

Log2

The severity level can always be changed:

Log3

The log statement also supports exceptions to be specified:

Log4

MsgStatement contains an additional parameter to specify the project:

Log5

When multiple projects are open in MPS at the same time, each project gets its own MPS windows and thus also its own  Messages view. The  project parameter is used to output the log message into the  Messages window of the right project. If you leave the parameter empty, the message will be logged into Messages tool views of all open projects.

Last modified: 08 March 2021