Compartilhar via


Métricas de extensões do .NET

Esse artigo descreve as métricas internas para bibliotecas de extensões do .NET de diagnóstico que são produzidas usando a API System.Diagnostics.Metrics. Para obter uma listagem 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 métricas Microsoft.Extensions.Diagnostics.HealthChecks relatam informações de verificação de integridade das verificações de integridade do .NET:

Você pode habilitar essas métricas chamando o método de AddTelemetryHealthCheckPublisher 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 status de integridade de um aplicativo. Healthy; Unhealthy Always

dotnet.health_check.status é um dos seguintes:

Value Description
Degraded Um aplicativo estava em estado degradado.
Healthy Um aplicativo estava íntegro.
Unhealthy Um aplicativo não estava íntegro.

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 status de integridade de um aplicativo. Healthy; Unhealthy Always

dotnet.health_check.status é um dos seguintes:

Value Description
Degraded Um aplicativo estava em estado degradado.
Healthy Um aplicativo estava íntegro.
Unhealthy Um aplicativo não estava íntegro.

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 medidor Microsoft.Extensions.Diagnostics.ResourceMonitoring estão em estágio experimental. Isso significa que pode haver alterações significativas neles.

Métrica: container.cpu.limit.utilization

O instrumento está disponível apenas em um sistema executado em contêineres no Windows e no Linux.

Name Tipo de instrumento Unidade (UCUM) Description
container.cpu.limit.utilization ObservableGauge<T> 1 O consumo de CPU do aplicativo conteinerizado em execução em relação ao limite de recursos no intervalo [0, 1].

Disponível a partir da Microsoft.Extensions.Diagnostics.ResourceMonitoring 8.8.0.

Métrica: container.cpu.request.utilization

O instrumento está disponível apenas em um sistema executado 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 conteinerizado em execução em relação à solicitação de recurso no intervalo [0, 1].

Disponível a partir da Microsoft.Extensions.Diagnostics.ResourceMonitoring 8.8.0.

Métrica: container.cpu.time

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

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

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

Métrica: container.memory.limit.utilization

O instrumento está disponível apenas em um sistema executado em contêineres no Windows e no Linux.

Name Tipo de instrumento Unidade (UCUM) Description
container.memory.limit.utilization ObservableGauge<T> 1 O consumo de memória do aplicativo conteinerizado em execução em relação ao limite de recursos no intervalo [0, 1].

Disponível a partir da Microsoft.Extensions.Diagnostics.ResourceMonitoring 8.8.0.

Métrica: container.memory.usage

O instrumento só está disponível em um sistema em execução 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 medido em bytes.

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