Lightweight method timing via DispatchProxy. Mark methods with [Timed] and get timing output in DEBUG builds. Pluggable logger, threshold filtering, and ValueTask support.
Get Started
$ dotnet add package Dot.TickReadme
Dot.Tick
Lightweight method timing for .NET using DispatchProxy. Add [Timed] to your implementation methods and get simple, precise timing logs in DEBUG builds with near‑zero overhead in RELEASE.
- Zero impact in Release:
[Timed]isConditional("DEBUG")and is not emitted in Release builds. - Works with sync, Task, Task<T>, ValueTask, and ValueTask<T>.
- Pluggable logger and threshold filtering (
IElapsedLogger,GlobalThreshold). - Simple API: wrap your interface implementation with
DotTickProxy.Create<T>(impl).
Why Dot.Tick?
- You often want basic execution time visibility during development without pulling in heavy AOP frameworks.
- You want a no‑risk Release build: when you ship, the attribute is omitted, so timing code disappears.
- You need async coverage: Tasks and ValueTasks are awaited and measured correctly.
Requirements
- .NET 9.0
- Methods must live on a type that implements an interface. You create a proxy for that interface and call through it.
Install
Install from NuGet:
PM> Install-Package Dot.Tick
# or
> dotnet add package Dot.Tick
Quick start
public interface ICalculator
{
int Add(int a, int b);
Task<int> DelayAddAsync(int a, int b, int delayMs);
}
public class Calculator : ICalculator
{
[Timed]
public int Add(int a, int b) => a + b;
[Timed]
public async Task<int> DelayAddAsync(int a, int b, int delayMs)
{
await Task.Delay(delayMs);
return a + b;
}
}
var calc = DotTickProxy.Create<ICalculator>(new Calculator());
var sum = await calc.DelayAddAsync(1, 2, 10);
In DEBUG builds you will see console output like:
[Dot.Tick] Namespace.Calculator.DelayAddAsync took 10.123 ms
Failures include a suffix:
[Dot.Tick] Namespace.Calculator.FailSync took 0.642 ms (failed)
ASP.NET Core (DI) example
Register a proxied service in your service container:
builder.Services.AddSingleton<ICalculator>(sp => DotTickProxy.Create<ICalculator>(new Calculator()));
Then inject and use ICalculator as usual in your endpoints/controllers. In DEBUG, timed methods will log to the console output.
Configuration
You can configure Dot.Tick globally. Defaults: enabled in DEBUG, console logger, no threshold.
DotTick.Configure(o =>
{
o.GlobalThreshold = TimeSpan.FromMilliseconds(5); // only log when >= 5ms
o.Logger = new MyStructuredLogger(); // plug your own logger
o.Enabled = true; // enable/disable at runtime (DEBUG only)
});