Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
91 lines (67 sloc) 5.86 KB
.. rst-class:: hideheader

Welcome to NuLog's Documentation!

.. rst-class:: center

sitetitle.png


NuLog is a Tag-Based Logging Framework

NuLog is a logging framework built for .NET, which uses tags to route log messages, instead of log levels. It is simple, and performant, and highly extensible. It is the next generation of logging.

Quick Start - Get Started

Get started now: :ref:`gettingstarted`.

Dependencies and Requirements

The core NuLog library has no external dependencies and requirements, as a matter of rule. Extension libraries for NuLog may have their own dependencies, as needed.

See our :ref:`arch_princ` for more information.

License - MIT

NuLog is licensed with the MIT license, and copyleft licenses (and libraries with those licenses), such as GPL, are strictly prohibited by our :ref:`arch_princ`.

Source Code Repository

NuLog is hosted on GitHub.

Martin's First Law of Documentation

Produce no document unless its need is immediate and significant.

We feel that the best form of documentation for a software project, are well written business driven tests.

Head over to GitHub to look through the unit and integration tests for the project.

What's Changed From Version 1

Please be aware: this is a ground-up rewrite of NuLog, so only the high-level concepts and architectural pattern have been kept. This is a full-on breaking change, which is why the version number has been advanced to 2.X.

Much of the functionality of version 1 has been rebuilt into version 2. However, the functionality has been simplified, and some features were deprecated, and not brought over. Here's a quick overview of what's changed:

  • Runtime Config Helpers - The runtime config helpers haven't been built into version 2. This doesn't mean they won't be added in the future, but that they just haven't been needed yet.
  • MEF Deprecated - MEF, while quite powerful, also leads to obfuscating functionality from the developer, which could lead to unexpected behavior (from the developer's perspective). The rewrite of the framework allows for easier extension, using the Dependency Inversion Principle, and MEF is no longer needed.
  • Static Meta Data Providers Deprecated - The static meta data providers haven't been shown to be needed yet. They don't conflict with the new philosophy of NuLog, but are an example of complexity that hasn't been shown to be necessary yet, so they haven't been ported over - at least yet. We still have static meta data avaialble, through the NuLog configuration, however. See :ref:`staticmetadata` for more information.
  • Configuration Changed from JSON to use standard XML-based config - To better support standard CI processes, and to simplify the management of the configuration of the framework, the configuration has been moved away from a custom JSON based mechanism, to leverage the built-in configuration management. The configuration is now stored as a custom configuration section, right in the app/web config files.
  • Legacy Logging Extension Deprecated - If neccessary, we can build this out as a separate package, but NuLog is a new approach to logging, and we encourage organizations to make the transition towards tag-based logging, as opposed to just emulating level-based logging, using a tag based framework.
  • Configuration Extenders Deprecated - Another example of complexity that isn't yet necessary - the configuration extenders haven't been ported over. Again, if the need presents, we can build this out.
  • Target Configuration Simplified - Target configuration has been simplified to a name, type and then a series of key/value pairs for configuration. The complexity of the previous targets was unneccessary. If needed, we can extend the target configuration to support storing the original XML configuration as a part of the TargetConfig class, but we'll refrain from adding this, until it is needed.
  • Target Lifecycle Simplified - Targets no longer are concerned with managing their own message queue. The previous version of NuLog maintained a queue both in the dispatcher, and in each target. Having queues in both places added complexity, but didn't add any convenience or performance. The new version only has a queue in the dispatcher, targets are now "single threaded" in terms of lifecycle. This does not prevent you from building your own custom targets that are internally asynchronous, if needed.
  • Observer Pattern for Configuration Removed - The observer pattern for the previous system has been removed. Changes to the web configuration are handled in IIS by performing a blue/green recycle of the application, removing the need to "watch" the configuration for changes.

.. toctree::
   :maxdepth: 2
   :caption: User Documentation

   user_documentation/gettingstarted
   user_documentation/configuration/configtemplate
   user_documentation/configuration/generalsettings
   user_documentation/configuration/rules
   user_documentation/configuration/taggroups
   user_documentation/configuration/staticmetadata
   user_documentation/configuration/standardlayout
   user_documentation/targets
   user_documentation/advancedusage

.. toctree::
   :maxdepth: 2
   :caption: Customizing NuLog

   customizing_nulog/architecture
   customizing_nulog/customtargets
   customizing_nulog/logfactman
   customizing_nulog/extendstandardlogfact

.. toctree::
   :maxdepth: 2
   :caption: Additional Information

   introtologging
   intrototaglogging
   license
You can’t perform that action at this time.