Métricas de extensões .NET

Este artigo descreve as métricas internas para bibliotecas de extensões .NET de diagnóstico que são produzidas usando a System.Diagnostics.Metrics API. Para obter uma lista de métricas com base na API EventCounters mais antiga, consulte Contadores disponíveis.

Gorjeta

Para obter mais informações sobre como coletar e relatar essas métricas, consulte Coletando métricas.

Microsoft.Extensions.Diagnostics.HealthChecks

As Microsoft.Extensions.Diagnostics.HealthChecks métricas relatam informações de verificação de integridade das verificações de integridade do .NET:

Você pode habilitar essas métricas chamando o AddTelemetryHealthCheckPublisher método de extensão. Essas métricas só podem ser habilitadas para métricas baseadas em push e não estão disponíveis para métricas baseadas em pull.

Métrica: dotnet.health_check.reports
Nome Tipo de Instrumento Unidade (UCUM) Description
dotnet.health_check.reports Contador {report} Número de vezes que um relatório de integridade relatou o status de integridade de um aplicativo.
Atributo Tipo Description Exemplos Presença
dotnet.health_check.status string O estado de saúde de uma aplicação. Healthy; Unhealthy Sempre

dotnet.health_check.status é uma das seguintes:

valor Description
Degraded Um aplicativo estava em estado degradado.
Healthy Uma aplicação foi saudável.
Unhealthy Uma aplicação não era saudável.

Disponível a partir de: .NET 8.0.

Métrica: dotnet.health_check.unhealthy_checks
Nome Tipo de Instrumento Unidade (UCUM) Description
dotnet.health_check.unhealthy_checks Contador {unhealthy_check} Número de vezes que uma verificação de integridade relatou o status de integridade de um aplicativo como Degraded ou Unhealthy.
Atributo Tipo Description Exemplos Presença
dotnet.health_check.name string O nome da verificação de integridade. ApplicationLifecycle Sempre
dotnet.health_check.status string O estado de saúde de uma aplicação. Healthy; Unhealthy Sempre

dotnet.health_check.status é uma das seguintes:

valor Description
Degraded Um aplicativo estava em estado degradado.
Healthy Uma aplicação foi saudável.
Unhealthy Uma aplicação não era saudável.

Disponível a partir de: .NET 8.0.

Microsoft.Extensions.Diagnostics.ResourceMonitoring

As Microsoft.Extensions.Diagnostics.ResourceMonitoring métricas relatam informações de recursos do monitoramento de recursos:

Nota

As métricas emitidas pelo Microsoft.Extensions.Diagnostics.ResourceMonitoring medidor estão em fase experimental. Isso significa que pode haver mudanças significativas neles.

Métrica: container.cpu.limit.utilization

O instrumento só está disponível em um sistema rodando em contêineres tanto no Windows quanto no Linux.

Nome Tipo de Instrumento Unidade (UCUM) Description
container.cpu.limit.utilization ObservableGauge 1 O consumo de CPU do aplicativo em execução em contêiner em relação ao limite de recursos no intervalo [0, 1].

Disponível a partir de: .NET 8.8.0.

Métrica: container.cpu.request.utilization

O instrumento só está disponível em um sistema rodando em contêineres no Linux.

Nome Tipo de Instrumento Unidade (UCUM) Description
container.cpu.request.utilization ObservableGauge 1 O consumo de CPU do aplicativo em execução em contêiner em relação à solicitação de recursos no intervalo [0, 1].

Disponível a partir de: .NET 8.8.0.

Métrica: container.memory.limit.utilization

O instrumento só está disponível em um sistema rodando em contêineres tanto no Windows quanto no Linux.

Nome Tipo de Instrumento Unidade (UCUM) Description
container.memory.limit.utilization ObservableGauge 1 O consumo de memória do aplicativo em execução em contêiner em relação ao limite de recursos no intervalo [0, 1].

Disponível a partir de: .NET 8.8.0.

Métrica: process.cpu.utilization
Nome Tipo de Instrumento Unidade (UCUM) Description
process.cpu.utilization ObservableGauge 1 O consumo de CPU do aplicativo em execução no intervalo [0, 1].

Disponível a partir de: .NET 8.0.

Métrica: dotnet.process.memory.virtual.utilization
Nome Tipo de Instrumento Unidade (UCUM) Description
dotnet.process.memory.virtual.utilization ObservableGauge 1 O consumo de memória do aplicativo em execução no intervalo [0, 1].

Disponível a partir de: .NET 8.0.

Métrica: system.network.connections
Nome Tipo de Instrumento Unidade (UCUM) Description
system.network.connections ObservableUpDownCounter {connection} Número de conexões de rede por estado.
Atributo Tipo Description Exemplos Presença
network.type string Camada de rede OSI ou equivalente não-OSI. ipv4; ipv6 Sempre
system.network.state string O estado de uma conexão de rede. close; listen Sempre

Disponível a partir de: .NET 8.0.