Logging/README.md

3.7 KiB

.NET Logging Extensions

This repo contains a Logging extension that when used with the Steeltoe Management Logger Endpoint enables changing the Logging levels for a running application dynamically using the Pivotal Apps manager console.

This logger is simply a wrapper around the Microsoft Console logger, but enables querying and dynamically changing the logging levels of all the currently active loggers.

Windows Master (Stable): AppVeyor Master

Windows Dev (Less Stable): AppVeyor Dev

Linux/OS X Master (Stable): Travis Master

Linux/OS X Dev (Less Stable): Travis Dev

.NET Runtime & Framework Support

Like the ASP.NET Core Logging providers, these providers are intended to support both .NET 4.6+ and .NET Core (CoreCLR/CoreFX) run-times. The providers are built and unit tested on Windows, Linux and OSX.

While the primary usage of the providers is intended to be with ASP.NET Core applications, they should also work fine with UWP, Console and ASP.NET 4.x apps.

Currently all of the code and samples have been tested on .NET Core 1.1, .NET 4.6.x, and on ASP.NET Core 1.1.0.

Usage

See the Steeltoe documentation for information on how to use these components in your applications.

Nuget Feeds

All new configuration provider development is done on the dev branch. More stable versions of the providers can be found on the master branch. The latest prebuilt packages from each branch can be found on one of two MyGet feeds. Released version can be found on nuget.org.

Building Pre-requisites

To build and run the unit tests:

  1. .NET Core SDK

Building Packages & Running Tests - Windows

To build the packages on windows:

  1. git clone ...
  2. cd clone directory
  3. Install .NET Core SDK
  4. dotnet restore src
  5. cd src<project> (e.g. cd src\Steeltoe.Extensions.Logging.CloudFoundry)
  6. dotnet pack --configuration Release or Debug

The resulting artifacts can be found in the bin folder under the corresponding project. (e.g. src\Steeltoe.Extensions.Logging.CloudFoundry\bin

To run the unit tests:

  1. git clone ...
  2. cd clone directory
  3. Install .NET Core SDK
  4. dotnet restore test
  5. cd test<test project> (e.g. cd test\Steeltoe.Extensions.Logging.CloudFoundry.Test)
  6. dotnet xunit -verbose

Building Packages & Running Tests - Linux/OSX

To build the packages on Linux/OSX:

  1. git clone ...
  2. cd clone directory
  3. Install .NET Core SDK
  4. dotnet restore src
  5. cd src/{project} (e.g.. cd src/Steeltoe.Extensions.Logging.CloudFoundry)
  6. dotnet pack --configuration Release or Debug

The resulting artifacts can be found in the bin folder under the corresponding project. (e.g. src/Steeltoe.Extensions.Logging.CloudFoundry/bin

To run the unit tests:

  1. git clone ...
  2. cd clone directory
  3. Install .NET Core SDK
  4. dotnet restore test
  5. cd test<test project> (e.g. cd test/Steeltoe.Extensions.Logging.CloudFoundry.Test)
  6. dotnet xunit -verbose -framework netcoreapp2.0

Sample Applications

See the Samples repo for examples of how to use these packages.