Compartir vía


System.Diagnostics.Metrics Espacio de nombres

Las métricas son medidas numéricas notificadas a lo largo del tiempo, que se suelen usar para supervisar el estado de una aplicación y generar alertas. Por ejemplo, un servicio web puede realizar un seguimiento de cuántas solicitudes recibe cada segundo, cuántos milisegundos tardó en responder y cuántos de las respuestas devolvieron un error al usuario. Estas métricas se pueden notificar a un sistema de supervisión a intervalos regulares frecuentes. El espacio de nombres System.Diagnostics.Metrics se puede usar para agregar métricas a una aplicación. Las API funcionan en todas las plataformas compatibles con .NET y están diseñadas para integrarse bien con creciente ecosistema de herramientas de OpenTelemetry. También se integran con las herramientas del SDK de .NET, como dotnet-counters. Hay disponible una API de agente de escucha para desarrolladores que quieran crear herramientas personalizadas o adaptadores a otros sistemas.

Clases

Counter<T>

Representa un instrumento que admite la adición de valores no negativos. Por ejemplo, puede llamar a counter.Add(1) cada vez que se procesa una solicitud para realizar un seguimiento del número total de solicitudes. La mayoría de los visores de métricas muestran contadores con una tasa (solicitudes por segundo), de forma predeterminada, pero también pueden mostrar un total acumulado.

Gauge<T>

El medidor es un instrumento que se usa para registrar valores no aditivos cada vez que se produzcan cambios. Por ejemplo, registre el valor del nivel de ruido de fondo de la sala cuando se produzcan cambios.

Histogram<T>

Representa un instrumento de métricas que se puede usar para notificar valores arbitrarios que probablemente sean estadísticamente significativos, por ejemplo, la duración de la solicitud. Llame a CreateHistogram<T>(String, String, String) para crear un objeto Histograma.

Instrument

Clase base de todas las clases de instrumento de métricas

Instrument<T>

Clase base para todos los instrumentos no observables.

InstrumentAdvice<T>

Contiene las opciones de configuración recomendadas para que los consumidores de métricas usen al registrar las medidas de un Instrument<T>determinado.

Meter

Meter es la clase responsable de crear y realizar el seguimiento de los instrumentos.

MeterFactoryExtensions

Métodos de extensión para Meter y IMeterFactory.

MeterListener

La clase MeterListener se usa para escuchar la grabación de medidas del instrumento de métricas.

MeterOptions

Las opciones para crear un Meter.

ObservableCounter<T>

Representa un instrumento observable de métricas que notifica valores que aumentan de forma monotónica cuando se observa el instrumento, por ejemplo, tiempo de CPU (para diferentes procesos, subprocesos, modo de usuario o modo kernel). Llame a CreateObservableCounter para crear el objeto de contador observable.

ObservableGauge<T>

Representa un instrumento observable que informa de valores no aditivos cuando se observa el instrumento, por ejemplo, la temperatura ambiente actual. Llame a CreateObservableGauge para crear el objeto de contador observable.

ObservableInstrument<T>

ObservableInstrument{T} es la clase base de la que heredarán todos los instrumentos observables de métricas.

ObservableUpDownCounter<T>

Instrumento observable de métricas que informa de valores crecientes o decrecientes cuando se observa el instrumento. Utilice este instrumento para supervisar el tamaño del montón del proceso o el número aproximado de elementos en un búfer circular sin bloqueo, por ejemplo. Para crear un objeto ObservableUpDownCounter, use los métodos CreateObservableUpDownCounter.

UpDownCounter<T>

Instrumento que admite la generación de informes de valores de métricas positivos o negativos. UpDownCounter se puede usar en escenarios como notificar el cambio en las solicitudes activas o el tamaño de la cola.

Estructuras

Measurement<T>

Almacena un valor de métrica observado y sus etiquetas asociadas. Este tipo lo usa el método Observe() de un instrumento observable al notificar las medidas actuales.

Interfaces

IMeterFactory

Generador para crear instancias de Meter.

Delegados

MeasurementCallback<T>

Delegado para representar las devoluciones de llamada de Meterlistener que se usan al grabar medidas.