System.Diagnostics.Metrics Spazio dei nomi

Le metriche sono misurazioni numeriche segnalate nel tempo, usate più spesso 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 all'utente. Queste metriche possono essere segnalate a un sistema di monitoraggio a intervalli regolari frequenti. 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 correttamente con l'ecosistema crescente di strumenti di OpenTelemetry . Si integrano anche con gli strumenti di .NET SDK, ad esempio dotnet-counters. Un'API del listener è disponibile per gli sviluppatori che vogliono creare adattatori o strumenti personalizzati in 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 viene elaborata una richiesta per tenere traccia del numero totale di richieste. Per impostazione predefinita, la maggior parte dei visualizzatori delle metriche visualizza i contatori usando una frequenza (richieste/sec), ma può anche visualizzare un totale cumulativo.

Histogram<T>

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

Instrument

Classe base di tutte le classi degli strumenti delle metriche

Instrument<T>

Classe base per tutti gli strumenti non osservabili.

Meter

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

MeterFactoryExtensions

Metodi di estensione per Meter e IMeterFactory.

MeterListener

MeterListener è una classe 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 dalle metriche che segnala valori che aumentano monotonicamente quando viene osservato lo strumento, ad esempio il tempo di CPU (per processi, thread, modalità utente o modalità kernel diversi). Chiamare CreateObservableCounter per creare l'oggetto contatore osservabile.

ObservableGauge<T>

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

ObservableInstrument<T>

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

ObservableUpDownCounter<T>

Strumento osservabile delle metriche che segnala valori crescenti o decrescenti 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 blocco, ad esempio. Per creare un oggetto ObservableUpDownCounter, utilizzare 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 nelle richieste attive o nelle dimensioni della coda.

Struct

Measurement<T>

Archivia un valore di metrica osservato e i relativi tag associati. Questo tipo viene utilizzato dal metodo Observable Instrument Observable Observable durante la segnalazione delle misurazioni correnti.

Interfacce

IMeterFactory

Factory per la creazione di Meter istanze.

Delegati

MeasurementCallback<T>

Delegato per rappresentare i callback meterlistener utilizzati durante la registrazione delle misurazioni.