System.Diagnostics.Metrics Espaço de Nomes
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 |
| 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. |