Serilog.Destructure.NamedValuesHandler 0.0.2-alpha

Serilog.Destructure.NamedValuesHandler

Work In Progress. No guaranties.

Handles values of structured logs. Can mask or omit values from structured logs

ToDos

• Cover with tests all possible use cases
• Add more examples and use-cases
• Resolve todos in code

Typical Usage

• Mask some sensitive values:

  var logger = new LoggerConfiguration()
      .Destructure
          .HandleValues(p => p
              .MaskStringValue("email")                           // *********
              .MaskStringValue("IBAN", visibleCharsAmount: 6)     // **********************560101
          )
      .CreateLogger();
  

• Completely remove some values:

      var logger = new LoggerConfiguration()
          .Destructure
              .HandleValues(p => p
                  .OmitNames("email", "IBAN")
                  .OmitFromNamespace("Business.Domain.Secured", "System")
                  .OmitOfType(typeof(DestructibleEntity))
              )
          .CreateLogger();
  

• Do your own value modification:

  var logger = new LoggerConfiguration()
                .Destructure
                .HandleValues(p => p
                    .WithNamedValueHandler(
                        "email",
                        (value, type) => $"*****@{value.Split("@").Last()}")) // *****@gmail.com
                .CreateLogger();
  

• Omit by your own rules:

  var logger = new LoggerConfiguration()
      .Destructure
      .HandleValues(p => p
          .WithOmitHandler(
              (name, value, type) => name == "age" && (int)value < 18))
      .CreateLogger();