Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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:
container.cpu.limit.utilizationcontainer.cpu.request.utilizationcontainer.cpu.timecontainer.memory.limit.utilizationcontainer.memory.request.utilizationcontainer.memory.usageprocess.cpu.utilizationdotnet.process.memory.virtual.utilizationsystem.network.connections
Note
Einige Metriken, die Microsoft.Extensions.Diagnostics.ResourceMonitoring vom Zähler (z. B. Datenträger-E/A) ausgegeben werden, befinden sich in der experimentellen Phase und werden hier nicht dokumentiert.
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 Ressourcenlimit. Linux: Bereich [0, 1] standardmäßig. Windows: Bereich [0, 100] standardmäßig. Anzeigen UseZeroToOneRangeForMetrics und UseZeroToOneRangeForLinuxMetrics Optionen zum Ändern des Standardverhaltens. |
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 sowohl unter Windows als auch unter Linux auf Containern 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. Linux: Bereich [0, 1] standardmäßig. Windows: Bereich [0, 100] standardmäßig. Anzeigen UseZeroToOneRangeForMetrics und UseZeroToOneRangeForLinuxMetrics Optionen zum Ändern des Standardverhaltens. |
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 Ressourcenlimit. Linux: Bereich [0, 1] standardmäßig. Windows: Bereich [0, 100] standardmäßig. Anzeigen UseZeroToOneRangeForMetrics und UseZeroToOneRangeForLinuxMetrics Optionen zum Ändern des Standardverhaltens. |
Verfügbar ab Microsoft.Extensions.Diagnostics.ResourceMonitoring 8.8.0.
Metrik: container.memory.request.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.request.utilization |
ObservableGauge<T> | 1 |
Der Speicherverbrauch der ausgeführten containerisierten Anwendung relativ zur Ressourcenanforderung. Linux: Bereich [0, 1] standardmäßig. Windows: Bereich [0, 100] standardmäßig. Anzeigen UseZeroToOneRangeForMetrics und UseZeroToOneRangeForLinuxMetrics Optionen zum Ändern des Standardverhaltens. |
Verfügbar ab Microsoft.Extensions.Diagnostics.ResourceMonitoring 9.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. Linux: Bereich [0, 1] standardmäßig. Windows: Bereich [0, 100] standardmäßig. Anzeigen UseZeroToOneRangeForMetrics und UseZeroToOneRangeForLinuxMetrics Optionen zum Ändern des Standardverhaltens. |
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 Arbeitsspeicherverbrauch der ausgeführten Anwendung. Linux: Bereich [0, 1] standardmäßig. Windows: Bereich [0, 100] standardmäßig. Anzeigen UseZeroToOneRangeForMetrics und UseZeroToOneRangeForLinuxMetrics Optionen zum Ändern des Standardverhaltens. |
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.
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
