Compartilhar via

Métricas de extensões do .NET

  • Artigo

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

Dica

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
Nome Tipo de instrumento Unidade (UCUM) Descrição
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 Descrição Exemplos Presença
dotnet.health_check.status string O status de integridade de um aplicativo. Healthy; Unhealthy Sempre

dotnet.health_check.status é um dos seguintes:

Valor Descrição
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.0.

Métrica: dotnet.health_check.unhealthy_checks
Nome Tipo de instrumento Unidade (UCUM) Descrição
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 Descrição Exemplos Presença
dotnet.health_check.name string O nome da verificação de integridade. ApplicationLifecycle Sempre
dotnet.health_check.status string O status de integridade de um aplicativo. Healthy; Unhealthy Sempre

dotnet.health_check.status é um dos seguintes:

Valor Descrição
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.0.

Microsoft.Extensions.Diagnostics.ResourceMonitoring

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

Observação

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.

Nome Tipo de instrumento Unidade (UCUM) Descrição
container.cpu.limit.utilization ObservableGauge 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 de: .NET 8.8.0.

Métrica: container.cpu.request.utilization

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

Nome Tipo de instrumento Unidade (UCUM) Descrição
container.cpu.request.utilization ObservableGauge 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 de: .NET 8.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.

Nome Tipo de instrumento Unidade (UCUM) Descrição
container.memory.limit.utilization ObservableGauge 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 de: .NET 8.8.0.

Métrica: process.cpu.utilization
Nome Tipo de instrumento Unidade (UCUM) Descrição
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) Descrição
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) Descrição
system.network.connections ObservableUpDownCounter {connection} Número de conexões de rede por estado.
Atributo Tipo Descrição 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.