Generating Event Log Entries
Generating Event Log Entries
The Event Log is a table that records events that have occurred in the production running in a given namespace. The Management Portal provides a page that displays this log, which is intended primarily for system administrators, but which is also useful during development.
The primary purpose of the Event Log is to provide diagnostic information that would be useful to a system administrator in case of a problem while the production is running.
InterSystems IRIS automatically generates Event Log entries, and you can add your own entries. Any given event is one of the following types: Assert, Info, Warning, Error, and Status. (The Event Log can also include alert messages and trace items, discussed in the next sections.)
To generate Event Log entries:
-
Identify the events to log.
Not all types of error or activity should necessarily generate Event Log entries. You must choose the occurrences to note, the type to use, and the information to record. For example, Event Log entries should appear in case of an external, physical problem, such as a bad network connection.
The Event Log should not register program errors; these should be resolved before the production is released.
-
Modify the applicable parts of the production (typically business host classes) to generate Event Log entries in ObjectScript, as described in the following subsection.
If you need to notify users actively about certain conditions or events, use alerts, which are discussed in the next section and in Defining Alert Processors.
Generating Event Log Entries in ObjectScript
Within business host classes or other code used by a production, you can generate Event Log entries in ObjectScript. To do so, use any of the following macros. These macros are defined in the Ensemble.inc include file, which is automatically included in InterSystems IRIS system classes:
Macro | Details |
---|---|
$$$LOGINFO(message) | Writes an entry of type Info. Here and later in this table, message is a string literal or an ObjectScript expression that evaluates to a string. |
$$$LOGERROR(message) | Writes an entry of type Error. |
$$$LOGWARNING(message) | Writes an entry of type Warning. |
$$$LOGSTATUS(status_code) | Writes an entry of type Error or Info, depending on the value of the given status_code, which must be an instance of %StatusOpens in a new tab. |
$$$ASSERT(condition) | Writes an entry of type Assert, if the argument is false. condition is an ObjectScript expression that evaluates to true or false. |
$$$LOGASSERT(condition) | Writes an entry of type Assert, for any value of the argument. condition is an ObjectScript expression that evaluates to true or false. |
The following shows an example with an expression that combines static text with the values of class properties:
$$$LOGERROR("Awaiting connect on port "_..Port_" with timeout "_..CallInterval)
The following example uses an ObjectScript function:
$$$LOGINFO("Got data chunk, size="_$length(data)_"/"_tChunkSize)