Qyl.Telemetry.SemanticConventions 13.2.0

Qyl.Telemetry.SemanticConventions

The stable OpenTelemetry semantic conventions as .NET constants and typed helpers, generated by Weaver from qyl's registry and shipped pre-built: attribute keys, the pinned SchemaUrl, the qyl-owned scope and event names, typed Activity setter extensions with open value-set structs, first-class metric, span, event and entity definitions, the span starters Qyl.Spans (with Work, RecordFailure) and Qyl.SpanNames, and the trace contract SpanRecord, resource and scope records, StoreIdentity, typed span views and RegistryPolicy.

dotnet add package Qyl.Telemetry.SemanticConventions

using System.Diagnostics;
using Qyl.Telemetry.SemanticConventions;
using Qyl.Telemetry.SemanticConventions.Activities;
using Qyl.Telemetry.SemanticConventions.Attributes.Http;
using Qyl.Telemetry.SemanticConventions.Metrics;

Console.WriteLine(HttpAttributes.RequestMethod);   // http.request.method
Console.WriteLine(SchemaUrl.Current);              // the OpenTelemetry schema this line is generated from

// A metric is an object, not a name constant.
var duration = HttpMetricDefinitions.HttpClientRequestDuration;
Console.WriteLine($"{duration.Name} {duration.Instrument} {duration.Unit}");

// Typed setters on an Activity; an enum attribute takes its value-set struct.
using var activity = new Activity("GET").Start();
activity.SetHttpRequestMethod(HttpRequestMethod.Get);

// A span starter on the application scope: name "write orders", kind Client, domain db.client.
using var span = Qyl.Spans.DbClient(DbSystemName.Postgresql, collectionName: "orders",
    @namespace: "shop", operationName: "write", serverPort: null);

Nothing here reflects: keys are const string, definitions are constructed objects. A consumer publishes NativeAOT clean.

RegistryCatalog.TryGetAttribute(key, out var attribute) looks up stable and incubating value kinds, template expansions, stability and deprecation metadata. TryGetMetric adds the instrument and unit. Unknown custom names return false; they remain valid OpenTelemetry. Required attributes come from the selected signal definition, rather than this catalog.

The siblings

• Qyl.Telemetry.SemanticConventions.Incubating carries every stability tier, the rows the stable tier does not, and the collector's attribute mapping table. The two packages are disjoint for every kind but attributes, so both namespaces can be in scope at once.
• Qyl.Telemetry.SemanticConventions.Analyzers flags deprecated keys, a schema URL mistakenly stored as a resource attribute, and missing required attributes at compile time. An unknown resource schema may remain unset.

More

• The registry, its policies and how generation works: repository README
• Changes per version: CHANGELOG