Logging extensions

Abstractions module provides a wide set of extensions that take care of constructing log events.

These extensions can be grouped in two ways:

  • By level and name: Debug, Info, Warn, Error, Fatal.

  • By parameters:

    • string:

      • Produces an event with given message template and no properties.

      • log.Info("Hello, world!");

    • string + T:

      • Produces an event with given message template and properties of given object.

      • log.Info("Hello, {Who}!", new { Who = "world" });

    • string + object[]:

      • Produces an event with given message template and given property values (names are inferred from message template).

      • log.Info("Hello, {Who}!", "world");

    • Exception:

      • Produces an event with given exception and no message or properties.

      • log.Error(new Exception());

    • Exception + string:

      • Produces an event with given exception and message template.

      • log.Error(new Exception(), "I have failed.");

    • Exception + string + T:

      • Produces an event with given exception, message template and properties of given object.

      • log.Error(new Exception(), "{Who} have/has failed.", new { Who = "I" });

    • Exception + string + object[]:

      • Produces an event with given exception, message template and given property values (names are inferred from message template).

      • log.Error(new Exception(), "{Who} have/has failed.", "He");

See the section about providing property values to extensions to get a grasp of how to provide values for placeholders in message template.

All extensions produce events with timestamp set to current time and level corresponding to method name.