Logging

Greenrain API uses log4net for logging messages, warning and errors. The following points help understanding how the logging is implemented:

1. Configuration for log4net is described in section Installation Manual.
2. Log files are located in the following folder:
   1. Environment.SpecialFolder.CommonDocuments\Greenrain\MNC Framework\Log.
      1. You can also use Windows Environment Variable CSIDL_COMMON_DOCUMENTS that refers to the file-system directory that contains documents that are common to all users. A typical path is C:\Users\Public\Documents.
      2. In C#, you can use this variable to refer to this folder: Environment.SpecialFolder.CommonDocuments\Greenrain\MNC Framework\Log.
3. Log files names have the following naming convention: Greenrain MNC Framework yyyy-MM-dd.{Process ID}.log, where:
   1. yyyy-MM-dd – current date.
   2. {Process ID} – process id of the running application.
   3. Examples:
      1. Greenrain MNC Framework 2020-08-20.1890.log
      2. Greenrain MNC Framework 2020-08-20.9202.log
      3. Greenrain MNC Framework 2020-08-21.4930.log
4. Logging levels are described in the table below.
5. Recommendation for setting up the logging level:
   1. When debugging, your code set the minimum level to DEBUG, so you get all logging from Greenrain MNC API.
   2. In production, set the logging level to WARN, so you get only Warnings, Errors and Fatal logging messages.