Sentry.Extensions.Logging 1.0.0

Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.

There is a newer version of this package available.
See the version list below for details.
Install-Package Sentry.Extensions.Logging -Version 1.0.0
dotnet add package Sentry.Extensions.Logging --version 1.0.0
<PackageReference Include="Sentry.Extensions.Logging" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Sentry.Extensions.Logging --version 1.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Below you will find a basic introduction to the SDK and its API.

For more details, please: refer to the SDK documentation

Description

Integration of Microsoft.Extensions.Logging with Sentry

Depends on the main Sentry SDK and makes all its features available to use.

Main features

  • BeginScope data added to scope
  • LogInformation or higher added as breadcrumb. Sent with next events.
  • LogError or higher automatically captures an event
  • Strong named

By default, LogError or LogCritical by will send an event to Sentry. That can be configured to any level or disable altogether.

Log messages of level Information or higher will be kept as breadcrumbs and if an event is sent, all breadcrumbs from that transaction are included.

These levels can be configured so that the level you define, tracks breadcrumbs, sends events or completely disable it.

That means that log mesages logged by you or the framework, related to the failed transaction, will be added to the event!

Sample:


 using (var loggerFactory = new LoggerFactory()
            .AddConsole(LogLevel.Trace)
            .AddSentry(o =>
            {
                // Initialize the SDK, alternative to relying on previously called: `using(SentrySdk.Init)`:
                // this is useful when Logging is the first or is the only integration enabled:
                o.Dsn = "https://5fd7a6cda8444965bade9ccfd3df9882@sentry.io/1188141";
                o.MaxBreadcrumbs = 150; // Increasing from default 100

                // Optionally configure options: The default values are:
                o.MinimumBreadcrumbLevel = LogLevel.Information; // It requires at least this level to store breadcrumb
                o.MinimumEventLevel = LogLevel.Error; // This level or above will result in event sent to Sentry
            }))
        {
            var logger = loggerFactory.CreateLogger<Program>();

            logger.LogTrace("1 - By *default* this log level is ignored by Sentry.");

            logger.LogInformation("2 - Information messages are stored as Breadcrumb, sent with the next event.");

            logger.LogError("3 - This generates an event, captured by sentry and includes breadcrumbs (2) tracked in this transaction.");

            using (logger.BeginScope(new Dictionary<string, string>
                {
                    {"A", "some value"},
                    {"B", "more value"},
                }))
            {
                logger.LogWarning("4 - Breadcrumb that only exists inside this scope");

                logger.LogError("5 - An event that includes the scoped key-value (A, B) above and also the breadcrumbs: (2, 4) and event (3)");
            }
        }
    }
}

Below you will find a basic introduction to the SDK and its API.

For more details, please: refer to the SDK documentation

Description

Integration of Microsoft.Extensions.Logging with Sentry

Depends on the main Sentry SDK and makes all its features available to use.

Main features

  • BeginScope data added to scope
  • LogInformation or higher added as breadcrumb. Sent with next events.
  • LogError or higher automatically captures an event
  • Strong named

By default, LogError or LogCritical by will send an event to Sentry. That can be configured to any level or disable altogether.

Log messages of level Information or higher will be kept as breadcrumbs and if an event is sent, all breadcrumbs from that transaction are included.

These levels can be configured so that the level you define, tracks breadcrumbs, sends events or completely disable it.

That means that log mesages logged by you or the framework, related to the failed transaction, will be added to the event!

Sample:


 using (var loggerFactory = new LoggerFactory()
            .AddConsole(LogLevel.Trace)
            .AddSentry(o =>
            {
                // Initialize the SDK, alternative to relying on previously called: `using(SentrySdk.Init)`:
                // this is useful when Logging is the first or is the only integration enabled:
                o.Dsn = "https://5fd7a6cda8444965bade9ccfd3df9882@sentry.io/1188141";
                o.MaxBreadcrumbs = 150; // Increasing from default 100

                // Optionally configure options: The default values are:
                o.MinimumBreadcrumbLevel = LogLevel.Information; // It requires at least this level to store breadcrumb
                o.MinimumEventLevel = LogLevel.Error; // This level or above will result in event sent to Sentry
            }))
        {
            var logger = loggerFactory.CreateLogger<Program>();

            logger.LogTrace("1 - By *default* this log level is ignored by Sentry.");

            logger.LogInformation("2 - Information messages are stored as Breadcrumb, sent with the next event.");

            logger.LogError("3 - This generates an event, captured by sentry and includes breadcrumbs (2) tracked in this transaction.");

            using (logger.BeginScope(new Dictionary<string, string>
                {
                    {"A", "some value"},
                    {"B", "more value"},
                }))
            {
                logger.LogWarning("4 - Breadcrumb that only exists inside this scope");

                logger.LogError("5 - An event that includes the scoped key-value (A, B) above and also the breadcrumbs: (2, 4) and event (3)");
            }
        }
    }
}

Release Notes

Can be found at: https://github.com/getsentry/sentry-dotnet/releases

NuGet packages (4)

Showing the top 4 NuGet packages that depend on Sentry.Extensions.Logging:

Package Downloads
Sentry.AspNetCore
Official ASP.NET Core integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
BusManager
This client library for fork with bus data. Project is opensource. Repository https://github.com/KDEGitHub/BusManager
MariCommands.Sentry
MariCommands integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
WCloud.Framework.Logging
Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
3.0.0-alpha.1 54 10/16/2020
3.0.0-alpha.0 257 9/25/2020
2.2.0-alpha 366 9/19/2020
2.1.6 112,044 8/20/2020
2.1.5 67,119 7/27/2020
2.1.5-beta 1,208 6/30/2020
2.1.4 88,958 6/25/2020
2.1.3 121,916 6/5/2020
2.1.2-beta5 2,301 5/19/2020
2.1.2-beta4 692 5/12/2020
2.1.2-beta3 604 5/7/2020
2.1.2-beta2 2,983 4/16/2020
2.1.2-beta 1,754 3/31/2020
2.1.1 315,785 3/19/2020
2.1.0 139,928 2/24/2020
2.0.3 55,717 2/12/2020
2.0.2 16,165 2/8/2020
2.0.1 50,326 1/28/2020
2.0.0 582 1/28/2020
2.0.0-beta8 17,478 1/15/2020
2.0.0-beta7 64,889 12/17/2019
2.0.0-beta6 73,815 10/31/2019
2.0.0-beta5 4,068 10/29/2019
2.0.0-beta4 37,263 9/4/2019
2.0.0-beta3 14,214 7/26/2019
2.0.0-beta2 3,141 6/9/2019
2.0.0-beta 1,673 6/4/2019
1.2.1-beta 366 5/27/2019
1.2.0 857,516 5/23/2019
1.1.3-beta4 526 5/15/2019
1.1.3-beta3 296 5/13/2019
1.1.3-beta2 1,773 3/28/2019
1.1.3-beta 2,937 2/11/2019
1.1.2 291,625 1/16/2019
1.1.2-beta 1,525 1/8/2019
1.1.1 13,914 1/5/2019
1.1.0 35,790 12/5/2018
1.0.1-beta5 776 12/5/2018
1.0.1-beta4 1,377 12/3/2018
1.0.1-beta3 12,608 11/15/2018
1.0.1-beta2 1,224 11/14/2018
1.0.1-beta 14,642 10/24/2018
1.0.0 153,620 10/2/2018
1.0.0-rc2 19,340 9/7/2018
1.0.0-rc 3,827 8/24/2018
0.0.1-preview5 4,528 8/5/2018
0.0.1-preview4 3,148 7/30/2018
0.0.1-preview3 3,161 7/17/2018
0.0.1-preview2 3,994 7/3/2018
0.0.1-preview1 878 6/28/2018
Show less