1. Home
  2. Language Guides
  3. .NET
  4. Crash Reporting
  5. .NET Core ILogger

.NET Core ILogger

This package provides a logging provider for the Raygun service. It allows you to send log messages to Raygun, where they can be viewed and managed in the Raygun dashboard.

Installation

Install the Mindscape.Raygun4Net.Extensions.Logging NuGet package into your project. You can either use the below dotnet CLI command, or the NuGet management GUI in the IDE you use.

dotnet add package Mindscape.Raygun4Net.Extensions.Logging

You will need to install the Mindscape.Raygun4Net package as well, if you haven't already.

// If you're using it in an ASP.NET Core application:
dotnet add package Mindscape.Raygun4Net.AspNetCore

// If you're using it in a .NET Core service application:
dotnet add package Mindscape.Raygun4Net.NetCore

Add the Raygun provider to the logging configuration in your Program.cs or Startup.cs file.

using Mindscape.Raygun4Net.AspNetCore;
using Mindscape.Raygun4Net.Extensions.Logging;

var builder = WebApplication.CreateBuilder(args);

// Registers the Raygun Client for AspNetCore
builder.Services.AddRaygun(settings =>
{
  settings.ApiKey = "*your api key*";
});
   
// (Optional) Registers the Raygun User Provider
builder.Services.AddRaygunUserProvider();

// Registers the Raygun Logger for use in MS Logger
builder.Logging.AddRaygunLogger();

var app = builder.Build();

using Mindscape.Raygun4Net.Extensions.Logging;
using Mindscape.Raygun4Net.NetCore;

var builder = Host.CreateApplicationBuilder(args);

// Registers the Raygun Client for NetCore
builder.Services.AddRaygun(options =>
{
  options.ApiKey = "*your api key*";
});

// Registers the Raygun Logger for use in MS Logger
builder.Logging.AddRaygunLogger();

var host = builder.Build();

When registering the Raygun provider, you can configure it with the following options:

Option Description Default Value
MinimumLogLevel The minimum log level for messages to be sent to Raygun. LogLevel.Error
OnlyLogExceptions If false, logs without exceptions will be sent to Raygun. true

These can be set in code:

builder.Logging.AddRaygunLogger(options: options =>
{
  options.MinimumLogLevel = LogLevel.Information;
  options.OnlyLogExceptions = false;
});

Or in the appsettings.json file:

{
  "RaygunSettings": {
    "MinimumLogLevel": "Information",
    "OnlyLogExceptions": false
  }
}

The category/contextSource set as a tag in Raygun.

When logs are sent without an exception, a Custom Data property is added to the Raygun message with the key NullException with the value Logged without exception to identify Raygun Logs that have no exception.

The provider is open source and available at the raygun4net public repository.

On this page: