Partilhar via


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.

Tip

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
Name Tipo de Instrumento Unidade (UCUM) Description
dotnet.health_check.reports Counter<T> {report} Número de vezes que um relatório de integridade relatou o status de integridade de um aplicativo.
Attribute Tipo Description Examples Presence
dotnet.health_check.status string O estado de saúde de uma aplicação. Healthy; Unhealthy Always

dotnet.health_check.status é uma das seguintes:

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

Métrica: dotnet.health_check.unhealthy_checks
Name Tipo de Instrumento Unidade (UCUM) Description
dotnet.health_check.unhealthy_checks Counter<T> {unhealthy_check} Número de vezes que uma verificação de integridade relatou o status de integridade de um aplicativo como Degraded ou Unhealthy.
Attribute Tipo Description Examples Presence
dotnet.health_check.name string O nome da verificação de integridade. ApplicationLifecycle Always
dotnet.health_check.status string O estado de saúde de uma aplicação. Healthy; Unhealthy Always

dotnet.health_check.status é uma das seguintes:

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

Microsoft.Extensions.Diagnostics.ResourceMonitoring

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

Note

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.

Name Tipo de Instrumento Unidade (UCUM) Description
container.cpu.limit.utilization ObservableGauge<T> 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 Microsoft.Extensions.Diagnostics.ResourceMonitoring partir da versão 8.8.0.

Métrica: container.cpu.request.utilization

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

Name Tipo de Instrumento Unidade (UCUM) Description
container.cpu.request.utilization ObservableGauge<T> 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 Microsoft.Extensions.Diagnostics.ResourceMonitoring partir da versão 8.8.0.

Métrica: container.cpu.time

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

Name Tipo de Instrumento Unidade (UCUM) Description
container.cpu.time ObservableCounter<T> s Tempo de CPU usado pelo contêiner.

Disponível a Microsoft.Extensions.Diagnostics.ResourceMonitoring partir da versão 9.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.

Name Tipo de Instrumento Unidade (UCUM) Description
container.memory.limit.utilization ObservableGauge<T> 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 Microsoft.Extensions.Diagnostics.ResourceMonitoring partir da versão 8.8.0.

Métrica: container.memory.usage

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

Name Tipo de Instrumento Unidade (UCUM) Description
container.memory.usage ObservableUpDownCounter<T> By Uso de memória de todos os processos no contêiner medidos em bytes.

Disponível a Microsoft.Extensions.Diagnostics.ResourceMonitoring partir da versão 9.8.0.

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

Disponível a partir de: .NET 8.

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

Disponível a partir de: .NET 8.

Métrica: system.network.connections
Name Tipo de Instrumento Unidade (UCUM) Description
system.network.connections ObservableUpDownCounter<T> {connection} Número de conexões de rede por estado.
Attribute Tipo Description Examples Presence
network.type string Camada de rede OSI ou equivalente não-OSI. ipv4; ipv6 Always
system.network.state string O estado de uma conexão de rede. close; listen Always

Disponível a partir de: .NET 8.