Freigeben über


.NET-Erweiterungsmetriken

In diesem Artikel werden die integrierten Metriken für Diagnosebibliotheken der .NET-Erweiterungen beschrieben, die mithilfe der System.Diagnostics.Metrics-API erstellt werden. Eine Auflistung von Metriken basierend auf der älteren EventCounters-API finden Sie unter "Verfügbare Leistungsindikatoren".

Tip

Weitere Informationen zum Sammeln und Melden dieser Metriken finden Sie unter Sammeln von Metriken.

Microsoft.Extensions.Diagnostics.HealthChecks

Die Microsoft.Extensions.Diagnostics.HealthChecks-Metriken melden Informationen zu Integritätsüberprüfungen aus .NET-Integritätsprüfungen:

Sie können diese Metriken aktivieren, indem Sie die AddTelemetryHealthCheckPublisher Erweiterungsmethode aufrufen. Diese Metriken können nur für pushbasierte Metriken aktiviert werden und sind für Pull-basierte Metriken nicht verfügbar.

Metrik: dotnet.health_check.reports
Name Instrumenttyp Einheit (UCUM) Description
dotnet.health_check.reports Counter<T> {report} Häufigkeit, mit der ein Integritätsbericht den Integritätsstatus einer Anwendung gemeldet hat.
Attribute Type Description Examples Presence
dotnet.health_check.status string Der Integritätsstatus einer Anwendung. Healthy; Unhealthy Always

dotnet.health_check.status ist einer der folgenden Werte:

Value Description
Degraded Eine Anwendung war in beeinträchtigtem Zustand.
Healthy Eine Anwendung war fehlerfrei.
Unhealthy Eine Anwendung war fehlerhaft.

Verfügbar ab: .NET 8.

Metrik: dotnet.health_check.unhealthy_checks
Name Instrumenttyp Einheit (UCUM) Description
dotnet.health_check.unhealthy_checks Counter<T> {unhealthy_check} Häufigkeit, mit der eine Integritätsprüfung den Integritätsstatus einer Anwendung als Degraded oder Unhealthy gemeldet hat.
Attribute Type Description Examples Presence
dotnet.health_check.name string Der Name der Integritätsprüfung. ApplicationLifecycle Always
dotnet.health_check.status string Der Integritätsstatus einer Anwendung. Healthy; Unhealthy Always

dotnet.health_check.status ist einer der folgenden Werte:

Value Description
Degraded Eine Anwendung war in beeinträchtigtem Zustand.
Healthy Eine Anwendung war fehlerfrei.
Unhealthy Eine Anwendung war fehlerhaft.

Verfügbar ab: .NET 8.

Microsoft.Extensions.Diagnostics.ResourceMonitoring

Die Microsoft.Extensions.Diagnostics.ResourceMonitoring Metriken melden Ressourceninformationen aus der Ressourcenüberwachung:

Note

Metriken, die von der Microsoft.Extensions.Diagnostics.ResourceMonitoring-Verbrauchseinheit ausgegeben werden, befinden sich in experimenteller Phase. Dies bedeutet, dass es zu Breaking Changes kommen könnte.

Metrik: container.cpu.limit.utilization

Das Instrument ist nur auf einem System verfügbar, das sowohl unter Windows als auch unter Linux auf Containern ausgeführt wird.

Name Instrumenttyp Einheit (UCUM) Description
container.cpu.limit.utilization ObservableGauge<T> 1 Der CPU-Verbrauch der ausgeführten containerisierten Anwendung relativ zum Ressourcengrenzwert im Bereich [0, 1].

Verfügbar ab Microsoft.Extensions.Diagnostics.ResourceMonitoring 8.8.0.

Metrik: container.cpu.request.utilization

Das Instrument ist nur auf einem System verfügbar, das auf Containern unter Linux ausgeführt wird.

Name Instrumenttyp Einheit (UCUM) Description
container.cpu.request.utilization ObservableGauge<T> 1 Der CPU-Verbrauch der ausgeführten containerisierten Anwendung relativ zur Ressourcenanforderung im Bereich [0, 1].

Verfügbar ab Microsoft.Extensions.Diagnostics.ResourceMonitoring 8.8.0.

Metrik: container.cpu.time

Das Instrument ist nur auf einem System verfügbar, das auf einem Container unter Windows oder Linux ausgeführt wird.

Name Instrumenttyp Einheit (UCUM) Description
container.cpu.time ObservableCounter<T> s Vom Container verwendete CPU-Zeit.

Verfügbar ab Microsoft.Extensions.Diagnostics.ResourceMonitoring 9.8.0.

Metrik: container.memory.limit.utilization

Das Instrument ist nur auf einem System verfügbar, das sowohl unter Windows als auch unter Linux auf Containern ausgeführt wird.

Name Instrumenttyp Einheit (UCUM) Description
container.memory.limit.utilization ObservableGauge<T> 1 Der Speicherverbrauch der ausgeführten containerisierten Anwendung relativ zum Ressourcengrenzwert im Bereich [0, 1].

Verfügbar ab Microsoft.Extensions.Diagnostics.ResourceMonitoring 8.8.0.

Metrik: container.memory.usage

Das Instrument ist nur auf einem System verfügbar, das auf Containern unter Windows oder Linux ausgeführt wird.

Name Instrumenttyp Einheit (UCUM) Description
container.memory.usage ObservableUpDownCounter<T> By Speicherauslastung aller Prozesse im Container, gemessen in Byte.

Verfügbar ab Microsoft.Extensions.Diagnostics.ResourceMonitoring 9.8.0.

Metrik: process.cpu.utilization
Name Instrumenttyp Einheit (UCUM) Description
process.cpu.utilization ObservableGauge<T> 1 Der CPU-Verbrauch der ausgeführten Anwendung im Bereich [0, 1].

Verfügbar ab: .NET 8.

Metrik: dotnet.process.memory.virtual.utilization
Name Instrumenttyp Einheit (UCUM) Description
dotnet.process.memory.virtual.utilization ObservableGauge<T> 1 Der Speicherverbrauch der ausgeführten Anwendung im Bereich [0, 1].

Verfügbar ab: .NET 8.

Metrik: system.network.connections
Name Instrumenttyp Einheit (UCUM) Description
system.network.connections ObservableUpDownCounter<T> {connection} Anzahl der Netzwerkverbindungen nach Zustand.
Attribute Type Description Examples Presence
network.type string OSI-Netzwerkschicht oder Nicht-OSI-Entsprechung. ipv4; ipv6 Always
system.network.state string Der Zustand einer Netzwerkverbindung. close; listen Always

Verfügbar ab: .NET 8.