Skip to content

.NET Framework library for asynchronous logging to Splunk using HTTP collector.

License

Notifications You must be signed in to change notification settings

agero-core/splunk-logger-async

Repository files navigation

Async Splunk Logger

NuGet Version NuGet Downloads

Async Splunk Logger is a .NET Framework (>= v4.6.1) library for logging to Splunk using HTTP collector asynchronously. It has in-memory queue and runs background threads to pick logs from queue and submit them to Splunk using Splunk Logger library.

Usage:

Create instance:

IAsyncLogger logger = 
    new AsyncLogger(
        collectorUri: new Uri("<Your Splunk Collector Url>"),
        authorizationToken: "<Your Splunk Access Token>",
        applicationName: "TestName",
        applicationVersion: "1.2.3.4",
        timeout: 3000,
        processingThreadCount: 2);

Create log:

logger.Log(
    type: "TestInfo", 
    message: "Test message", 
    data: new { test1 = "test1", test2 = "test2" },
    correlationId: "1234567");	

This creates the following log in Splunk:

{  
   "type":"TestInfo",
   "name":"TestName",
   "version":"1.2.3.4",
   "message":"Test message",
   "system":{  
      "userName":"DomainName\\user",
      "userDomainName":"DomainName",
      "operatingSystem":"Unix 18.2.0.0",
      "is64BitOperatingSystem":true,
      "processorCount":4,
      "clrVersion":"4.0.30319.42000",
      "is64BitProcess":false,
      "machineName":"MACHINE-NAME",
      "localTime":"2017-08-16T14:43:07.7658829-04:00",
      "utcTime":"2017-08-16T18:43:07.7668831+00:00",
      "hostName":"MACHINE-NAME",
      "ipAddresses":[  
         "123.123.1.0"
      ]
   },
   "app":{  
      "test1":"test1",
      "test2":"test2"
   },
   "correlationId": "1234567"
}

Running Tests:

Create the json file logger-settings.json with the below configuration under the projects Agero.Core.SplunkLogger.Async.Tests and Agero.Core.SplunkLogger.Async.Web.

{
  "splunkCollectorUrl": "<Your Splunk Collector Url>",
  "authenticationToken": "<Your Splunk Access Token>"
}

About

.NET Framework library for asynchronous logging to Splunk using HTTP collector.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published