Context
Tracing is a very powerful concept for modern backends and found its way as a basic of observability as logs and metrics are today.
In dotnet, distributed tracing was pushed forward in .NET 6 with the introduction of the System.Diagnostics.Activity APIs in the base class library.
See this article and the official documentation.
Instrumentation was progressively introduced for the most common protocols over the last two years, starting with the HttpClient and following with Grpc.Net.Client (see some example from the source code).
Given the critical place Aerospike spike has in many backends, it would be more than welcome for this client to implement the Activity APIs.
How
The Activity API is quite barebone and gives a lot of freedom as to how to use them. OpenTelemetry (part of the CNCF) proposes some naming conventions, which are already widely adopted by the industry (Grpc.Net.Client uses them).
- The base idea is to create a new
Activity whenever there is an I/O (in the case of retries, it means several Activities will be created).
- Tags must be added to add some information such as: which node was called? What kind of operation is it? What is the key? Is it the first attempt? ...
Activity.Current uses AsyncLocal. It's an important detail to understand how this API works under the hood- In case of error, the ongoing
Activity state must be marked as error
- When there is no listener,
ActivitySource.StartActivity(...) will return null. That means that this won't affect performances in any way if there is no trace/listener ongoing (it will make no difference for people that don't use tracing)
Context
Tracing is a very powerful concept for modern backends and found its way as a basic of observability as logs and metrics are today.
In dotnet, distributed tracing was pushed forward in .NET 6 with the introduction of the
System.Diagnostics.ActivityAPIs in the base class library.See this article and the official documentation.
Instrumentation was progressively introduced for the most common protocols over the last two years, starting with the
HttpClientand following withGrpc.Net.Client(see some example from the source code).Given the critical place Aerospike spike has in many backends, it would be more than welcome for this client to implement the
ActivityAPIs.How
The
ActivityAPI is quite barebone and gives a lot of freedom as to how to use them. OpenTelemetry (part of the CNCF) proposes some naming conventions, which are already widely adopted by the industry (Grpc.Net.Clientuses them).Activitywhenever there is an I/O (in the case of retries, it means several Activities will be created).Activity.CurrentusesAsyncLocal. It's an important detail to understand how this API works under the hoodActivitystate must be marked as errorActivitySource.StartActivity(...)will return null. That means that this won't affect performances in any way if there is no trace/listener ongoing (it will make no difference for people that don't use tracing)