Quick How To

This logging library makes large use of enterprise correlation. In a lot of applications that incorporate various small and large services, it is often important to correlate events that happen across these services. It gives us a business workflow view of the various events that happen in the application, its components and services. This library provide operation and activity ID management and propagation.

The main difference with this library over other is that you can configure each type of log separately. You can enable fatal, error, warning, debugging, informational, progress and sensitive data logging all independently of each other. This is more flexible than the concept of minimum level logging, such as that in log4net or serilog e.g. enabling one warning in this libraries will enable error and fatal logging as well. This library allows you to set those settings independently of each other.

The SqlLogger maps AdditionalData to table columns, where the key of the dictionary entry is the column name and the value is serialised to JSON as the column value. MetaData is serialised to a single JSON value stored in the MetaData column. This means you can store data such as a User ID or Job ID in a separate column so you can filter more efficiently with indexes and partitions.

TraceLogger and ConsoleLogger both seralise and format all information into a single string. The MultiLogger allows you to configure several different loggers to be used at once with different settings for each logger.

Usage is in the form of: app.config

<?xml version="1.0" encoding="utf-8"?>
<configuration>
	<configSections>
		<section name="LoggerSettings" type="Chinchilla.Logging.Configuration.LoggerSettingsConfigurationSection, Chinchilla.Logging" />
	</configSections>
	<LoggerSettings EnableInfo="true" EnableProgress="false" EnableSensitive="false" EnableDebug="false" EnableWarning="true" EnableError="true" EnableFatalError="true" EnableThreadedLogging="true" ModuleName="MyCompany" Instance="MyApplication" EnvironmentInstance="Server1" Environment="Production" EnableThreadedLoggingOutput="true" UseApplicationInsightTelemetryHelper="false" UsePerformanceCounters="false" SqlDatabaseLogsConnectionStringName="SqlDatabaseLogs.Local" SqlDatabaseTableName="Logs" />
</configuration>

Program.cs

static void Main()
{
  ICorrelationIdHelper correlationIdHelper = new WebCorrelationIdHelper();
  // This value will be set automatically to all logs within this thread... so long as System.Threading.Tasks.Task.Factory.StartNew is used.
  correlationIdHelper.SetCorrelationId(Guid.NewGuid());
  DoSyncWork();
  DoAsyncWork();
}

static void DoSyncWork()
{
  ILogger logger = new SqlLogger();
  logger.LogDebug("Some technical debugging details.");
}

static void DoAsyncWork()
{
  System.Threading.Tasks.Task.Factory.StartNew(() => {
    ILogger logger = new ConsoleLogger();
    logger.LogInfo("An informative message.");
  });
}

The base package installs the Chinchilla.Logging.dll which includes core logging functionality. Other packages depend on Chinchilla.Logging for specific implementations.