Condividi tramite


System.Diagnostics.Metrics Spazio dei nomi

Le metriche sono misurazioni numeriche segnalate nel tempo, più spesso usate per monitorare l'integrità di un'applicazione e generare avvisi. Ad esempio, un servizio Web potrebbe tenere traccia del numero di richieste ricevute ogni secondo, del numero di millisecondi impiegato per rispondere e del numero di risposte inviate un errore all'utente. Queste metriche possono essere segnalate a un sistema di monitoraggio a intervalli frequenti e regolari. Lo spazio dei nomi System.Diagnostics.Metrics può essere usato per aggiungere metriche a un'applicazione. Le API funzionano su tutte le piattaforme supportate da .NET e sono progettate per integrarsi bene con l'ecosistema di strumenti in crescita di OpenTelemetry . Si integrano anche con gli strumenti .NET SDK, ad esempio dotnet-counters. Un'API listener è disponibile per gli sviluppatori che vogliono creare strumenti o adattatori personalizzati ad altri sistemi.

Classi

Counter<T>

Rappresenta uno strumento che supporta l'aggiunta di valori non negativi. Ad esempio, è possibile chiamare counter.Add(1) ogni volta che una richiesta viene elaborata per tenere traccia del numero totale di richieste. La maggior parte dei visualizzatori delle metriche visualizza i contatori usando una frequenza (richieste/sec), per impostazione predefinita, ma può anche visualizzare un totale cumulativo.

Histogram<T>

Rappresenta uno strumento delle metriche che può essere usato per segnalare valori arbitrari che potrebbero essere statisticamente significativi, ad esempio la durata della richiesta. Chiamare CreateHistogram<T>(String, String, String) per creare un oggetto Histogram.

Instrument

Classe di base di tutte le classi degli strumenti delle metriche

Instrument<T>

Classe di base per tutti gli strumenti non osservabili.

Meter

Il contatore è la classe responsabile della creazione e del rilevamento degli strumenti.

MeterFactoryExtensions

Metodi di estensione per Meter e IMeterFactory.

MeterListener

La classe MeterListener viene usata per ascoltare la registrazione delle misurazioni degli strumenti delle metriche.

MeterOptions

Opzioni per la creazione di un oggetto Meter.

ObservableCounter<T>

Rappresenta uno strumento osservabile delle metriche che segnala valori monotonici in aumento quando lo strumento viene osservato, ad esempio, il tempo della CPU (per processi diversi, thread, modalità utente o modalità kernel). Chiamare CreateObservableCounter per creare l'oggetto contatore osservabile.

ObservableGauge<T>

Rappresenta uno strumento osservabile che segnala valori non additivi quando lo strumento viene osservato, ad esempio la temperatura della stanza corrente. Chiamare CreateObservableGauge per creare l'oggetto contatore osservabile.

ObservableInstrument<T>

ObservableInstrument{T} è la classe di base da cui erediteranno tutti gli strumenti osservabili delle metriche.

ObservableUpDownCounter<T>

Strumento osservabile delle metriche che segnala l'aumento o la riduzione dei valori quando viene osservato lo strumento. Usare questo strumento per monitorare le dimensioni dell'heap del processo o il numero approssimativo di elementi in un buffer circolare senza blocchi, ad esempio. Per creare un oggetto ObservableUpDownCounter, usare i CreateObservableUpDownCounter metodi.

UpDownCounter<T>

Strumento che supporta la segnalazione di valori di metrica positivi o negativi. UpDownCounter può essere usato in scenari come la segnalazione della modifica delle richieste attive o delle dimensioni della coda.

Struct

Measurement<T>

Archivia un valore delle metriche osservate e i relativi tag associati. Questo tipo viene usato da un metodo Osservabile dello strumento quando segnala le misurazioni correnti.

Interfacce

IMeterFactory

Factory per la creazione di Meter istanze.

Delegati

MeasurementCallback<T>

Delegato per rappresentare i callback di Meterlistener usati durante la registrazione delle misurazioni.