LoggingModule log = new LoggingModule("logserver", 514);
log.Settings.EnableBackgroundQueue = true;
log.Settings.BatchSize = 100; // Batch up to 100 messages
log.Settings.FlushInterval = 5000; // Force flush every 5 seconds
log.Settings.MaxMemoryEntries = 10000; // Queue up to 10K messages in memory
// Messages are now processed asynchronously in background
for (int i = 0; i < 100000; i++)
{
log.Info($"High-volume message {i}"); // Returns immediately
}
// Ensure all messages are processed before shutdown
await log.FlushAsync();
Persistent Queues
// Messages survive application restarts
log.Settings.EnablePersistentQueue = true;
log.Settings.QueueFilePath = "./logs/message-queue.dat";
log.Critical("This message will be delivered even if app crashes!");
🎯 Multiple Destinations
Syslog + Console + File
List<SyslogServer> servers = new List<SyslogServer>
{
new SyslogServer("primary-syslog", 514),
new SyslogServer("backup-syslog", 514)
};
LoggingModule log = new LoggingModule(servers, enableConsole: true);
log.Settings.FileLogging = FileLoggingMode.FileWithDate; // Creates dated files
log.Settings.LogFilename = "./logs/app.log";
log.Alert("This goes to 2 syslog servers, console, AND file!");
File-Only Logging
LoggingModule log = new LoggingModule("./logs/app.log", FileLoggingMode.SingleLogFile);
await log.InfoAsync("File-only message");
🎨 Console Colors & Formatting
Enable Colors
log.Settings.EnableColors = true;
log.Settings.Colors.Error = new ColorScheme(ConsoleColor.Red, ConsoleColor.Black);
log.Settings.Colors.Warning = new ColorScheme(ConsoleColor.Yellow, ConsoleColor.Black);
Custom Message Format with Rich Variables
// Basic format
log.Settings.HeaderFormat = "{ts} [{sev}] {host}:{thread}";
// Detailed production format
log.Settings.HeaderFormat = "{ts} {host}[{pid}] {sev} [T:{thread}] [{app}]";
// Performance monitoring format
log.Settings.HeaderFormat = "{ts} {host} CPU:{cpu} MEM:{mem}MB UP:{uptime} {sev}";
// Microservices format
log.Settings.HeaderFormat = "{ts} [{app}:{pid}] {sev} [{correlation}] [{source}]";
log.Settings.TimestampFormat = "yyyy-MM-dd HH:mm:ss.fff";
log.Settings.UseUtcTime = true;
Available Header Format Variables
Variable
Description
Example Output
{ts}
Timestamp
2024-01-15 14:30:25.123
{host}
Machine name
web-server-01
{thread}
Thread ID
12
{sev}
Severity name
Info
{level}
Severity number (0-7)
6
{pid}
Process ID
1234
{user}
Current username
john.doe
{app}
Application name
MyWebApp
{domain}
App domain
MyWebApp.exe
{cpu}
CPU core count
8
{mem}
Memory usage (MB)
256
{uptime}
Process uptime
02:45:30
{correlation}
Correlation ID
abc-123-def
{source}
Log source
UserService
🛡️ Input Validation & Safety
All public properties now have comprehensive validation:
The library now includes a complete SyslogServer for testing:
// Start a test syslog server
var serverSettings = new Syslog.Settings
{
UdpPort = 5140,
LogFileDirectory = "./test-logs/"
};
// Use with your logging client
LoggingModule log = new LoggingModule("127.0.0.1", 5140);
await log.InfoAsync("Test message");
// Server automatically logs to file for verification
📈 Performance Metrics
Sync vs Async Performance
// Measure sync performance
DateTime start = DateTime.UtcNow;
for (int i = 0; i < 1000; i++)
{
log.Info($"Sync message {i}");
}
await log.FlushAsync();
DateTime end = DateTime.UtcNow;
double syncMps = 1000.0 / (end - start).TotalSeconds;
// Measure async performance
start = DateTime.UtcNow;
List<Task> tasks = new List<Task>();
for (int i = 0; i < 1000; i++)
{
tasks.Add(log.InfoAsync($"Async message {i}"));
}
await Task.WhenAll(tasks);
await log.FlushAsync();
end = DateTime.UtcNow;
double asyncMps = 1000.0 / (end - start).TotalSeconds;
Console.WriteLine($"Sync: {syncMps:F0} msg/sec, Async: {asyncMps:F0} msg/sec");
