Métricas de tempo de execução do .NET

Este artigo descreve as métricas internas para bibliotecas de tempo de execução do .NET 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.

System.Runtime

O System.Runtime medidor relata medições do GC, JIT, AssemblyLoader, Threadpool e partes de tratamento de exceções do tempo de execução do .NET, bem como algumas métricas de CPU e memória do sistema operacional. Essas métricas estão disponíveis automaticamente para todos os aplicativos .NET.

Métrica: dotnet.process.cpu.time

Essa métrica relata os mesmos valores que acessar as propriedades de tempo do processador para System.Diagnostics.Process o processo atual. O system modo corresponde a e user o PrivilegedProcessorTime modo corresponde aUserProcessorTime

Disponível a partir de: .NET 9.0.

Métrica: dotnet.process.memory.working_set

Essa métrica relata os mesmos valores da propriedade de chamada Environment.WorkingSet .

Disponível a partir de: .NET 9.0.

Métrica: dotnet.gc.collections

O .NET GC é um coletor de lixo geracional. Cada vez que o coletor de lixo é executado, ele usa heurística para selecionar uma geração máxima e, em seguida, coleta objetos em todas as gerações até o máximo selecionado. Por exemplo, uma gen1 coleção reúne todos os objetos das gerações 0 e 1. Uma gen2 coleção reúne todos os objetos das gerações 0, 1 e 2. Para obter mais informações sobre o .NET GC e a coleta de lixo geracional, consulte o guia de coleta de lixo do .NET.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.gc.heap.total_allocated

Essa métrica relata os mesmos valores que chamar GC.GetTotalAllocatedBytes. Para obter mais informações sobre o .NET GC, consulte o guia de coleta de lixo do .NET.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.gc.last_collection.memory.committed_size

Essa métrica relata os mesmos valores que chamar GCMemoryInfo.TotalCommittedBytes. A memória virtual confirmada pode ser maior do que o tamanho da pilha porque inclui memória para armazenar objetos existentes (o tamanho da pilha) e alguma memória extra pronta para lidar com objetos recém-alocados no futuro. Para obter mais informações sobre o .NET GC, consulte o guia de coleta de lixo do .NET.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.gc.last_collection.heap.size

O .NET GC divide a pilha em gerações. Além das gerações numeradas padrão, o GC também coloca alguns objetos em duas gerações especiais:

• Large object heap (LOH) armazena objetos .NET que são muito grandes em comparação com objetos típicos.
• O heap de objeto fixo (POH) armazena objetos alocados usando a GC.AllocateArray API quando o pinned parâmetro é true.

Ambas as gerações especiais são coletadas durante gen2 as coletas de GC. Para obter mais informações sobre o .NET GC, consulte o guia de coleta de lixo do .NET.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.gc.last_collection.heap.fragmentation.size

Essa métrica relata os mesmos valores que chamar GCGenerationInfo.FragmentationAfterBytes.

Quando os objetos .NET são alocados, inicialmente eles tendem a ser dispostos de forma contígua na memória. No entanto, se alguns desses objetos forem coletados posteriormente pelo GC, isso criará lacunas de memória não utilizadas entre os objetos vivos que permanecem. Essas lacunas representam a parte da pilha GC que não está sendo usada atualmente para armazenar objetos, muitas vezes chamada de "fragmentação". O GC pode reutilizar os bytes de fragmentação no futuro para novas alocações de objetos se o tamanho do objeto for pequeno o suficiente para caber em uma das lacunas. O GC também pode executar uma coleta de lixo de compactação especial que move os objetos vivos restantes próximos uns dos outros, desde que os objetos não tenham sido fixados no lugar.

Para obter mais informações sobre como o GC do .NET funciona, analisando o desempenho do GC e qual a fragmentação de função desempenhada, consulte Análise de desempenho de memória do .NET.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.gc.pause.time

Essa métrica relata os mesmos valores que chamar GC.GetTotalPauseDuration().

Cada vez que o .NET GC faz uma coleção, ele precisa pausar brevemente todos os threads que executam código gerenciado para determinar quais objetos ainda são referenciados. Essa métrica relata a soma de todos esses tempos de pausa desde o início do processo. Você pode usar essa métrica para determinar qual fração de tempo os threads gastam pausados para GC versus o tempo que eles são capazes de executar código gerenciado.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.jit.compiled_il.size

Essa métrica relata os mesmos valores que chamar JitInfo.GetCompiledILBytes.

Quando você cria um aplicativo .NET, o código gerenciado é inicialmente compilado de uma linguagem de alto nível como C#, VB ou F# em linguagem intermediária (IL). Em seguida, quando o programa é executado, o compilador .NET just-in-time (JIT) converte o IL em código de máquina.

Como a compilação JIT ocorre na primeira vez que um método é executado, a maior parte da compilação JIT tende a ocorrer durante a inicialização do aplicativo. Reduzir a quantidade de IL compilada pelo JIT pode melhorar o tempo de inicialização do aplicativo.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.jit.compiled_methods

Essa métrica relata os mesmos valores que chamar JitInfo.GetCompiledMethodCount.

Quando você cria um aplicativo .NET, o código gerenciado é inicialmente compilado de uma linguagem de alto nível como C#, VB ou F# em linguagem intermediária (IL). Em seguida, quando o programa é executado, o compilador .NET just-in-time (JIT) converte o IL em código de máquina.

Como a compilação JIT ocorre na primeira vez que um método é executado, a maior parte da compilação JIT tende a ocorrer durante a inicialização do aplicativo. Reduzir o número de métodos que precisam ser compilados JIT pode melhorar o tempo de inicialização do aplicativo.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.jit.compilation.time

Essa métrica relata os mesmos valores que chamar JitInfo.GetCompilationTime.

Quando você cria um aplicativo .NET, o código gerenciado é inicialmente compilado de uma linguagem de alto nível como C#, VB ou F# em linguagem intermediária (IL). Em seguida, quando o programa é executado, o compilador .NET just-in-time (JIT) converte o IL em código de máquina.

Como a compilação JIT ocorre na primeira vez que um método é executado, a maior parte da compilação JIT tende a ocorrer durante a inicialização do aplicativo. Reduzir o tempo gasto na compilação JIT pode melhorar o tempo de inicialização do aplicativo.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.thread_pool.thread.count

Essa métrica relata os mesmos valores que chamar ThreadPool.ThreadCount.

O .NET usa um pool de threads para agendar itens de trabalho em outros threads. Essa métrica fornece o número de threads de trabalho atualmente gerenciados por esse pool de threads.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.thread_pool.work_item.count

Essa métrica relata os mesmos valores que chamar ThreadPool.CompletedWorkItemCount.

O .NET usa um pool de threads para agendar itens de trabalho em outros threads. Essa métrica fornece o número de itens de trabalho que foram executados pelos threads do pool de threads.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.thread_pool.queue.length

Essa métrica relata os mesmos valores que chamar ThreadPool.PendingWorkItemCount.

O .NET usa um pool de threads para agendar itens de trabalho em outros threads. Essa métrica fornece o número de itens de trabalho que estão atualmente na fila para serem executados por um dos threads do pool de threads.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.monitor.lock_contentions

Essa métrica relata os mesmos valores que chamar Monitor.LockContentionCount.

O .NET oferece suporte ao uso de qualquer objeto gerenciado como um bloqueio, seja com APIs como Monitor.Enter ou com a instrução lock. Se um thread já mantém um bloqueio enquanto um segundo thread tenta adquiri-lo, isso é chamado de contenção de bloqueio.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.timer.count

Essa métrica relata os mesmos valores que chamar Timer.ActiveCount.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.assembly.count

Essa métrica relata os mesmos valores que chamar AppDomain.GetAssemblies() e, em seguida, verificar o comprimento da matriz retornada.

Disponível a partir de: .NET 9.0.

Métrica: dotnet.exceptions

Essa métrica relata os mesmos valores que a contagem de chamadas para o AppDomain.FirstChanceException evento.

Disponível a partir de: .NET 9.0.