System.Diagnostics.Metrics Namespace

As métricas são medidas numéricas relatadas ao longo do tempo, geralmente usadas para monitorar a integridade de um aplicativo e gerar alertas. Por exemplo, um serviço Web pode rastrear quantas solicitações ele recebe a cada segundo, quantos milissegundos foram necessários para responder e quantas respostas enviaram um erro de volta ao usuário. Essas métricas podem ser relatadas a um sistema de monitoramento em intervalos frequentes e regulares. O namespace System.Diagnostics.Metrics pode ser usado para adicionar métricas a um aplicativo. As APIs funcionam em todas as plataformas compatíveis com o .NET e foram projetadas para se integrarem bem ao crescente ecossistema de ferramentas do OpenTelemetry . Eles também se integram às ferramentas do SDK do .NET, como dotnet-counters. Uma API de ouvinte está disponível para desenvolvedores que desejam criar ferramentas personalizadas ou adaptadores para outros sistemas.

Classes

Counter<T>

Representa um instrumento que dá suporte à adição de valores não negativos. Por exemplo, você pode chamar counter.Add(1) cada vez que uma solicitação é processada para acompanhar o número total de solicitações. A maioria dos visualizadores de métrica exibe contadores usando uma taxa (solicitações/s), por padrão, mas também pode exibir um total cumulativo.

Histogram<T>

Representa um instrumento de métricas que pode ser usado para relatar valores arbitrários que provavelmente serão estatisticamente significativos, por exemplo, a duração da solicitação. Chame CreateHistogram<T>(String, String, String) para criar um objeto Histogram.

Instrument

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

Instrument<T>

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

Meter

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

MeterFactoryExtensions

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

MeterListener

The MeterListener is class used to listen to the metrics instrument measurements recording.

MeterOptions

As opções para criar um Meter.

ObservableCounter<T>

Representa um instrumento observável por métricas que relata valores de aumento monotonicamente quando o instrumento está sendo observado, por exemplo, tempo de CPU (para diferentes processos, threads, modo de usuário ou modo kernel). Chame CreateObservableCounter para criar o objeto de contador observável.

ObservableGauge<T>

Representa um instrumento observável que relata valores não aditivos quando o instrumento está sendo observado, por exemplo, a temperatura ambiente atual. Chame CreateObservableGauge para criar o objeto de contador observável.

ObservableInstrument<T>

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

ObservableUpDownCounter<T>

Um instrumento observável por métricas que relata valores crescentes ou decrescentes quando o instrumento está sendo observado. Use esse instrumento para monitorar o tamanho do heap do processo ou o número aproximado de itens em um buffer circular sem bloqueio, por exemplo. Para criar um objeto ObservableUpDownCounter, use os CreateObservableUpDownCounter métodos .

UpDownCounter<T>

Um instrumento que dá suporte ao relatório de valores de métrica positivos ou negativos. UpDownCounter pode ser usado em cenários como relatar a alteração em solicitações ativas ou tamanho da fila.

Estruturas

Measurement<T>

Armazena um valor de métrica observado e suas marcas associadas. Esse tipo é usado pelo método Observe() de um instrumento observável ao relatar medidas atuais.

Interfaces

IMeterFactory

Uma fábrica para criar Meter instâncias.

Delegados

MeasurementCallback<T>

Um delegado para representar os retornos de chamada meterlistener que são usados ao registrar medidas.