.NET Error: Logging

The error logging module is designed to log information and error messages to a file, so that error causes may be analyzed for rather complicated processes, such as the process to build a component that can be hosted with the CIMPLICITY environment.

The logging process is controlled by a logging configuration file named GEIP.Orion.ComponentsLogger.config in the ..\<CIMPLICITY Installation>\exe folder.

GEIP.Orion.ComponentsLogger.config has the following typical content:

<?xml version="1.0" encoding="utf-8" ?>
<log4net debug="true">
????<appender name="RollingLogFileAppender" type="log4net.Appender.RollingFileAppender">
????????<file value=".\\DotNet Components\\ComponentsLogger.log" />
????????<appendToFile value="true" />
????????<rollingStyle value="Size" />
????????<maxSizeRollBackups value="10" />
????????<maximumFileSize value="10MB" />
????????<staticLogFileName value="true" />
????????<layout type="log4net.Layout.PatternLayout">
????????????<conversionPattern value="%d [%t] %-5p %logger %method%n%m%n" />
????????</layout>
????</appender>
????<root>
????????<level value="WARN" />
????????<appender-ref ref="RollingLogFileAppender" />
????</root>
</log4net>
  • Items may be easily changed are the:
  • Logging file path.
  • Logging level.
  • The content above sets the path to ..\<CIMPLICITY Installation>\exe\DotNet Components\ComponentsLogger.log.
  • Levels include:
  • DEBUG
 Logs everything
  • INFO
  • WARN
  • ERROR
  • FATAL
 Log successively fewer messages

Refer to the log4net document for more details.

  • The logging actions are mostly performed at the configuration mode and have no significant performance panelties even if the logging level is set to DEBUG.