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

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

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:

• 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

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.