A Serilog sink that writes events to the NewRelic Logs.

Deprecated

Version 1.2.2 is the last version built from this repository. This repository will no longer be maintained. Please use @ThiagoBarradas fork which adds support for .NET Core 3.1

Getting started

Optionally configure NewRelic settings:

  <appSettings>
    <add key="NewRelic.AppName" value="Serilog.Sinks.NewRelic.Sample"/>
  </appSettings>

Point the logger to NewRelic Logs:

Log.Logger = new LoggerConfiguration()
    .WriteTo.NewRelicLogs(endpointUrl: "https://log-api.newrelic.com/log/v1", applicationName: "Serilog.Sinks.NewRelic.Sample", licenseKey: "[Your API key]")
    .CreateLogger();

The available parameters are:

• applicationName of the current application in NewRelic If the parameter is omitted, then the value of the "NewRelic.AppName" appSetting will be used.
• endpointUrl is the ingestion URL of NewRelic Logs. The US endpoint is used by default if this value is omitted.
• licenseKey is the NewRelic License key, which is also used with the NewRelic Agent.
• insertKey is New Relic Insert API key. Either 'licenseKey' or 'insertKey' must be supplied.
• formatProvider supplies culture-specific message formatting information, or null.

The events are submitted to NewRelic Logs in batches, and the sink is derived from PeriodicBatchingSink. It therefore supports the following parameter:

• batchSizeLimit is the maximum number of events to include in a single batch. Default is 1000 entries
• period is the time to wait between checking for event batches. It is TimeSpan with a default value of 2 seconds. If provided from AppSettings, the value should be given as an absolute time span, i.e.: "0.00:00:05" standing for 5 seconds.

The batches are formatted using NewRelic Logs detailed JSON body and are transmitted GZip-compressed.

All properties along with the rendered message will be emitted to NewRelic Logs. This sink adds four additional properties:

• timestamp in milliseconds since epoch
• application holds the value from applicationName or from NewRelic.AppName appSetting
• level is the actual log level of the event.
• stack_trace holds the stack trace portion of an exception.

If newrelic.linkingmetadata property is present in an event, it will be unrolled into individual NewRelic properties used for "logs in context".