Error Logging - Enable Logging via ST_CONFIG

<< Click to Display Table of Contents >>

EQuIS 7  >>  Configuration > ST_CONFIG Entries >

Error Logging - Enable Logging via ST_CONFIG

The log4net.config comes pre-configured for the AdoNetAppender enabled with logging level set to Off. No other appenders are configured. When this ST_CONFIG entry is absent or the string_value represents a UTC date and time in the past, no logging will be performed. By setting the string_value to a UTC date and time in the future, logging will be enabled and sent to the ST_LOG table. This arrangement removes the need for access to the application server to enable logging.

 

Note: There is no option to set the logging level, it is either Off or All.

 

Namespace: EarthSoft.EDP

 

Products Affected: Enterprise Web Application and Enterprise Workflow Service

 

Requires Module: log4net

 

ST_CONFIG

VALUE

REMARK

VALID VALUES

CONFIG_SECTION

log4net


Required

CONFIG_KEY

AdoNetAppender


Required

OBJECT_TYPE

EnabledUntil


Required

OBJECT_VALUE

Utc


Required

STRING_VALUE

<date time string>

Invalid strings will disable logging.

Any string value that can be parsed

by System.DataTime.TryParse

 

Remarks: When no time zone information is provided, the time is assumed to be the local time of the application server. In the following example, if the application server is hosted on the East Coast of the United States, then logging would continue until 4:30pm.

 

Example: Enable logging until 8:30 p.m. on April 22, 2016 UTC.

 

config_section

config_key

object_type

object_value

string_value

log4net

AdoNetAppender

EnabledUntil

Utc

2016-03-22T20:30-00:00

 

To configure log4net.config to log to the server, see Error Logging - Enable Rolling Log File on the Server.