.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 Liste der Metriken, die auf der älteren EventCounters-API basieren, finden Sie unter Verfügbare Zähler.
Tipp
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 | Instrument Typ | Einheit (UCUM) | Beschreibung |
|---|---|---|---|
dotnet.health_check.reports |
Leistungsindikator | {report} |
Häufigkeit, mit der ein Integritätsbericht den Integritätsstatus einer Anwendung gemeldet hat. |
| attribute | type | Beschreibung | Beispiele | Anwesenheit |
|---|---|---|---|---|
dotnet.health_check.status |
Zeichenfolge | Der Integritätsstatus einer Anwendung. | Healthy; Unhealthy |
Always |
dotnet.health_check.status ist einer der folgenden Werte:
| Wert | Beschreibung |
|---|---|
Degraded |
Eine Anwendung war in beeinträchtigtem Zustand. |
Healthy |
Eine Anwendung war fehlerfrei. |
Unhealthy |
Eine Anwendung war fehlerhaft. |
Ab .NET 8.0 verfügbar
Metrik: dotnet.health_check.unhealthy_checks
| Name | Instrument Typ | Einheit (UCUM) | Beschreibung |
|---|---|---|---|
dotnet.health_check.unhealthy_checks |
Leistungsindikator | {unhealthy_check} |
Häufigkeit, mit der eine Integritätsprüfung den Integritätsstatus einer Anwendung als Degraded oder Unhealthy gemeldet hat. |
| attribute | type | Beschreibung | Beispiele | Anwesenheit |
|---|---|---|---|---|
dotnet.health_check.name |
Zeichenfolge | Der Name der Integritätsprüfung. | ApplicationLifecycle |
Always |
dotnet.health_check.status |
Zeichenfolge | Der Integritätsstatus einer Anwendung. | Healthy; Unhealthy |
Always |
dotnet.health_check.status ist einer der folgenden Werte:
| Wert | Beschreibung |
|---|---|
Degraded |
Eine Anwendung war in beeinträchtigtem Zustand. |
Healthy |
Eine Anwendung war fehlerfrei. |
Unhealthy |
Eine Anwendung war fehlerhaft. |
Ab .NET 8.0 verfügbar
Microsoft.Extensions.Diagnostics.ResourceMonitoring
Die Microsoft.Extensions.Diagnostics.ResourceMonitoring Metriken melden Ressourceninformationen aus der Ressourcenüberwachung:
container.cpu.limit.utilizationcontainer.cpu.request.utilizationcontainer.memory.limit.utilizationprocess.cpu.utilizationdotnet.process.memory.virtual.utilizationsystem.network.connections
Hinweis
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 | Instrument Typ | Einheit (UCUM) | Beschreibung |
|---|---|---|---|
container.cpu.limit.utilization |
ObservableGauge | 1 |
Der CPU-Verbrauch der ausgeführten containerisierten Anwendung relativ zum Ressourcengrenzwert im Bereich [0, 1]. |
Verfügbar ab: .NET 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 | Instrument Typ | Einheit (UCUM) | Beschreibung |
|---|---|---|---|
container.cpu.request.utilization |
ObservableGauge | 1 |
Der CPU-Verbrauch der ausgeführten containerisierten Anwendung relativ zur Ressourcenanforderung im Bereich [0, 1]. |
Verfügbar ab: .NET 8.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 | Instrument Typ | Einheit (UCUM) | Beschreibung |
|---|---|---|---|
container.memory.limit.utilization |
ObservableGauge | 1 |
Der Speicherverbrauch der ausgeführten containerisierten Anwendung relativ zum Ressourcengrenzwert im Bereich [0, 1]. |
Verfügbar ab: .NET 8.8.0.
Metrik: process.cpu.utilization
| Name | Instrument Typ | Einheit (UCUM) | Beschreibung |
|---|---|---|---|
process.cpu.utilization |
ObservableGauge | 1 |
Der CPU-Verbrauch der ausgeführten Anwendung im Bereich [0, 1]. |
Ab .NET 8.0 verfügbar
Metrik: dotnet.process.memory.virtual.utilization
| Name | Instrument Typ | Einheit (UCUM) | Beschreibung |
|---|---|---|---|
dotnet.process.memory.virtual.utilization |
ObservableGauge | 1 |
Der Speicherverbrauch der ausgeführten Anwendung im Bereich [0, 1]. |
Ab .NET 8.0 verfügbar
Metrik: system.network.connections
| Name | Instrument Typ | Einheit (UCUM) | Beschreibung |
|---|---|---|---|
system.network.connections |
ObservableUpDownCounter | {connection} |
Anzahl der Netzwerkverbindungen nach Zustand. |
| attribute | type | Beschreibung | Beispiele | Anwesenheit |
|---|---|---|---|---|
network.type |
Zeichenfolge | OSI-Netzwerkschicht oder Nicht-OSI-Entsprechung. | ipv4; ipv6 |
Always |
system.network.state |
Zeichenfolge | Der Zustand einer Netzwerkverbindung. | close; listen |
Always |
Ab .NET 8.0 verfügbar
