Zacanbot.ElasticLogger 1.2.3

Dotnet Elasticsearch and Console Logger

A simple and easy-to-use implementation of the standard Microsoft.Logging.Extentions.ILogger interface that outputs to Console and Elasticsearch. It logs UTC timestamps instead of local time.

Elasticsearch needs to be installed with TLS security enabled (the default since v8). This library uses the default user elastic to connect. Get an Elasticsearch instance started easily with Docker Compose by following the official guide here: https://www.elastic.co/blog/getting-started-with-the-elastic-stack-and-docker-compose.

Example usage in an ASP.Net app

Register the logger in Program.cs (or Startup.cs):

using Zacanbot.ElasticLogger;

var builder = WebApplication.CreateBuilder(args);

// Add Elasticsearch and Console logger
builder.Logging.ClearProviders();
builder.Logging.AddElasticLogger(config =>
{
  config.ElasticUrl = "https://localhost:9200";
  config.ElasticPassword = "elastic";
  config.DefaultIndex = "aspnet_logs";
});

Use it like any other ILogger in your controller:

public class MyController : ControllerBase
{
  private readonly ILogger<MyController> _logger;

  public MyController(ILogger<MyController> logger)
  {
    _logger = logger;
  }

  [HttpGet("PingHello")]
  public string PingHello()
  {
    _logger.LogInformation("Received a Ping request");
    return "hello";
  }
}

Example usage in a Console app (Factory method)

using Microsoft.Extensions.Logging;
using Zacanbot.ElasticLogger;

var logger = LoggerFactory.Create(builder =>
{
  builder.ClearProviders();
  builder.SetMinimumLevel(LogLevel.Debug);
  builder.AddElasticLogger(config =>
  {
    config.ElasticUrl = "https://localhost:9200";
    config.ElasticPassword = "elastic";
    config.DefaultIndex = "test_logs";
  });
}).CreateLogger("Program");

logger.LogInformation("Info Log");
logger.LogWarning("Warning Log");
logger.LogError("Error Log");
logger.LogCritical("Critical Log");

Console.WriteLine("\nPress any key to exit");
Console.ReadLine();

Example usage in a Console app (Host with DI method)

using Zacanbot.ElasticLogger;

var host = Host.CreateDefaultBuilder(args)
.ConfigureLogging((_, logging) =>
{
  logging.ClearProviders();
  logging.AddElasticLogger(config =>
  {
    config.ElasticUrl = "https://localhost:9200";
    config.ElasticPassword = "elastic";
    config.DefaultIndex = "test_logs";
  });
});
var app = host.Build();

ILogger? logger = app.Services.GetService<ILogger<Program>>();
if (logger != null)
{
  logger.LogInformation("Info Log");
  logger.LogWarning("Warning Log");
  logger.LogError("Error Log");
  logger.LogCritical("Critical Log");
}
Console.WriteLine("\nPress any key to exit");
Console.ReadLine();