System.Diagnostics.Metrics Espaço de Nomes

As métricas são medições numéricas reportadas ao longo do tempo, geralmente usadas para monitorizar o estado de uma aplicação e gerar alertas. Por exemplo, um serviço web pode registar quantos pedidos recebe por segundo, quantos milissegundos demorou a responder e quantas das respostas enviaram um erro de volta ao utilizador. Estas métricas podem ser reportadas a um sistema de monitorização em intervalos frequentes e regulares. O espaço de nomes System.Diagnostics.Metrics pode ser usado para adicionar métricas a uma aplicação. As APIs funcionam em todas as plataformas suportadas pela .NET e são desenhadas para se integrar bem com o ecossistema crescente de ferramentas do OpenTelemetry de ferramentas. Integram-se também com .NET ferramentas SDK, como dotnet-counters. Existe uma API de ouvinte disponível para programadores que queiram criar ferramentas personalizadas ou adaptadores para outros sistemas.

Classes

Name Description
Counter<T>

Representa um instrumento que suporta a adição de valores não negativos. Por exemplo, pode ligar counter.Add(1) cada vez que um pedido for processado para acompanhar o número total de pedidos. A maioria dos visualizadores de métricas apresenta contadores usando uma taxa (pedidos/seg), por defeito, mas também pode mostrar um total cumulativo.

Gauge<T>

O Gauge é um instrumento utilizado para registar valores não aditivos sempre que ocorrem alterações. Por exemplo, regista o valor do nível de ruído de fundo da sala quando ocorrem alterações.

Histogram<T>

Representa um instrumento de métricas que pode ser usado para reportar valores arbitrários que provavelmente serão estatisticamente significativos, por exemplo, a duração do pedido. Chamada CreateHistogram<T>(String, String, String) para criar um objeto Histograma.

Instrument

Classe base de todas as classes de instrumentos de métricas

Instrument<T>

A classe base para todos os instrumentos não observáveis.

InstrumentAdvice<T>

Contém definições de configuração aconselhadas a serem usadas pelos consumidores de métricas ao registar medições para um dado Instrument<T>.

Meter

O Meter é a classe responsável por criar e acompanhar os Instrumentos.

MeterFactoryExtensions

Métodos de extensão para Meter e IMeterFactory.

MeterListener

O MeterListener é uma classe usada para ouvir a gravação de medições do instrumento métrico.

MeterOptions

As opções para criar um Meter.

ObservableCounter<T>

Representa um instrumento observável por métricas que reporta valores monotonamente crescentes quando o instrumento está a ser observado, por exemplo, tempo de CPU (para diferentes processos, threads, modo utilizador ou modo kernel). Chamada CreateObservableCounter para criar o objeto contracontador observável.

ObservableGauge<T>

Representa um instrumento observável que reporta valores não aditivos quando o instrumento está a ser observado, por exemplo, a temperatura atual da sala. Chamada CreateObservableGauge para criar o objeto contracontador observável.

ObservableInstrument<T>

ObservableInstrument{T} é a classe base da qual todos os instrumentos observáveis de métricas irão herdar.

ObservableUpDownCounter<T>

Um instrumento observável por métricas que reporta valores crescentes ou decrescentes quando o instrumento está a ser observado. Use este instrumento para monitorizar o tamanho do heap de processo ou o número aproximado de itens num buffer circular sem bloqueios, por exemplo. Para criar um objeto ObservableUpDownCounter, utilize os CreateObservableUpDownCounter métodos.

UpDownCounter<T>

Um instrumento que suporta o reporte de valores de métricas positivos ou negativos. O UpDownCounter pode ser usado em cenários como reportar alterações nos pedidos ativos ou no tamanho da fila.

Estruturas

Name Description
Measurement<T>

Armazena um valor de métrica observado e as suas etiquetas associadas. Este tipo é utilizado pelo método Observe() de um instrumento observável ao reportar medições de corrente.

Interfaces

Name Description
IMeterFactory

Uma fábrica para criar Meter instâncias.

Delegados

Name Description
MeasurementCallback<T>

Um delegado para representar os callbacks Meterlistener usados ao registar medições.