Compartilhar via


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 acompanhar quantas solicitações ele recebe a cada segundo, quantos milissegundos foram necessários para responder e quantas das 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 integrar bem ao ecossistema de ferramentas crescente 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) sempre 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.

Gauge<T>

O Medidor é um instrumento usado para registrar valores não aditivos sempre que ocorrem alterações. Por exemplo, registre o valor do nível de ruído de plano de fundo da sala quando ocorrerem alterações.

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 instrumentos de métricas

Instrument<T>

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

InstrumentAdvice<T>

Contém as configurações aconselhadas a serem usadas pelos consumidores de métricas ao registrar medidas para um determinado Instrument<T>.

Meter

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

MeterFactoryExtensions

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

MeterListener

O MeterListener é a classe usada para ouvir a gravação de medidas do instrumento de métricas.

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 este 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 métodos CreateObservableUpDownCounter.

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 instâncias de Meter.

Delegados

MeasurementCallback<T>

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