Customize .NET agent dynamic logs for logger integration¶

This guide describes how to customize Lightrun logs to align with your application's logger format. Lightrun supports the integration of dynamic logs into your application's existing logs, maintaining the application’s log format and structure. If your application is configured to send logs to log management tools such as Kibana or New Relic, you can also include dynamic logs in real-time during runtime. These dynamic logs will be piped to those tools along with your application's static logs. For more information, see Dyanmic Logs Overview.

Before you begin¶

• Keep in mind that later, when creating Lightrun logging actions, you will need to ensure that the Target for the Lightrun action(s) includes Stdout.

  

Set up the custom dynamic logger¶

To configure a custom dynamic logger, add the CustomDynamicLogger property, which is of type IDynamicLogger.

public interface IDynamicLogger
{
    void Log(LogEntry entry);
}

The IDynamicLogger interface consists of a single method, Log, which takes a LogEntry parameter containing the severity of the log entry and the corresponding message.

By implementing this interface and passing the implementation object to the CustomDynamicLogger property, you can seamlessly integrate support for any logging library.

Configure the dynamic logger with Log4Net¶

You can set up a Log4Net instance as a custom dynamic logger for the Lightrun .NET agent. The LogManager is a class from Log4Net to request logger instances. Log4NetLogger is a function from the Lightrun agent that creates the IDynamicLogger instance from a Log4Net ILog instance.

// Get the logger instance.
// It's assumed that the Log4Net logger is already configured by this time.
var lightrunLogger = LogManager.GetLogger("LIGHTRUN");

var options = new AgentOptions
{
    // ...
    // other options
    // ...
    CustomDynamicLogger = Log4NetLogger(lightrunLogger)
};

LightrunAgent.Start(options);

Configure the dynamic logger with Serilog¶

You can set up a Serilog logger instance as a custom dynamic logger for the Lightrun .NET agent. SerilogDynamicLogger function accepts Serilog.ILogger instance, and creates the IDynamicLogger instance from it.

// The Serilog logger must be set up before starting the agent.
// The next line is just an example of initializing a simplest Serilog global logger instance.
Log.Logger = new LoggerConfiguration().WriteTo.Console().CreateLogger();

var options = new AgentOptions
{
    // ...
    // other options
    // ...
    CustomDynamicLogger = SerilogDynamicLogger(Log.Logger)
};

LightrunAgent.Start(options);