Opções de configuração em tempo de execução para threading

Este artigo detalha as definições que pode usar para configurar a threading em .NET.

Usar todos os grupos de CPU no Windows

• Em máquinas que têm múltiplos grupos de CPU, esta definição configura se componentes como o pool de threads utilizam todos os grupos de CPU ou apenas o grupo principal de CPU do processo. A definição também afeta o que Environment.ProcessorCount devolve.
• Quando esta configuração está ativada, todos os grupos de CPU são usados e as threads também são distribuídas automaticamente entre os grupos de CPU por defeito.
• Esta definição está ativada por defeito no Windows 11 e versões posteriores, e desativada por defeito no Windows 10 e versões anteriores. Para que esta configuração tenha efeito quando ativada, o GC deve também estar configurado para usar todos os grupos de CPU; para mais informações, veja GC CPU groups.

Atribuir threads a grupos de CPU no Windows

• Em máquinas que têm múltiplos grupos de CPU e todos os grupos de CPU estão a ser usados, esta definição configura se os threads são automaticamente distribuídos entre os grupos de CPU.
• Quando esta definição está ativada, novos threads são atribuídos a um grupo de CPU de forma a tentar preencher totalmente um grupo de CPU já em uso antes de utilizar um novo grupo de CPU.
• Esta definição está ativada por predefinição.

Threads mínimos

• Especifica o número mínimo de threads para o pool de threads de trabalho.
• Corresponde ao ThreadPool.SetMinThreads método.

Examples

runtimeconfig.json ficheiro:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.ThreadPool.MinThreads": 4
      }
   }
}

runtimeconfig.template.json arquivo:

{
   "configProperties": {
      "System.Threading.ThreadPool.MinThreads": 4
   }
}

Ficheiro do projeto:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <ThreadPoolMinThreads>4</ThreadPoolMinThreads>
  </PropertyGroup>

</Project>

Threads máximos

• Especifica o número máximo de threads para o pool de threads de trabalho.
• Corresponde ao ThreadPool.SetMaxThreads método.

Examples

runtimeconfig.json ficheiro:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.ThreadPool.MaxThreads": 20
      }
   }
}

runtimeconfig.template.json arquivo:

{
   "configProperties": {
      "System.Threading.ThreadPool.MaxThreads": 20
   }
}

Ficheiro do projeto:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <ThreadPoolMaxThreads>20</ThreadPoolMaxThreads>
  </PropertyGroup>

</Project>

Pool de threads do Windows

• Para projetos no Windows, configura se a gestão do pool de threads é delegada ao pool de threads do Windows.
• Se omitires esta definição ou se a plataforma não for o Windows, usa-se o pool de threads .NET em vez disso.
• Apenas as aplicações publicadas com AOT nativo no Windows usam o pool de threads do Windows por defeito, para o qual pode optar por usar o pool de threads .NET desativando a definição de configuração.
• O pool de threads do Windows pode ter um desempenho melhor em alguns casos, como em casos em que o número mínimo de threads está configurado para um valor elevado, ou quando o pool de threads do Windows já está a ser fortemente utilizado pela aplicação. Também podem existir casos em que o pool de threads .NET tem melhor desempenho, como em manuseamento pesado de I/O em máquinas maiores. É aconselhável verificar as métricas de desempenho ao alterar esta configuração de configuração.
• Algumas APIs não são suportadas ao utilizar o pool de threads do Windows, como ThreadPool.SetMinThreads, ThreadPool.SetMaxThreads, e ThreadPool.BindHandle(SafeHandle). As definições de configuração do pool de threads para threads mínimo e máximo também não são eficazes. Uma alternativa ThreadPool.BindHandle(SafeHandle) é a ThreadPoolBoundHandle aula.

Examples

runtimeconfig.json ficheiro:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.ThreadPool.UseWindowsThreadPool": true
      }
   }
}

runtimeconfig.template.json arquivo:

{
   "configProperties": {
      "System.Threading.ThreadPool.UseWindowsThreadPool": true
   }
}

Ficheiro do projeto:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <UseWindowsThreadPool>true</UseWindowsThreadPool>
  </PropertyGroup>

</Project>

Injeção de threads em resposta a blocar itens de trabalho

Em alguns casos, o pool de threads deteta itens de trabalho que bloqueiam os seus threads. Para compensar, injeta mais roscas. No .NET 6+, pode usar as seguintes definições de configuração em tempo de execução para configurar a injeção de threads em resposta a itens de trabalho bloqueadores. Atualmente, estas definições só têm efeito para itens de trabalho que aguardam que outra tarefa seja concluída, como nos casos típicos de sincronização sobre assíncrono .

Como as definições de configuração entram em vigor

• Depois de atingida a contagem de threads baseada em MinThreads , podem ser criados até ThreadsToAddWithoutDelay threads adicionais sem demora.
• Depois disso, antes de cada thread adicional ser criado, é induzido um atraso, começando por DelayStepMs.
• Por cada ThreadsPerDelayStep thread que é adicionado com um atraso, é adicionado um DelayStepMs adicional ao atraso.
• O atraso não pode exceder MaxDelayMs.
• Os atrasos só são induzidos antes de criar threads. Se os threads já estiverem disponíveis, serão lançados sem demora para compensar o bloqueio dos itens de trabalho.
• Também são usados o uso físico da memória e os limites e, para além de um determinado limite, o sistema passa para uma injeção de thread mais lenta.

Examples

runtimeconfig.json ficheiro:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.ThreadPool.Blocking.ThreadsToAddWithoutDelay_ProcCountFactor": 5
      }
   }
}

runtimeconfig.template.json arquivo:

{
   "configProperties": {
      "System.Threading.ThreadPool.Blocking.ThreadsToAddWithoutDelay_ProcCountFactor": 5
   }
}

AutoreleasePool para threads geridos

Esta opção configura se cada thread gerido recebe um NSAutoreleasePool implícito ao correr numa plataforma macOS suportada.

Examples

runtimeconfig.json ficheiro:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.Thread.EnableAutoreleasePool": true
      }
   }
}

runtimeconfig.template.json arquivo:

{
   "configProperties": {
      "System.Threading.Thread.EnableAutoreleasePool": true
   }
}

Ficheiro do projeto:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <AutoreleasePoolSupport>true</AutoreleasePoolSupport>
  </PropertyGroup>

</Project>