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 bene con ecosistema crescente di strumenti di OpenTelemetry. Si integrano anche con gli strumenti di .NET SDK, ad esempio dotnet-counters. Un'API 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. 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.

Gauge<T>

Il misuratore è uno strumento usato per registrare valori non additivi ogni volta che si verificano modifiche. Ad esempio, registrare il valore del livello di rumore di fondo della stanza quando si verificano modifiche.

Histogram<T>

Rappresenta uno strumento per le 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 base di tutte le classi di strumenti delle metriche

Instrument<T>

Classe base per tutti gli strumenti non osservabili.

InstrumentAdvice<T>

Contiene le impostazioni di configurazione consigliate dai consumer delle metriche durante la registrazione delle misurazioni per un determinato Instrument<T>.

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 Meter.

ObservableCounter<T>

Rappresenta uno strumento osservabile dalle metriche che segnala valori che aumentano in modo monotonico quando lo strumento viene osservato, ad esempio, il tempo della 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 della stanza 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 dalle 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 blocchi, ad esempio. Per creare un oggetto ObservableUpDownCounter, utilizzare i metodi CreateObservableUpDownCounter.

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 delle metriche osservato e i relativi tag associati. Questo tipo viene utilizzato dal metodo Observable di uno strumento Observable quando si segnalano le misurazioni correnti.

Interfacce

IMeterFactory

Factory per la creazione di istanze di Meter.

Delegati

MeasurementCallback<T>

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