HistogramAttribute Class

Definition

Namespace:

Microsoft.Extensions.Diagnostics.Metrics

Assembly:

Microsoft.Extensions.Telemetry.Abstractions.dll

Package:

Microsoft.Extensions.Telemetry.Abstractions v9.0.0-preview.9.24507.7

Provides information to guide the production of a strongly typed histogram metric factory method and associated type.

public ref class HistogramAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method)]
[System.Diagnostics.Conditional("CODE_GENERATION_ATTRIBUTES")]
public sealed class HistogramAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method)>]
[<System.Diagnostics.Conditional("CODE_GENERATION_ATTRIBUTES")>]
type HistogramAttribute = class
    inherit Attribute

Public NotInheritable Class HistogramAttribute
Inherits Attribute

Inheritance

Object

Attribute

HistogramAttribute

Attributes

AttributeUsageAttribute ConditionalAttribute

Examples

static partial class Metric
{
    [Histogram("RequestName", "RequestStatusCode")]
    static partial RequestLatency CreateRequestLatency(Meter meter);
}

Remarks

This attribute is applied to a method that has the following constraints:

• Must be a partial method.
• Must return metricName as the type. A class with that name will be generated.
• Must not be generic.
• Must have System.Diagnostics.Metrics.Meter as first parameter.
• Must have all the keys provided in staticTags as string type parameters.

Constructors

HistogramAttribute(String[])	Initializes a new instance of the HistogramAttribute class.
HistogramAttribute(Type)	Initializes a new instance of the HistogramAttribute class.

Properties

Name	Gets or sets the name of the metric.
TagNames	Gets the metric's tags.
Type	Gets the type that supplies metric tag values.
TypeId	When implemented in a derived class, gets a unique identifier for this Attribute. (Inherited from Attribute)

Methods

Equals(Object)	Returns a value that indicates whether this instance is equal to a specified object. (Inherited from Attribute)
GetHashCode()	Returns the hash code for this instance. (Inherited from Attribute)
GetType()	Gets the Type of the current instance. (Inherited from Object)
IsDefaultAttribute()	When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class. (Inherited from Attribute)
Match(Object)	When overridden in a derived class, returns a value that indicates whether this instance equals a specified object. (Inherited from Attribute)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)