Semantic Logging Application Block (SLAB) v2.0.1406.1 Release Notes

Release Date: 2015-01-30 // about 6 years ago
  • πŸš€ Release Notes

    ⚑️ Updated July 3 2014

    πŸš€ Welcome to the official release of SLAB 2.0!

    πŸ“š This document contains a brief summary of the block, including late-breaking information that is not included in the main documentation.

    Where to get it?

    πŸ“¦ Via NuGet – use the NuGet Package Manager in Visual Studio and search online for the β€œsemantic logging” packages.

    πŸš€ The official packages for this release include:

    πŸš€ What’s New in this Release?

    πŸš€ This major release of the Semantic Logging Application Block, with some potential breaking changes.

    • ♻️ Refactored all sources to be IObservable<EventEntry> instead of sink-specific representations.
    • βž• Added support for process and thread id (only when app is running in full trust):
      • Values are captured and stored in all destinations.
    • βž• Added support for configuring sampling and process filters when running out of process
      • Sampling is configured using a general-purpose key/value pair collection. You need to know the same keys and value conventions as when doing sampling in process. Other keys and values can be supplied, as with in process, but these are interpreted by the sources and might have consequences that need to be acknowledged.
      • Process filters now let you get events only from specific processes (specified by name)
    • πŸ‘Œ Improved compatibility with the EventSource nuget package
      • SLAB's source must be updated and rebuilt to work with the EventSource nuget package (which supports channels, but does not support sampling). The process is now fairly painless.
      • Added references to the EventSource nuget package to all projects
      • Changed System.Diagnostics.Tracing to Microsoft.Diagnostics.Tracing in all source files
      • Defined the EVENT_SOURCE_PACKAGE constant in the unit test project (to disable tests that cannot possibly work with the nuget version).
    • πŸ‘Œ Improved the StyleCop integration
    • βž• Added notification for out of band events. Events with id 0 are not part of the manifest for an EventSource. Instead they are used to communicate back to the consumer of the events. Notification is made for these with a new event through the SLAB event source.
    • πŸ‘ Allowed the out of process service to be installed as an account other than LocalService.
      • Consuming ETW events requires access to the performance group. Rather than forcing the admin to include LocalService in this group, give the ability to install to a different account.
    • πŸ“¦ Sinks and EventSource analyzer have been moved into separate nuget packages, leaving the core agnostic.
    • The Elasticsearch sink is no longer maintained by p&p. It is now a pure community project.

    Acknowledgements

    Development team: Christopher Bennage, RoAnn Corbisier, Nelly Delgado, Carlos Farre, Grigori Melnik, Fernando Simonazzi, Mani Subramanian, Veerapat Sriarunrungrueang (Adecco)
    Subject matter experts: Vance Morrison, Cosmin Radu
    Community contributors: http://aka.ms/entlib-contributors

    Providing feedback and contributing

    We would appreciate feedback on any issues found, or any other general comments.
    πŸ‘€ See CONTRIBUTING.md in the root of the repository for more details.
    We look forward to your pull requests!

    πŸ‘Œ Support

    🌲 Semantic Logging is not an officially supported product. However, please feel free to ask questions. Customers can obtain support through Microsoft Premier Support Services for a fee, but the code is considered user-written by Microsoft support engineers.