Metriche delle estensioni .NET

Questo articolo descrive le metriche predefinite per le librerie di estensioni .NET di diagnostica generate tramite l'API System.Diagnostics.Metrics. Per un elenco delle metriche basate sull'API EventCounters precedente, vedere Contatori disponibili.

Tip

Per altre informazioni su come raccogliere e segnalare queste metriche, vedere Raccolta di metriche.

Microsoft.Extensions.Diagnostics.HealthChecks

Le metriche Microsoft.Extensions.Diagnostics.HealthChecks segnalano le informazioni sul controllo integrità dai controlli integrità .NET:

• dotnet.health_check.reports
• dotnet.health_check.unhealthy_checks

È possibile abilitare queste metriche chiamando il AddTelemetryHealthCheckPublisher metodo di estensione. Queste metriche possono essere abilitate solo per le metriche basate su push e non sono disponibili per le metriche basate sul pull.

Metrica: dotnet.health_check.reports

Name	Tipo di strumento	Unità (UCUM)	Description
dotnet.health_check.reports	Counter<T>	{report}	Numero di volte in cui un report sull'integrità ha segnalato lo stato integrità di un'applicazione.

Attribute	Type	Description	Examples	Presence
dotnet.health_check.status	string	Stato integrità di un'applicazione.	Healthy; Unhealthy	Always

dotnet.health_check.status corrisponde a uno dei valori seguenti:

Value	Description
Degraded	Stato di un'applicazione danneggiato.
Healthy	Applicazione integra.
Unhealthy	Applicazione non integra.

Disponibile a partire da: .NET 8.

Metrica: dotnet.health_check.unhealthy_checks

Name	Tipo di strumento	Unità (UCUM)	Description
dotnet.health_check.unhealthy_checks	Counter<T>	{unhealthy_check}	Numero di volte in cui un controllo integrità ha segnalato lo stato integrità di un'applicazione come Degraded o Unhealthy.

Attribute	Type	Description	Examples	Presence
dotnet.health_check.name	string	Nome del controllo integrità.	ApplicationLifecycle	Always
dotnet.health_check.status	string	Stato integrità di un'applicazione.	Healthy; Unhealthy	Always

dotnet.health_check.status corrisponde a uno dei valori seguenti:

Value	Description
Degraded	Stato di un'applicazione danneggiato.
Healthy	Applicazione integra.
Unhealthy	Applicazione non integra.

Disponibile a partire da: .NET 8.

Microsoft.Extensions.Diagnostics.ResourceMonitoring

Le Microsoft.Extensions.Diagnostics.ResourceMonitoring metriche segnalano le informazioni sulle risorse dal monitoraggio delle risorse:

• container.cpu.limit.utilization
• container.cpu.request.utilization
• container.cpu.time
• container.memory.limit.utilization
• container.memory.usage
• process.cpu.utilization
• dotnet.process.memory.virtual.utilization
• system.network.connections

Note

Le metriche generate dal contatore Microsoft.Extensions.Diagnostics.ResourceMonitoring sono in fase sperimentale. Ciò significa che potrebbero essere apportate modifiche che causano un'interruzione.

Metrica: container.cpu.limit.utilization

Lo strumento è disponibile solo in un sistema in esecuzione in contenitori sia in Windows che in Linux.

Name	Tipo di strumento	Unità (UCUM)	Description
container.cpu.limit.utilization	ObservableGauge<T>	1	Utilizzo della CPU dell'applicazione in contenitori in esecuzione rispetto al limite di risorse nell'intervallo [0, 1].

Disponibile a partire dalla Microsoft.Extensions.Diagnostics.ResourceMonitoring versione 8.8.0.

Metrica: container.cpu.request.utilization

Lo strumento è disponibile solo in un sistema in esecuzione in contenitori in Linux.

Name	Tipo di strumento	Unità (UCUM)	Description
container.cpu.request.utilization	ObservableGauge<T>	1	Utilizzo della CPU dell'applicazione in contenitori in esecuzione rispetto alla richiesta di risorsa nell'intervallo [0, 1].

Disponibile a partire dalla Microsoft.Extensions.Diagnostics.ResourceMonitoring versione 8.8.0.

Metrica: container.cpu.time

Lo strumento è disponibile solo in un sistema in esecuzione in un contenitore in Windows o Linux.

Name	Tipo di strumento	Unità (UCUM)	Description
container.cpu.time	ObservableCounter<T>	s	Tempo cpu usato dal contenitore.

Disponibile a partire dalla Microsoft.Extensions.Diagnostics.ResourceMonitoring versione 9.8.0.

Metrica: container.memory.limit.utilization

Lo strumento è disponibile solo in un sistema in esecuzione in contenitori sia in Windows che in Linux.

Name	Tipo di strumento	Unità (UCUM)	Description
container.memory.limit.utilization	ObservableGauge<T>	1	Utilizzo della memoria dell'applicazione in contenitori in esecuzione rispetto al limite di risorse nell'intervallo [0, 1].

Disponibile a partire dalla Microsoft.Extensions.Diagnostics.ResourceMonitoring versione 8.8.0.

Metrica: container.memory.usage

Lo strumento è disponibile solo in un sistema in esecuzione in contenitori in Windows o Linux.

Name	Tipo di strumento	Unità (UCUM)	Description
container.memory.usage	ObservableUpDownCounter<T>	By	Utilizzo della memoria di tutti i processi nel contenitore misurato in byte.

Disponibile a partire dalla Microsoft.Extensions.Diagnostics.ResourceMonitoring versione 9.8.0.

Metrica: process.cpu.utilization

Name	Tipo di strumento	Unità (UCUM)	Description
process.cpu.utilization	ObservableGauge<T>	1	Utilizzo della CPU dell'applicazione in esecuzione nell'intervallo [0, 1].

Disponibile a partire da: .NET 8.

Metrica: dotnet.process.memory.virtual.utilization

Name	Tipo di strumento	Unità (UCUM)	Description
dotnet.process.memory.virtual.utilization	ObservableGauge<T>	1	Utilizzo della memoria dell'applicazione in esecuzione nell'intervallo [0, 1].

Disponibile a partire da: .NET 8.

Metrica: system.network.connections

Name	Tipo di strumento	Unità (UCUM)	Description
system.network.connections	ObservableUpDownCounter<T>	{connection}	Numero di connessioni di rete in base allo stato.

Attribute	Type	Description	Examples	Presence
network.type	string	Livello di rete OSI o non OSI equivalente.	ipv4; ipv6	Always
system.network.state	string	Stato di una connessione di rete.	close; listen	Always

Disponibile a partire da: .NET 8.