AutoInstrument 1.0.0

AutoInstrument

[Instrument] for .NET - add an attribute, get OpenTelemetry spans with tagged parameters at every call-site. Inspired by Rust's #[instrument].

[Instrument]
public async Task<string> ShaveYak(int yakId, string style)
{
    await Task.Delay(50);
    return $"Yak #{yakId} shaved with {style}";
}

Under the hood, the source generator emits C# interceptors that wrap each call-site with an Activity, tag parameters, and record exceptions. Your method is never modified.

Setup

Add the package and enable interceptors:

<PropertyGroup>
  <InterceptorsNamespaces>$(InterceptorsNamespaces);AutoInstrument.Generated</InterceptorsNamespaces>
</PropertyGroup>

using AutoInstrument;

[Instrument]
public async Task<Order> ProcessOrder(int orderId, string customer) { ... }

[Instrument(Skip = new[] { "creditCard" })]
public async Task ChargeCustomer(int orderId, string creditCard) { ... }

[Instrument(Name = "orders.compute_total", RecordReturnValue = true)]
public decimal ComputeTotal(List<LineItem> items) => items.Sum(i => i.Price * i.Quantity);

Options

Skip and Fields support dot-notation for complex type properties: Skip = new[] { "order.CreditCard" }.

Parameter attributes

[NoInstrument] on a parameter skips it from tagging. Pass property names to skip specific properties of a complex type:

public void Login(string user, [NoInstrument] string password) { ... }

public void Process([NoInstrument("CreditCard", "SSN")] Order order) { ... }

Member tags

[Tag] on a field or property includes it as a span tag on all [Instrument] methods in the class:

public class OrderService
{
    [Tag] public string Region { get; set; }
    [Tag(Name = "env")] public string Environment { get; set; }

    [Instrument]
    public void Process(int orderId) { ... }
    // Tags: process.orderid, region, env
}

Complex types

Classes and structs are expanded one level deep into their public properties:

[Instrument]
public void Process(Order order, int priority) { ... }
// Tags: process.order.id, process.order.customer, process.order.creditcard, process.priority

Configuration

The ActivitySource name defaults to the assembly name. Override at three levels (highest priority wins):

1. Per-method: [Instrument(ActivitySourceName = "X")]
2. MSBuild: <AutoInstrumentSourceName>X</AutoInstrumentSourceName>
3. Assembly attribute: [assembly: AutoInstrumentSource("X")]

Tag naming defaults to methodname.param. Set it to Flat for just param:

[assembly: AutoInstrumentConfig(TagNaming = TagNamingConvention.Flat)]

Or via MSBuild: <AutoInstrumentTagNaming>Flat</AutoInstrumentTagNaming>

Diagnostics

Limitations

• Interceptors only work within the same compilation — cross-project calls aren't intercepted.
• Recursive calls create nested spans.
• Complex types expand one level deep only.

Requirements

.NET 10

License

MIT