Summary

• Add StatsdConfig.SynchronousMode option that bypasses the async background worker and sends metrics directly on the calling thread
• Extract IStatsSender interface to enable swapping async/sync implementations
• Rename StatsBufferize to AsynchronousBufferizedSender for clarity
• Suppress the telemetry background timer when synchronous mode is enabled
• Forward exceptions to the configured error handler in synchronous mode; rethrow if no handler is set

Motivation

In AWS Lambda and similar serverless environments, the runtime freezes the sandbox immediately after the handler returns. The DogStatsD client processes metrics on a background thread via AsynchronousWorker, so buffered metrics can be lost when the freeze hits. The existing Flush() method has a hardcoded 3-second timeout and still relies on a background thread to drain the queue — making it fundamentally unreliable in serverless contexts.

SynchronousMode eliminates this class of bugs entirely: no background threads, no async queue, no race with the sandbox freeze. Metrics are routed and serialized on the calling thread, batched into efficient UDP packets via the existing BufferBuilder, and the user calls Flush() at the end of their handler to send any remaining partial buffer.

Usage

var dogstatsd = new DogStatsdService();
dogstatsd.Configure(new StatsdConfig
{
    StatsdServerName = "127.0.0.1",
    SynchronousMode = true,
});

// In Lambda handler:
dogstatsd.Counter("lambda.invocations", 1);
dogstatsd.Flush(); // all metrics sent before handler returns

Test plan

• All existing tests pass with renamed types
• 10 unit tests for SynchronousSender (pool behavior, send/flush, batching, auto-flush on full buffer, dispose triggers flush, thread safety, empty flush, exception forwarding to handler, exception rethrow when no handler)
• 2 builder tests verifying sync mode wiring (skips async CreateAsynchronousBufferizedSender, passes synchronousMode to telemetry)
• 10 integration tests with real UDP listener (counter, gauge, histogram, distribution, timer, set, tags, event, service check, dispose-flush)
• Manual validation in a Lambda environment