Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://github.com/purview-dev/purview-telemetry-sourcegenerator/wiki/./Metrics below:

Metrics · kjldev/purview-telemetry-sourcegenerator Wiki · GitHub

The types are hosted within the Purview.Telemetry.Metrics namespace, with the exception of the TagAttribute which is defined within Purview.Telemetry.

To signal an interface for meter target generation, decorate the interface with the MeterAttribute. If the MeterAttribute.Name is not specified, the name of the interface, without the first 'I', will be used. For example ICacheServiceTelemetry would become CacheServiceTelemetry.

When creating the meter types, the IMeterFactory is used by default.

During the initialisation of the class you can implement a partial method used to provide additional tags to any meters created by the IMeterFactory.

The signature is: partial void PopulateMeterTags(System.Collections.Generic.Dictionary<string, object?> meterTags). You can add you custom tags to the meterTags to enable all meters created to include these tags.

There are several supported instrument types: counter, histogram, up-down counter, observable counter, observable gauge and observable up-down counters. Each are determined by the corresponding attribute:

• AutoCounterAttribute and CounterAttribute generates the Counter<T> instrument.
• HistogramAttribute generates the Histogram<T> instrument.
• UpDownCounterAttribute generates the UpDownCounter<T> instrument.
• ObservableCounterAttribute generates the ObservableCounter<T> instrument.
• ObservableGaugeAttribute generates the ObservableGauge<T> instrument.
• ObservableUpDownCounterAttribute generates the ObservableUpDownCounter<T> instrument.

The measurement type used by the meter must be one of the following: byte, short, int, long, float, double, or decimal.

This is determined by decorating the desired parameter with the InstrumentMeasurementAttribute. When generating an auto-increment counter, the instrument measurement value is automatically created. Therefore an error diagnostic will be raised if one is included.

Inferring the instrument measurement value is supported in the following cases:

For CounterAttribute (when AutoIncrement is false), HistogramAttribute and UpDownCounterAttribute where the first parameter is used matching the requirement measurement types and not defined as a tag or baggage.

Additionally, ObservableCounterAttribute, ObservableGaugeAttribute and ObservableUpDownCounterAttribute measurement parameter inferring is supported when a corresponding Func<T>, Func<Measurement<T>> or Func<IEnumerable<Measurement<T>>> is found.

All of these counter types require a measurement parameter, except for the counter when AutoCounterAttribute is present, or CounterAttribute.AutoIncrement is set to true.

If a measurement parameter is not defined, the first parameter with a matching type is used.

When using AutoCounterAttribute or CounterAttribute.AutoIncrement, the meter increments by one each time the method is called.

Observable meter types must always have a System.Func<T> with one of the supported instrument types.

However, you may also use Measurement<T> where T is one of the support instrument types.

You can provide multiple values at once using IEnumerable<Measurement<T>>, again T must be one of valid measurement types.

Examples:

[ObservableCounter]
void Counter(Func<int> func);

[ObservableGauge]
void Gauge(Func<Measurement<int>> func);

[ObservableUpDownCounter]
void UpDownCounter(Func<IEnumerable<Measurement<int>>> func);

Other parameters on the method can be used as tags. This is implicit for non-measurement values, but can also be explicitly set to control generation through the use of the TagAttribute.

Defines and controls the generation of meters and instruments on an interface, overriding any assembly level defaults.

Controls defaults of meter and instrument generation at the assembly level.

Defines the parameter used as the instrument measurement value. Not supported when using AutoCounterAttribute or when CounterAttribute.AutoIncrement is true.

The following attributes are used on methods to define the type of instruments to generate.

Used to create a Counter<T> meter, where T is an int.

This is the equivalent of using the CounterAttribute and setting AutoIncrement to true.

When specifying an [InstrumentMeasurementAttribute] on a parameter, the TSG4002 diagnostic is raised.

Used to create a Counter<T> meter.

When AutoIncrement is true and an [InstrumentMeasurementAttribute] is used on a parameter, the TSG4002 diagnostic is raised.

Used to create a Histogram<T> meter.

Used to create a UpDownCounter<T> meter.

Used to create a ObservableUpDownCounter<T> meter.

Used to create a ObservableGauge<T> meter.

Used to create a ObservableUpDownCounter<T> meter.

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4