SplunkHttpTarget.Lib 1.0.1

SplunkHttpTarget.Lib

A production-ready custom NLog target for Splunk HTTP Event Collector (HEC) with comprehensive multi-targeting support.

Features

• 🎯 Multi-targeting support: .NET Framework 4.7.2, .NET 6.0, .NET 8.0
• 🔒 Secure: Uses latest secure versions of all dependencies
• 🚀 Modern: Built with modern NLog APIs and best practices
• 📊 Comprehensive: Full support for Splunk HEC features
• 🔧 Configurable: Extensive configuration options for all environments

Quick Start

Installation

Install-Package SplunkHttpTarget.Lib

or via .NET CLI:

dotnet add package SplunkHttpTarget.Lib

Basic Usage

using NLog;
using NLog.Config;
using SplunkHttpTarget;

// Register the custom target (modern way)
LogManager.Setup().SetupExtensions(s => 
    s.RegisterTarget<SplunkHttpTarget>("SplunkHttp"));

var config = new LoggingConfiguration();

// Create and configure SplunkHttpTarget
var splunkTarget = new SplunkHttpTarget()
{
    Name = "splunk",
    Url = "http://your-splunk-server:8088/services/collector/event",
    HecToken = "your-hec-token-here",
    SourceType = "nlog-custom-target",
    Index = "main",
    ApplicationName = "YourApp",
    ApplicationVersion = "1.0.0",
    Environment = "production"
};

// Add target and rule
config.AddTarget(splunkTarget);
config.AddRuleForAllLevels(splunkTarget);

LogManager.Configuration = config;

// Use logger
var logger = LogManager.GetCurrentClassLogger();
logger.Info("Hello Splunk!");

Configuration via NLog.config

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  
  <extensions>
    <add assembly="SplunkHttpTarget.Lib" />
  </extensions>
  
  <targets>
    <target xsi:type="SplunkHttp" 
            name="splunk"
            url="http://your-splunk-server:8088/services/collector/event"
            hecToken="your-hec-token-here"
            sourceType="nlog-custom-target"
            index="main"
            applicationName="YourApp"
            applicationVersion="1.0.0"
            environment="production" />
  </targets>
  
  <rules>
    <logger name="*" minlevel="Info" writeTo="splunk" />
  </rules>
  
</nlog>

Configuration Properties

Compatibility

• .NET Framework 4.7.2+: Full support with packages.config or PackageReference
• .NET 6.0+: Full support with modern .NET features
• .NET 8.0+: Optimized performance with latest runtime features

Dependencies

• NLog: 6.0.1+ (compatible across all target frameworks)
• System.Text.Json: 9.0.7+ (secure, high-performance JSON serialization)

Security

This package uses only secure, up-to-date dependencies and follows security best practices:

• No vulnerable package versions
• Secure HTTP communication
• Proper input validation and sanitization

License

MIT License - see GitHub repository for details.

Support

For issues, feature requests, or contributions, please visit the GitHub repository.